Documentation Oracle Cloud Infrastructure

Création d'un abonnement via une fonction

Créez un abonnement via une fonction dans Notifications.

Utilisez un abonnement de fonction pour appeler et exécuter une fonction lorsqu'une condition de déclenchement se produit.

Lorsque la condition de déclenchement configurée se produit, une alarme, un abonnement d'annonce, une règle d'événement, un connecteur ou une notification contextuelle (alarme ou règle d'événement) envoie (publie) un message au sujet configuré, et Notifications transmet ce message aux abonnements actifs du sujet. A réception du message, la fonction est appelée et exécutée. Pour consulter un exemple de scénario, reportez-vous à Scénario A : redimensionnement automatique des machines virtuelles.

Le service Notifications ne dispose d'aucune information sur une fonction après que celle-ci a été appelée. Pour plus de détails, reportez-vous aux informations de dépannage dans Fonction non appelée ou non exécutée.

Avant de commencer

Vous devez disposer du droit d'accès FN_INVOCATION sur la fonction afin de pouvoir l'ajouter en tant qu'abonnement à un sujet. Reportez-vous à Ajout d'un abonnement à une fonction dans Sécurisation des notifications.

  • Ces étapes indiquent comment ouvrir le panneau Créer un abonnement à partir de la page de détails de la rubrique à laquelle ajouter l'abonnement. Vous pouvez également ouvrir ce panneau à partir de la page de liste Abonnements, en indiquant le sujet dans le panneau : sélectionnez Créer un abonnement, puis sélectionnez un sujet d'abonnement.
    1. Sur la page de liste Sujets, sélectionnez le sujet à utiliser. Si vous avez besoin d'aide pour rechercher la page de liste ou le sujet, reportez-vous à la rubrique Liste des sujets.
    2. Sur la page de détails de la rubrique, sélectionnez Créer un abonnement.
    3. Dans le panneau Créer un abonnement, pour Protocole, sélectionnez Fonction.
    4. Sélectionnez le compartiment et l'application qui contiennent la fonction voulue, puis sélectionnez la fonction.
    5. Sélectionnez Créer.

    Notifications crée l'abonnement à la fonction. La confirmation n'est pas requise pour les abonnements de fonction.

  • Utilisez la commande oci ons subscription create et les paramètres requis pour créer un abonnement de fonction :

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

    Afin d'obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande pour Notifications.

  • Exécutez l'opération CreateSubscription pour créer un abonnement de fonction.

    Exemple :

    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>"
}