Introduzione agli eventi

È possibile utilizzare utenti, gruppi e compartimenti esistenti o crearne di nuovi.

Prima che gli utenti possano iniziare a utilizzare Eventi per creare l'automazione, in qualità di amministratore della tenancy è necessario creare il criterio IAM: 

Se un argomento di notifiche appropriato non esiste già, è necessario eseguire il login alla console come amministratore della tenancy e crearlo. Se utilizzi un argomento esistente o ne crei uno nuovo, aggiungi un indirizzo e-mail come sottoscrizione in modo da poter monitorare l'account e-mail per le notifiche.

1. Aprire il menu di navigazione e selezionare Osservabilità e gestione. In Servizio eventi, selezionare Regole.
2. Scegliere un compartimento in cui si dispone dell'autorizzazione per lavorare, quindi fare clic su Crea regola.

   Gli eventi confrontano le regole create in questo compartimento con i messaggi degli eventi emessi dalle risorse in questo compartimento e in qualsiasi compartimento figlio.

3. Immettere:
   • Nome visualizzato: specificare un nome descrittivo per la regola. In seguito potrà essere modificato. Evitare di inserire informazioni riservate.
   • Descrizione: specificare una descrizione del funzionamento della regola. In seguito sarà possibile modificare questa descrizione.
4. In Condizione selezionare Tipo di evento.
   1. In Nome servizio selezionare Storage degli oggetti.
   2. In Tipo di evento, selezionare Bucket - Crea.
5. In Azioni specificare le azioni da attivare quando il filtro trova una corrispondenza: 
   1. In Tipo di azione, selezionare Notifiche.
   2. In Compartimento notifiche selezionare il compartimento che contiene l'argomento.
   3. In Argomento, selezionare l'argomento.
6. Fare clic su Crea regola.

• Eseguire il login all'account di posta elettronica specificato nella procedura precedente per ricevere la notifica relativa al bucket in fase di creazione.

  
  Suggerimento
  
  Si riceveranno notifiche ogni volta che un bucket viene creato nel compartimento (o in uno qualsiasi dei relativi compartimenti secondari) fino a quando non si disabilita la regola.

1. Creare un file e aggiungere il contenuto seguente.

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

   Suggerimento: è possibile specificare funzioni, flussi o argomenti come azione.

   Modello di file di azione di esempio

   {
     "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. Compilare <topic_OCID> con il valore OCID dell'argomento effettivo della tenancy.
3. Aggiungi descrizione.
4. Salvare il file con action.json come nome file.

Aprire un prompt dei comandi ed eseguire oci events rule create per creare una regola.

Usa le seguenti opzioni:

• display-name indica il nome della regola nella console
• is-enabled indica se la regola viene valutata.

• condition una stringa in formato JSON utilizzata per indicare un pattern per la corrispondenza degli eventi (per informazioni sull'uso, vedere il comando di esempio riportato di seguito).

• compartment-id indica il compartimento in cui si applica la regola. Gli eventi valutano i messaggi delle risorse in questo compartimento e in qualsiasi compartimento figlio.
• actions indica la posizione nel file system locale del file in formato JSON creato per specificare le azioni per una regola.
• wait-for-state= se utilizzato con ACTIVE indica che l'interfaccia CLI deve attendere la creazione della regola da parte del servizio, eseguire un'altra operazione GET e quindi visualizzare la regola in stato attivo. Senza questa opzione, l'interfaccia CLI visualizza immediatamente la regola nello stato di creazione.

Ad esempio: 

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

Quando si esegue il comando precedente, l'interfaccia CLI richiede di specificare la regola e la relativa visualizzazione: 

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

• Eseguire il login all'account di posta elettronica specificato nella procedura precedente per ricevere la notifica relativa al bucket in fase di creazione.

  Suggerimento
  
  Si ricevono notifiche ogni volta che un bucket viene creato nel compartimento (o in uno qualsiasi dei relativi compartimenti secondari) fino a quando non si disabilita la regola.