Documentación de Oracle Cloud Infrastructure

Creación de una suscripción de una función

Cree una suscripción de función en Notifications.

Utilice una suscripción de función para llamar y ejecutar una función cuando se produzca una condición de disparador.

Cuando se produce la condición de activación configurada, una alarma, una suscripción a anuncios, una regla de evento, un conector o una notificación contextual (regla de alarma o evento) envía (publica) un mensaje al tema configurado, y el servicio de notificaciones envía ese mensaje a las suscripciones activas del tema. Al recibir el mensaje, se llama y ejecuta la función. Para ver un ejemplo de escenario, consulte Escenario A: Cambio de tamaño automático de las VM.

El servicio de notificaciones no tiene información sobre una función una vez llamada. Para obtener detalles, consulte la información de solución de problemas en Función no llamada o no ejecutada.

Antes de empezar

Debe tener el permiso FN_INVOCATION en la función para poder agregar la función como suscripción a un tema. Consulte Adición de una suscripción de función en Protección de notificaciones.

  • En estos pasos se muestra cómo abrir el panel Crear suscripción desde la página de detalles del tema al que desea agregar la suscripción. También puede abrir este panel desde la página de lista Suscripciones, especificando el tema en el panel: seleccione Crear suscripción y, a continuación, seleccione un Tema de suscripción.
    1. En la página de lista Temas, seleccione el tema con el que desea trabajar. Si necesita ayuda para buscar la página de lista o el tema, consulte Lista de temas.
    2. En la página de detalles del tema, seleccione Crear suscripción.
    3. En el panel Crear suscripción, en Protocolo, seleccione Función.
    4. Seleccione el compartimento y la aplicación que contienen la función que desea y, a continuación, seleccione la función.
    5. Haga clic en Crear.

    Notifications crea la suscripción de la función. La confirmación no es necesaria para las suscripciones de función.

  • Utilice el comando oci ons subscription create y los parámetros necesarios para crear una suscripción de función:

    oci ons subscription create --protocol "ORACLE_FUNCTIONS" --subscription-endpoint <function_OCID> [...]

    Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de la línea de comandos para notificaciones.

  • Ejecute la operación CreateSubscription para crear una suscripción de función.

    Por ejemplo:

    POST /20181201/subscriptions
Host: notification.us-phoenix-1.oraclecloud.com
<authorization and other headers>
{
  "topicId": "<topic_OCID>",
  "compartmentId": "<compartment_OCID>",
  "protocol": "ORACLE_FUNCTIONS",
  "endpoint": "<function_OCID>"
}

Siguiente paso

Aunque una nueva suscripción debe estar en el mismo compartimento que su tema principal, puede moverla a otro compartimento después de la creación. Consulte Movimiento de una suscripción.