View a markdown version of this page

Creazione e gestione di funzioni - AWS Elemental MediaTailor
Configurazione di una funzioneGestione di funzioniRimozione di una funzioneRegole di convalidaGuida di riferimento alle API

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creazione e gestione di funzioni

Questa pagina illustra come creare, allegare, aggiornare ed eliminare le funzioni utilizzando la console. MediaTailor Le funzioni consentono di personalizzare il comportamento della sessione e le richieste di annunci eseguendo la logica nei punti chiave durante la riproduzione.

Configurazione di una funzione

Creazione di una funzione utilizzando la console

  1. Apri la MediaTailor console all'indirizzo https://console.aws.amazon.com/mediatailor/.

  2. Nel riquadro di navigazione, seleziona Funzioni.

  3. Scegli Crea funzione.

  4. Per Function ID, immettete un nome univoco per la funzione (ad esempio,fetchIdentity).

  5. Per Tipo di funzione, scegliete CUSTOM_OUTPUTHTTP_REQUEST, oSEQUENTIAL_EXECUTOR. La console visualizza i campi di configurazione per il tipo selezionato.

  6. Compila i campi di configurazione specifici del tipo. Per una descrizione di ogni tipo di funzione e dei relativi campi, vedere. Tipi e composizione delle funzioni

  7. Scegli Crea funzione.

Collegamento di una funzione a una configurazione di riproduzione

Una funzione non viene eseguita finché non viene collegata a una configurazione di riproduzione tramite una mappatura delle funzioni (un collegamento tra un lifecycle hook e una funzione). La mappatura delle funzioni specifica quale hook del ciclo di vita attiva la funzione.

  1. MediaTailor Apri la console.

  2. Nel riquadro di navigazione, scegli Configurazioni.

  3. Scegli la configurazione di riproduzione che desideri aggiornare.

  4. Nella sezione Mappatura delle funzioni, scegli Modifica.

  5. Per ogni gancio del ciclo di vita, seleziona la funzione da allegare:

    • Hook di inizializzazione della sessione: scegli una funzione da eseguire una sola volta all'inizio della sessione.

    • Hook per la richiesta di annuncio: scegli una funzione da eseguire prima di ogni richiesta ADS.

  6. Scegli Save (Salva).

Gestione di funzioni

Funzioni di visualizzazione

Vai a Funzioni per vedere tutte le funzioni del tuo account. Scegli il nome di una funzione per visualizzarne la configurazione.

Aggiornamento di una funzione esistente

Per aggiornare una funzione, accedete a Funzioni, scegliete la funzione e modificate la configurazione. L'aggiornamento sostituisce l'intera definizione della funzione.

Suggerimento

Salva una copia della configurazione della funzione prima di apportare modifiche. Non è previsto il controllo delle versioni o il rollback delle funzioni.

Rimozione di una funzione

Scollegare una funzione da una configurazione di riproduzione

Prima di eliminare una funzione, rimuovila da tutte le configurazioni di riproduzione che vi fanno riferimento.

  1. Apri la console. MediaTailor

  2. Nel riquadro di navigazione, scegli Configurazioni.

  3. Scegli la configurazione di riproduzione.

  4. Nella sezione Mappatura delle funzioni, scegli Modifica.

  5. Rimuovi la funzione dall'hook del ciclo di vita.

  6. Scegli Save (Salva).

Eliminazione di una funzione

Accedete a Funzioni, selezionate la funzione e scegliete Elimina.

Regole di blocco delle cancellazioni

MediaTailor impedisce di eliminare una funzione ancora in uso.

Condizione Risultato
La funzione è collegata a una configurazione di riproduzione tramite la mappatura delle funzioni L'eliminazione è bloccata. Scollegare prima la funzione.
La funzione è referenziata in un SEQUENTIAL_EXECUTOR L'eliminazione è bloccata. Rimuovete prima il riferimento dalla funzione principale.
La funzione non è referenziata da nessuna parte L'eliminazione ha esito positivo.

Regole di convalida

MediaTailor convalida la funzione quando la crei o la aggiorni. Vengono eseguiti i seguenti controlli:

  • Sintassi delle espressioni: tutte le espressioni devono essere in formato JSONATA valido.

  • Funzioni limitate: le espressioni non possono chiamare funzioni JSonata limitate. Vedi Riferimento all'espressione JSonata l'elenco completo.

  • Prefissi delle chiavi di output: tutte le chiavi di output devono iniziare con un prefisso dello spazio dei nomi riconosciuto. Per l'elenco dei prefissi accettati, vedere. Hook del ciclo di vita

  • Riferimenti alle funzioni: tutti gli ID di funzione in un FunctionList devono fare riferimento alle funzioni esistenti.

  • Riferimenti circolari: una funzione non può fare riferimento a se stessa, direttamente o indirettamente.

  • Profondità di nidificazione: A SEQUENTIAL_EXECUTOR può richiamare altre funzioni, ma tali funzioni non possono essere SEQUENTIAL_EXECUTOR esse stesse s.

Per valori e limiti di dimensione specifici, vedereLimits.

Guida di riferimento alle API

Per gestire le funzioni a livello di codice, consulta l'AWS Elemental MediaTailor API Reference.