Documentation sur Oracle Cloud Infrastructure

Création d'un abonnement de fonction

Créez un abonnement à une fonction dans le service d'avis.

Utilisez un abonnement à une 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 aux annonces, une règle d'événement, un connecteur ou un avis contextuel (règle d'alarme ou d'événement) envoie (publie) un message au sujet configuré, et le service d'avis transmet ce message aux abonnements actifs dans le sujet. À la réception du message, la fonction est appelée et exécutée. Pour un exemple de scénario, voir Scénario A : Redimensionnement automatique des machines virtuelles.

Le service d'avis n'a aucune information sur une fonction une fois celle-ci appelée. Pour plus de détails, consultez les informations sur le dépannage sous Fonction non appelée ou non exécutée.

Avant de commencer

Vous devez avoir l'autorisation FN_INVOCATION pour pouvoir ajouter la fonction en tant qu'abonnement à un sujet. Voir Ajouter un abonnement à une fonction dans Sécurisation des avis.

  • Ces étapes montrent comment ouvrir le panneau Créer un abonnement à partir de la page de détails du sujet auquel vous voulez ajouter l'abonnement. Vous pouvez également ouvrir ce panneau à partir de la page de liste Abonnements, en spécifiant le sujet dans le panneau : Sélectionnez Créer un abonnement, puis sélectionnez un sujet d'abonnement.
    1. Dans la page de liste Sujets, sélectionnez le sujet avec lequel vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou le sujet, voir Liste des sujets.
    2. Dans la page des détails du sujet, 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.

    Le service d'avis crée l'abonnement à la fonction. Aucune confirmation n'est 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> [...]

    Pour la liste complète des paramètres et valeurs des commandes de l'interface de ligne de commande, voir Référence de ligne de commande pour les avis.

  • Exécutez l'opération CreateSubscription pour créer un abonnement à une 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>"
}