View a markdown version of this page

Criação e gerenciamento de funções - AWS Elemental MediaTailor
Configurando uma funçãoGerenciar funçõesRemovendo uma funçãoRegras de validaçãoReferência de API

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criação e gerenciamento de funções

Esta página explica como criar, anexar, atualizar e excluir funções usando o MediaTailor console. As funções permitem que você personalize o comportamento da sessão e as solicitações de anúncios executando a lógica em pontos-chave durante a reprodução.

Configurando uma função

Criando uma função usando o console

  1. Abra o MediaTailor console em https://console.aws.amazon.com/mediatailor/.

  2. Selecione Funções no painel de navegação.

  3. Escolha a opção Criar função.

  4. Em ID da função, insira um nome exclusivo para a função (por exemplo,fetchIdentity).

  5. Em Tipo de funçãoCUSTOM_OUTPUT, escolhaHTTP_REQUEST, ouSEQUENTIAL_EXECUTOR. O console exibe os campos de configuração do tipo selecionado.

  6. Preencha os campos de configuração específicos do tipo. Para obter uma descrição de cada tipo de função e seus campos, consulteTipos de funções e composição.

  7. Escolha a opção Criar função.

Anexando uma função a uma configuração de reprodução

Uma função não é executada até que você a anexe a uma configuração de reprodução por meio de um mapeamento de função (um link entre um gancho de ciclo de vida e uma função). O mapeamento da função especifica qual gancho do ciclo de vida aciona a função.

  1. Abra o MediaTailor console.

  2. No painel de navegação, escolha Configurações.

  3. Escolha a configuração de reprodução que você deseja atualizar.

  4. Na seção Mapeamento de funções, escolha Editar.

  5. Para cada gancho de ciclo de vida, selecione a função a ser conectada:

    • Gancho de inicialização da sessão — Escolha uma função para executar uma vez no início da sessão.

    • Gancho de solicitação de anúncio — Escolha uma função a ser executada antes de cada solicitação do ADS.

  6. Escolha Salvar.

Gerenciar funções

Funções de visualização

Navegue até Funções para ver todas as funções em sua conta. Escolha um nome de função para ver sua configuração.

Atualizando uma função existente

Para atualizar uma função, navegue até Funções, escolha a função e modifique a configuração. A atualização substitui toda a definição da função.

dica

Salve uma cópia da configuração da função antes de fazer alterações. Não há controle de versão ou reversão embutido para funções.

Removendo uma função

Separando uma função de uma configuração de reprodução

Antes de excluir uma função, remova-a de todas as configurações de reprodução que fazem referência a ela.

  1. Abra o MediaTailor console.

  2. No painel de navegação, escolha Configurações.

  3. Escolha a configuração de reprodução.

  4. Na seção Mapeamento de funções, escolha Editar.

  5. Remova a função do gancho do ciclo de vida.

  6. Escolha Salvar.

Como excluir uma função

Navegue até Funções, selecione a função e escolha Excluir.

Regras de bloqueio de exclusões

MediaTailor impede que você exclua uma função que ainda está em uso.

Condição Resultado
A função é anexada a uma configuração de reprodução por meio de mapeamento de funções A exclusão está bloqueada. Desconecte a função primeiro.
A função é referenciada em um SEQUENTIAL_EXECUTOR A exclusão está bloqueada. Remova primeiro a referência da função principal.
A função não é referenciada em nenhum lugar A exclusão foi bem-sucedida.

Regras de validação

MediaTailor valida sua função ao criá-la ou atualizá-la. As seguintes verificações são realizadas:

  • Sintaxe da expressão — Todas as expressões devem ser JSONATA válidas.

  • Funções restritas — As expressões não podem chamar funções restritas do JSonata. Veja Referência de expressão JSonata a lista completa.

  • Prefixos de chave de saída — Todas as chaves de saída devem começar com um prefixo de namespace reconhecido. Para obter a lista de prefixos aceitos, consulteHooks do ciclo de vida.

  • Referências de função — Todos os IDs de função em uma FunctionList devem fazer referência a funções existentes.

  • Referências circulares — Uma função não pode referenciar a si mesma, direta ou indiretamente.

  • Profundidade de aninhamento — A SEQUENTIAL_EXECUTOR pode chamar outras funções, mas essas funções não podem ser em si mesmasSEQUENTIAL_EXECUTOR.

Para valores específicos e limites de tamanho, consulteLimites.

Referência de API

Para gerenciar funções de forma programática, consulte a Referência da AWS Elemental MediaTailor API.