Skip to main content
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Configure las notificaciones de eventos

Colaboradores netapp-lhalbert netapp-pcarriga
PDF

Para habilitar las notificaciones de un depósito, cree XML de configuración de notificaciones y utilice el Gestor de inquilinos para aplicar el XML a un bloque.

Antes de empezar

  • Un administrador de StorageGRID activó los servicios de plataforma para su cuenta de inquilino.

  • Ya creó un bloque para que actúe como origen de notificaciones.

  • El punto final que pretende utilizar como destino para las notificaciones de eventos ya existe y tiene su URN.

  • Pertenece a un grupo de usuarios que tiene el "Gestione todos los bloques o permisos de acceso raíz". Estos permisos anulan la configuración de permisos de las directivas de grupo o de bloque al configurar el bloque mediante el Administrador de inquilinos.

Acerca de esta tarea

Puede configurar las notificaciones de eventos asociando el XML de configuración de notificaciones con un depósito de origen. El XML de configuración de notificaciones sigue las convenciones S3 para configurar notificaciones de bucket, con el tema de Amazon SNS de destino, el tema de Kafka o el punto final del webhook especificado como el URN de un punto final.

Para obtener información general sobre las notificaciones de eventos y cómo configurarlas, consulte la "Documentación de Amazon". Para obtener información sobre cómo StorageGRID implementa la API de configuración de notificación de buckets S3, consulte la "Instrucciones para implementar aplicaciones cliente de S3".

Tenga en cuenta los siguientes requisitos y características al configurar las notificaciones de eventos para un bloque:

  • Al crear y aplicar un XML de configuración de notificación válido, debe utilizar el URN de un punto final de notificaciones de eventos para cada destino.

  • Aunque la notificación de eventos se puede configurar en un depósito con bloqueo de objetos S3 activado, los metadatos de bloqueo de objetos S3 (incluidos el estado de retención legal y la fecha de retención hasta) de los objetos no se incluirán en los mensajes de notificación.

  • Después de configurar las notificaciones de eventos, cada vez que ocurre un evento específico para un objeto en el bucket de origen, se genera una notificación y se envía al tema de Amazon SNS, al tema de Kafka o al punto final del webhook utilizado como destino.

  • Si habilita las notificaciones de eventos para un bloque que contiene objetos, las notificaciones se envían solo para las acciones que se realizan una vez guardada la configuración de notificación.

Pasos

  1. Habilite las notificaciones para su bloque de origen:

    • Use un editor de texto para crear el XML de configuración de notificaciones necesario para habilitar las notificaciones de eventos, como se especifica en la API de notificación de S3.

    • Al configurar XML, utilice URN de un extremo de notificaciones de eventos como tema 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. En el Administrador de inquilinos, seleccione ALMACENAMIENTO (S3) > Cuchos.

  3. Seleccione el nombre del bloque de origen.

    Aparece la página de detalles bucket.

  4. Seleccione Servicios de plataforma > Notificaciones de eventos.

  5. Seleccione la casilla de verificación Habilitar notificaciones de eventos.

  6. Pegue el XML de configuración de notificación en el cuadro de texto y seleccione Guardar cambios.

    Nota Un administrador de StorageGRID debe habilitar los servicios de plataforma para cada cuenta de inquilino mediante Grid Manager o la API de gestión de grid. Póngase en contacto con el administrador de StorageGRID si se produce un error al guardar el XML de configuración.

  7. Compruebe que las notificaciones de eventos están configuradas correctamente:

    1. Realice una acción en un objeto del bloque de origen que cumpla los requisitos para activar una notificación tal y como se ha configurado en el XML de configuración.

      En el ejemplo, una notificación de evento se envía cada vez que se crea un objeto con images/ el prefijo.

    2. Confirme que se haya enviado una notificación al tema de Amazon SNS de destino, al tema de Kafka o al punto final del webhook.

      Por ejemplo, si el tema de destino está alojado en Amazon SNS, puede configurar el servicio para que le envíe un correo electrónico cuando se entregue la notificación.

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

    + Si se recibe la notificación en el tema de destino, ha configurado correctamente el bloque de origen para las notificaciones StorageGRID.

Información relacionada