Introduction aux événements

Vous pouvez utiliser des utilisateurs, des groupes et des compartiments existants ou en créer de nouveaux.

Afin que les utilisateurs puissent utiliser des événements pour créer une automatisation, vous devez créer une politique GIA en tant qu'administrateur de location: 

Si aucun sujet d'avis approprié n'existe, vous devez vous connecter à la console en tant qu'administrateur de location et en créer un. Que le sujet soit nouveau ou existant, ajoutez une adresse de courriel à titre dans l'abonnement afin que vous puissiez surveiller ce compte de courriel pour les avis.

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

   Les événements comparent les règles que vous créez dans ce compartiment pour les messages d'événement émis à partir des ressources du compartiment et des compartiments enfants.

3. Entrez les données suivantes.
   • Nom d'affichage : Spécifiez un nom convivial pour la règle. Vous pouvez modifier cette valeur plus tard. Évitez d'entrer des informations confidentielles.
   • Description : Entrez une description de la règle. Vous pouvez modifier cette valeur plus tard.
4. Dans Condition, sélectionnez Type d'événement.
   1. Dans Nom du service, sélectionnez Stockage d'objets.
   2. Dans Type d'événement, sélectionnez Seau - Créer.
5. Dans Actions, spécifiez les actions à déclencher au moment où le filtre trouve une correspondance : 
   1. Dans le champ Type d'action, sélectionnez Avis.
   2. Dans le service d'avis, sélectionnez le compartiment qui contient 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 Stockage d'objets et stockage d'archives, sélectionnez Seaux.
2. Sélectionnez le compartiment dans lequel vous avez créé la règle (ou un de ses compartiments subordonnés).
3. Sélectionnez Créer un seau.
4. Dans la boîte de dialogue Créer un seau, spécifiez les attributs du seau :
   • Nom : Obligatoire. Nom convivial ou description. Évitez d'entrer des informations confidentielles.

   • Niveau de stockage : Sélectionnez le niveau dans lequel stocker les données. Les niveaux disponibles sont les suivants :

     • Standard : Niveau principal par défaut de stockage d'objets utilisé pour le stockage des données fréquemment consultées qui nécessitent un accès rapide et immédiat.
     • Archive : Niveau spécial pour le stockage de données rarement consultées qui nécessitent une conservation à long terme. L'accès aux données du niveau Archive n'est pas immédiat. Vous devez restaurer les données archivées avant d'y accéder. Pour plus d'informations, voir Aperçu du service de stockage d'archives.
   • Sélectionnez tout autre paramètre spécial disponible pour le seau.
5. Sélectionnez Créer.

• Connectez-vous au compte de courriel indiqué dans la procédure précédente afin de recevoir l'avis sur le seau en cours de création.

  
  Conseil
  
  Vous recevrez des avis chaque fois qu'un seau est créé dans le compartiment (ou un de ses sous-compartiments), jusqu'à ce que la règle soit désactivée.

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 ou des sujets en tant qu'action.

   Exemple de modèle de fichier d'action

   {
     "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. Remplissez <topic_OCID> avec la valeur d'identificateur Oracle Cloud du sujet à partir de votre location.
3. Ajoutez une description.
4. Enregistrez le fichier en utilisant 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 correspond à une chaîne au format JSON utilisée pour préciser un modèle pour la mise en correspondance d'événements (voir l'exemple de commande ci-dessous).

• compartment-id indique le compartiment dans lequel la règle s'applique. Les événements évaluent les messages des ressources dans ce compartiment et tous les compartiments enfants.
• actions indique l'emplacement dans le système de fichiers local du fichier formaté JSON que vous avez créé afin de spécifier les actions d'une règle.
• wait-for-state=, si utilisé avec ACTIVE, indique que l'interface de ligne de commande doit attendre que le service crée la règle, effectue une autre opération GET, puis affiche la règle avec l'état actif. Sans cette option, l'interface de ligne de commande affiche la règle immédiatement dans 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 qui précède, l'interface de ligne de commande vous présente un message à propos de la règle et de 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 seau comme indiqué dans la section précédente.

Connectez-vous au compte de courriel indiqué dans la procédure précédente afin de recevoir l'avis sur le seau en cours de création.