Skip to main content
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Configurar notificações de eventos

Colaboradores
PDFs

O serviço de notificações é um dos três serviços da plataforma StorageGRID. Você pode habilitar notificações de um bucket para enviar informações sobre eventos especificados para um serviço de destino compatível com o AWS Simple Notification Service (SNS).

Antes de começar

  • Os serviços de plataforma foram ativados para sua conta de locatário por um administrador do StorageGRID.

  • Você já criou um bucket para agir como a fonte das notificações.

  • O endpoint que você pretende usar como destino para notificações de eventos já existe, e você tem sua URNA.

  • Você pertence a um grupo de usuários que tem o "Gerencie todos os buckets ou permissão de acesso root". Essas permissões substituem as configurações de permissão nas políticas de grupo ou bucket ao configurar o bucket usando o Gerenciador do locatário.

Sobre esta tarefa

Depois de configurar as notificações de eventos, sempre que um evento especificado ocorre para um objeto no intervalo de origem, uma notificação é gerada e enviada para o tópico Serviço de notificação simples (SNS) usado como ponto de extremidade de destino. Para ativar notificações para um bucket, você deve criar e aplicar XML de configuração de notificação válida. O XML de configuração de notificação deve usar a URNA de um endpoint de notificações de eventos para cada destino.

Para obter informações gerais sobre notificações de eventos e como configurá-las, consulte a documentação da Amazon. Para obter informações sobre como o StorageGRID implementa a API de configuração de notificação de bucket do S3, consulte as instruções para implementar aplicativos cliente do S3.

Se você ativar notificações de eventos para um bucket que contém objetos, as notificações serão enviadas apenas para ações executadas após a configuração de notificação ser salva.

Passos

  1. Ativar notificações para o intervalo de origem:

    • Use um editor de texto para criar a configuração de notificação XML necessário para habilitar notificações de eventos, conforme especificado na API de notificação S3.

    • Ao configurar o XML, use a URNA de um endpoint de notificações de eventos como o tópico de destino.

    <NotificationConfiguration>
  <TopicConfiguration>
     <Id>Image-created</Id>
     <Filter>
        <S3Key>
          <FilterRule>
            <Name>prefix</Name>
            <Value>images/</Value>
          </FilterRule>
        </S3Key>
    </Filter>
    <Topic>arn:aws:sns:us-east-1:050340950352:sgws-topic</Topic>
    <Event>s3:ObjectCreated:*</Event>
   </TopicConfiguration>
 </NotificationConfiguration>

  2. No Gerenciador do Locatário, selecione STORAGE (S3) > Buckets.

  3. Selecione o nome do intervalo de origem.

    É apresentada a página de detalhes do balde.

  4. Selecione Serviços de plataforma > notificações de eventos.

  5. Marque a caixa de seleção Ativar notificações de eventos.

  6. Cole o XML de configuração de notificação na caixa de texto e selecione Salvar alterações.

    captura de tela da caixa de diálogo de configuração de notificação de evento
    Observação Os serviços de plataforma devem estar habilitados para cada conta de locatário por um administrador do StorageGRID usando o Gerenciador de Grade ou a API de Gerenciamento de Grade. Contacte o administrador do StorageGRID se ocorrer um erro ao guardar o XML de configuração.

  7. Verifique se as notificações de eventos estão configuradas corretamente:

    1. Execute uma ação em um objeto no bucket de origem que atenda aos requisitos para acionar uma notificação conforme configurado no XML de configuração.

      No exemplo, uma notificação de evento é enviada sempre que um objeto é criado com o images/ prefixo.

    2. Confirme se uma notificação foi entregue ao tópico SNS de destino.

      Por exemplo, se o tópico de destino estiver hospedado no AWS Simple Notification Service (SNS), você poderá configurar o serviço para enviar um e-mail quando a notificação for entregue.

      {
   "Records":[
      {
         "eventVersion":"2.0",
         "eventSource":"sgws:s3",
         "eventTime":"2017-08-08T23:52:38Z",
         "eventName":"ObjectCreated:Put",
         "userIdentity":{
            "principalId":"1111111111111111111"
         },
         "requestParameters":{
            "sourceIPAddress":"193.51.100.20"
         },
         "responseElements":{
            "x-amz-request-id":"122047343"
         },
         "s3":{
            "s3SchemaVersion":"1.0",
            "configurationId":"Image-created",
            "bucket":{
               "name":"test1",
               "ownerIdentity":{
                  "principalId":"1111111111111111111"
               },
               "arn":"arn:sgws:s3:::test1"
            },
            "object":{
               "key":"images/cat.jpg",
               "size":0,
               "eTag":"d41d8cd98f00b204e9800998ecf8427e",
               "sequencer":"14D90402421461C7"
            }
         }
      }
   ]
}

    Se a notificação for recebida no tópico de destino, você configurou com êxito o bucket de origem para notificações do StorageGRID.

Informações relacionadas

"Entenda as notificações para buckets"

"USE A API REST DO S3"

"Criar endpoint de serviços de plataforma"