View a markdown version of this page

Creación y administración de funciones - AWS Elemental MediaTailor
Configurar una funciónAdministración de funciones deEliminar una funciónReglas de validaciónReferencia de la API

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Creación y administración de funciones

En esta página se explica cómo crear, adjuntar, actualizar y eliminar funciones mediante la MediaTailor consola. Las funciones te permiten personalizar el comportamiento de la sesión y las solicitudes de anuncios mediante la ejecución de la lógica en los puntos clave de la reproducción.

Configurar una función

Crear una función mediante la consola

  1. Abra la consola de MediaTailor.

  2. Seleccione Funciones en el panel de navegación.

  3. Seleccione Creación de función.

  4. En el ID de función, introduzca un nombre único para la función (por ejemplo,fetchIdentity).

  5. En Tipo de función CUSTOM_OUTPUT, elijaHTTP_REQUEST,VAST_REQUEST,SEQUENTIAL_EXECUTOR, oCONCURRENT_EXECUTOR. La consola muestra los campos de configuración del tipo seleccionado.

  6. Rellene los campos de configuración específicos del tipo. Para obtener una descripción de cada tipo de función y sus campos, consulte. Tipos de funciones y composición

  7. Seleccione Creación de función.

Adjuntar una función a una configuración de reproducción

Una función no se ejecuta hasta que se adjunta a una configuración de reproducción mediante un mapeo de funciones (un enlace entre un enlace de ciclo de vida y una función). La asignación de funciones especifica qué enlace de ciclo de vida activa la función.

  1. Abre la MediaTailor consola.

  2. En el panel de navegación, elija Configuraciones.

  3. Elija la configuración de reproducción que desea actualizar.

  4. En la sección Asignación de funciones, elija Editar.

  5. Para cada enlace de ciclo de vida, selecciona la función que deseas adjuntar:

    • Enlace de inicialización de sesión: elija una función para que se ejecute una vez al inicio de la sesión.

    • Enlace de solicitud de anuncios: elija una función para que se ejecute antes de cada solicitud de ADS.

    • Gancho de respuesta para publicar anuncios: elige una función para que se ejecute después de recibir y analizar cada respuesta de ADS.

    • Enlace de inserción previo al manifiesto: elige una función para que se ejecute en el conjunto de anuncios final justo antes de que los anuncios se inserten en el manifiesto.

  6. Seleccione Save.

Administración de funciones de

Funciones de visualización

Navega hasta Funciones para ver todas las funciones de tu cuenta. Elige el nombre de una función para ver su configuración.

Actualización de una función existente

Para actualizar una función, vaya a Funciones, elija la función y modifique la configuración. La actualización reemplaza toda la definición de la función.

sugerencia

Guarde una copia de la configuración de la función antes de realizar cambios. No hay ningún control de versiones ni una reversión integrados de las funciones.

Eliminar una función

Separar una función de una configuración de reproducción

Antes de eliminar una función, elimínela de todas las configuraciones de reproducción que hagan referencia a ella.

  1. Abre la MediaTailor consola.

  2. En el panel de navegación, elija Configuraciones.

  3. Elija la configuración de reproducción.

  4. En la sección Asignación de funciones, elija Editar.

  5. Elimine la función del enlace de ciclo de vida.

  6. Seleccione Save.

Eliminación de una función

Navegue hasta Funciones, seleccione la función y elija Eliminar.

Reglas de bloqueo de borrados

MediaTailor impide eliminar una función que todavía está en uso.

Condición Resultado
La función se adjunta a una configuración de reproducción mediante el mapeo de funciones La eliminación está bloqueada. Desactive primero la función.
Se hace referencia a la función en un SEQUENTIAL_EXECUTOR o CONCURRENT_EXECUTOR La eliminación está bloqueada. Elimine primero la referencia de la función principal.
No se hace referencia a la función en ninguna parte La eliminación se realiza correctamente.

Reglas de validación

MediaTailor valida la función al crearla o actualizarla. Se realizan las siguientes comprobaciones:

  • Sintaxis de expresiones: todas las expresiones deben ser JSonata válidas.

  • Funciones restringidas: las expresiones no pueden llamar a funciones JSonata restringidas. Consulte JSONatareferencia de expresión la lista completa.

  • Prefijos de clave de salida: todas las claves de salida deben empezar por un prefijo de espacio de nombres reconocido. Para ver la lista de prefijos aceptados, consulte. Enlaces de ciclo de vida

  • Referencias a funciones: todos los identificadores de funciones de una FunctionList deben hacer referencia a las funciones existentes.

  • Referencias circulares: una función no puede hacer referencia a sí misma, directa o indirectamente.

  • Profundidad de anidamiento: A SEQUENTIAL_EXECUTOR puede llamar a otras funciones, pero esas funciones no pueden ser ejecutoras en sí mismas.

Para conocer valores y límites de tamaño específicos, consulte. Límites

Referencia de la API

Para administrar las funciones mediante programación, consulte la referencia de la AWS Elemental MediaTailor API.