Introduction à Events

Vous pouvez reprendre des utilisateurs, groupes et compartiments existants ou en créer.

Pour que les utilisateurs puissent commencer à créer des automatisations sur Events, en tant qu'administrateur de location, vous devez créer une stratégie IAM :

Si un sujet Notifications approprié n'existe pas encore, vous devez vous connecter à la console en tant qu'administrateur de location et le créer. Que vous utilisiez un sujet existant ou que vous en créiez un, ajoutez une adresse électronique en tant qu'abonnement afin de pouvoir surveiller ce compte de messagerie pour les notifications.

1. Ouvrez le menu de navigation et sélectionnez Observation & gestion. Sous Service Events, sélectionnez Règles.
2. Sélectionnez un compartiment dans lequel vous êtes autorisé à travailler, puis sélectionnez Créer une règle.

   Events compare les règles que vous créez dans ce compartiment aux messages d'événement émis à partir des ressources de ce compartiment et de tous les compartiments enfant.

3. Fournissez les informations suivantes.
   • Nom d'affichage : indiquez un nom convivial pour la règle. Vous pouvez modifier ce nom ultérieurement. Evitez de saisir des informations confidentielles.
   • Description : indiquez la description du fonctionnement de la règle. Vous pouvez modifier cette description ultérieurement.
4. Dans Condition, sélectionnez Type d'événement.
   1. Dans Nom de service, sélectionnez Object Storage.
   2. Dans Type d'événement, sélectionnez Bucket - Créer.
5. Dans Actions, indiquez les actions à déclencher lorsque le filtre trouve une correspondance :
   1. Dans Type d'action, sélectionnez Notifications.
   2. Dans Compartiment de notifications, sélectionnez le compartiment contenant le sujet.
   3. Dans Sujet, sélectionnez le sujet.
6. Sélectionnez Créer une règle.

1. Ouvrez le menu de navigation et sélectionnez Stockage. Sous Object Storage et Archive Storage, sélectionnez Buckets.
2. Sélectionnez le compartiment dans lequel vous avez créé la règle (ou l'un de ses compartiments subordonnés).
3. Sélectionnez Créer un bucket.
4. Dans la boîte de dialogue Créer un bucket, indiquez les attributs du bucket :
   • Nom : requis. Description ou nom convivial. Evitez de saisir des informations confidentielles.

   • Niveau de stockage : sélectionnez le niveau auquel stocker les données. Les niveaux disponibles sont les suivants :

     • Standard : il s'agit du niveau Object Storage principal par défaut qui permet de stocker les données fréquemment consultées et qui exige un accès rapide et immédiat.
     • Archive : niveau spécial destiné au stockage de données rarement consultées et qui nécessitent de longues périodes de conservation. L'accès aux données du niveau Archive n'est pas immédiat. Vous devez restaurer les données archivées pour qu'elles soient accessibles. Pour plus d'informations, reportez-vous à Présentation d'Archive Storage.
   • Sélectionnez tout autre paramètre spécial disponible pour le bucket.
5. Choisissez Créer.

• Connectez-vous au compte de messagerie indiqué dans la procédure précédente pour consulter la notification sur le bucket en cours de création.

  
  Conseil
  
  Vous recevrez une notification chaque fois qu'un bucket est créé dans le compartiment (ou dans l'un de ses sous-compartiments) jusqu'à ce que vous désactiviez la règle.

1. Créez un fichier et ajoutez le contenu suivant.

   {
     "actions": [
         {
           "actionType": "ONS",
           "description": "string",
           "isEnabled": true,
           "topicId": "<topic_OCID>"
         }
     ]
   }

   Conseil : vous pouvez spécifier des fonctions, des flux de données ou des sujets en tant qu'actions.

   Exemple de modèle de fichier d'actions

   {
     "actions": [
         {
           "actionType": "FAAS",
           "description": "string",
           "functionId": "<function_OCID>",
           "isEnabled": true
         },
         {
           "actionType": "ONS",
           "description": "string",
           "isEnabled": true,
           "topicId": "<topic_OCID>"
         },
         {
           "actionType": "OSS",
           "description": "string",
           "isEnabled": true,
           "streamId": "<stream_OCID>"
         }
     ]
   }

2. Remplacez <topic_OCID> par une valeur d'OCID de sujet réelle issue de votre location.
3. Ajoutez une description.
4. Enregistrez le fichier sous action.json comme nom de fichier.

Ouvrez une invite de commande et exécutez oci events rule create pour créer une règle.

Utilisez les options suivantes :

• display-name indique le nom de la règle dans la console.
• is-enabled indique si la règle est évaluée.

• condition est une chaîne au format JSON utilisée pour indiquer un modèle de mise en correspondance des événements (reportez-vous à l'exemple de commande ci-dessous pour la syntaxe).

• compartment-id indique le compartiment auquel la règle s'applique. Events évalue les messages issus des ressources de ce compartiment et de tous les compartiments enfant.
• actions indique l'emplacement dans le système de fichiers local du fichier au format JSON que vous avez créé pour indiquer les actions d'une règle.
• L'option wait-for-state=, si elle est utilisée avec ACTIVE, indique que l'interface de ligne de commande doit attendre que le service crée la règle, effectuer une autre opération GET, puis afficher la règle à l'état actif. Sans cette option, l'interface de ligne de commande affiche la règle immédiatement à l'état de création.

Par exemple :

oci events rule create --display-name CLI-created_rule --is-enabled true --condition "{\"eventType\":[\"com.oraclecloud.objectstorage.createbucket\"]}" --compartment-id <compartment_OCID> --actions <path_to_json_formatted_actions_file> --wait-for-state=ACTIVE

Lorsque vous exécutez la commande précédente, l'interface de ligne de commande vous invite à configurer la règle et son affichage :

 Action completed. Waiting until the resource has entered state: ACTIVE
{
  "data": {
    "actions": {
      "actions": [
        {
          "action-type": "ONS",
          "description": "Notifications action",
          "id": "ocid1.eventaction.oc1.phx.<unique_ID>",
          "lifecycle-message": null,
          "lifecycle-state": "ACTIVE",
          "topic-id": "ocid1.onstopic.oc1.phx.<unique_ID>"
        }
      ]
    },
    "compartment-id": "ocid1.compartment.oc1..<unique_ID>",
    "condition": "{\"eventType\":[\"com.oraclecloud.objectstorage.createbucket\"]}",
    "defined-tags": {},
    "description": null,
    "display-name": "CLI-created_rule",
    "freeform-tags": {},
    "id": "ocid1.eventrule.oc1.phx.<unique_ID>",
    "is-enabled": true,
    "lifecycle-message": null,
    "lifecycle-state": "ACTIVE",
    "time-created": "2019-04-25T01:32:56.855000+00:00"
  },
  "etag": "<unique_ID>--gzip"
}

Créez un autre bucket comme indiqué dans une section précédente.

Connectez-vous au compte de messagerie indiqué dans la procédure précédente pour consulter la notification sur le bucket en cours de création.