Conceitos Básicos do Serviço Events

Você pode usar usuários, grupos e compartimentos existentes ou criar novos.

Para que os usuários possam começar a usar o serviço Events para criar automação, como administrador da tenancy, você deverá criar a política do serviço IAM: 

Se um tópico adequado do serviço Notifications ainda não existir, você deverá fazer log-in na Console como administrador da tenancy e criá-lo. Se você usar um tópico existente ou criar um novo, adicione um endereço de e-mail como uma inscrição para que possa monitorar essa conta de e-mail para notificações.

1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em Serviço Events, selecione Regras.
2. Escolha um Compartimento no qual você tenha permissão para trabalhar e clique em Criar Regra.

   O serviço Events compara as regras que você cria neste compartimento com mensagens de evento emitidas por recursos deste compartimento e de todos os compartimentos filhos.

3. Informe o seguinte.
   • Nome para Exibição: Especifique um nome amigável para a regra. Você pode alterar esse nome posteriormente. Evite inserir informações confidenciais.
   • Descrição: Especifique uma descrição do que a regra faz. Você pode alterar essa descrição posteriormente.
4. Em Condição, selecione Tipo de Evento.
   1. Em Nome do Serviço, selecione Object Storage.
   2. Em Tipo de Evento, selecione Bloco - Criar.
5. Em Ações, especifique as ações a serem acionadas quando o filtro localizar uma correspondência: 
   1. Em Tipo de Ação, selecione Notificações.
   2. Em Compartimento de Notificações, selecione o compartimento que contém o tópico.
   3. Em Tópico, selecione o tópico.
6. Clique em Criar Regra.

• Faça log-in na conta de e-mail especificada no procedimento anterior para receber a notificação sobre o bucket que está sendo criado.

  
  Dica
  
  Você receberá notificações sempre que um bucket for criado no compartimento (ou em qualquer um de seus subcompartimentos) até que você desative a regra.

1. Crie um arquivo e adicione o conteúdo a seguir.

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

   Dica: Você pode especificar funções, streams ou tópicos como uma ação.

   Exemplo de modelo de arquivo de ação

   {
     "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. Preencha <topic_OCID> com o valor do OCID do tópico real da sua tenancy.
3. Adicione uma descrição.
4. Salve o arquivo com action.json como o nome do arquivo.

Abra um prompt de comando e execute oci events rule create para criar uma regra.

Use as seguintes opções:

• display-name indica o nome da regra na Console
• is-enabled indica se a regra é avaliada.

• condition uma string no formato JSON usada para indicar um padrão para correspondência de eventos (consulte o exemplo de comando abaixo para saber o uso).

• compartment-id indica o compartimento em que a regra se aplica. O serviço Events avalia mensagens de recursos neste compartimento e em quaisquer compartimentos filhos.
• actions indica a localização no sistema de arquivos local do arquivo em formato JSON que você criou para especificar as ações para uma regra.
• wait-for-state= quando usado com ACTIVE indica que a CLI deve esperar o serviço criar a regra, executar outra operação GET e exibir a regra no estado ativo. Sem a opção, a CLI exibe a regra imediatamente no estado de criação.

Por exemplo: 

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 você executa o comando anterior, a CLI solicita informações sobre a regra e sua exibição:

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

• Faça log-in na conta de e-mail especificada no procedimento anterior para receber a notificação sobre o bucket que está sendo criado.

  Dica
  
  Você recebe notificações sempre que um bucket é criado no compartimento (ou em qualquer um de seus compartimentos) até que você desative a regra.