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

Esta página explica cómo crear, adjuntar, actualizar y eliminar funciones mediante la MediaTailor consola. Las funciones permiten personalizar el comportamiento de las sesiones y las solicitudes de anuncios mediante la aplicación de la lógica en puntos clave durante la reproducción.

Configurar una función

Crear una función mediante la consola

  1. Abra la MediaTailor consola en https://console.aws.amazon.com/mediatailor/.

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

  3. Seleccione Creación de función.

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

  5. En Tipo de funciónCUSTOM_OUTPUT, elijaHTTP_REQUEST, oSEQUENTIAL_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 y composición de funciones

  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 del ciclo de vida y una función). El mapeo de funciones especifica qué enlace del 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 desee actualizar.

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

  5. Para cada enlace del ciclo de vida, seleccione la función que desee adjuntar:

    • Gancho de inicialización de sesión: elija una función para ejecutarla una vez al inicio de la sesión.

    • Gancho de solicitud de anuncios: elija una función para ejecutarla antes de cada solicitud de ADS.

  6. Seleccione Save.

Administración de funciones de

Funciones de visualización

Ve a 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 un sistema integrado de control de versiones ni una reversión 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. Abra la MediaTailor consola.

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

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

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

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

  6. Seleccione Save.

Eliminación de una función

Vaya a Funciones, seleccione la función y elija Eliminar.

Reglas de eliminación y bloqueo

MediaTailor impide eliminar una función que aún 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. Desconecte primero la función.
Se hace referencia a la función en un SEQUENTIAL_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 expresión: todas las expresiones deben ser JSonata válidas.

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

  • Prefijos de las teclas 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 de funciones: todos los ID de función 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 anidación: A SEQUENTIAL_EXECUTOR puede llamar a otras funciones, pero esas funciones no pueden ser en sí mismas SEQUENTIAL_EXECUTOR s.

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

Referencia de la API

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