Skip to main content
Hay disponible una nueva versión de este producto.
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.

Configura las notificaciones de eventos en StorageGRID

PDF

Habilitas las notificaciones para un bucket creando un XML de configuración de notificaciones y usando el Tenant Manager para aplicar el XML a un bucket.

Antes de empezar

  • Los servicios de la plataforma fueron habilitados para tu cuenta de inquilino por un administrador de StorageGRID.

  • Ya has creado un bucket que servirá como fuente de notificaciones.

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

  • Perteneces a un grupo de usuarios que tiene el "Gestiona todos los buckets o permiso de acceso a raíz". Estos permisos anulan la configuración de permisos de las políticas de grupo o de bucket al configurar el bucket mediante Tenant Manager.

Acerca de esta tarea

Configuras las notificaciones de eventos asociando un archivo XML de configuración de notificaciones a un bucket de origen. El archivo XML de configuración de notificaciones sigue las convenciones de S3 para configurar notificaciones de buckets, con el tema de Amazon SNS, el tema de Kafka o el endpoint del webhook de destino especificado como el URN de un endpoint.

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

Ten en cuenta los siguientes requisitos y características a la hora de configurar las notificaciones de eventos para un bucket:

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

  • Aunque es posible configurar las notificaciones de eventos en un bucket con S3 Object Lock activado, los metadatos de S3 Object Lock (incluidos Retain Until Date y el estado de Legal Hold) de los objetos no se incluirán en los mensajes de notificación.

  • Después de que configures las notificaciones de eventos, cada vez que ocurra un evento especificado 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 endpoint de webhook que uses como destino.

  • Si activas las notificaciones de eventos para un bucket que contiene objetos, solo se enviarán notificaciones sobre las acciones que se realicen después de guardar la configuración de notificaciones.

Pasos

  1. Activa las notificaciones para tu depósito de origen:

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

    • Al configurar el XML, usa el URN de un endpoint 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 Tenant Manager, selecciona STORAGE (S3) > Buckets.

  3. Selecciona el nombre del depósito de origen.

    Aparece la página de detalles del bucket.

  4. Selecciona Platform services > Event notifications.

  5. Marca la casilla Activar notificaciones de eventos.

  6. Pega el XML de configuración de notificaciones en el cuadro de texto y selecciona Guardar cambios.

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

  7. Comprueba que las notificaciones de eventos estén configuradas correctamente:

    1. Realiza una acción sobre un objeto en el bucket de origen que cumpla los requisitos para activar una notificación según lo configurado en el XML de configuración.

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

    2. Comprueba que se haya entregado una notificación al tema de Amazon SNS, al tema de Kafka o al endpoint del webhook de destino.

      Por ejemplo, si el tema de destino está alojado en Amazon SNS, podrías configurar el servicio para que te 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, has configurado correctamente tu bucket de origen para las notificaciones de StorageGRID.

Información relacionada