Skip to main content
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Configurez les notifications d'événements dans StorageGRID

PDF

Vous activez les notifications pour un compartiment en créant un fichier XML de configuration de notification et en utilisant le Tenant Manager pour appliquer le fichier XML à un compartiment.

Avant de commencer

  • ${post_edited_translations.segment}

  • Vous avez déjà créé un compartiment qui servira de source de notifications.

  • Le point de terminaison que vous souhaitez utiliser comme destination pour les notifications d'événements existe déjà, et vous disposez de son URN.

  • Vous appartenez à un groupe d'utilisateurs qui dispose de la "Gérer tous les compartiments ou autorisation d'accès Root". Ces autorisations prévalent sur les paramètres d'autorisation des politiques de groupe ou de compartiment lors de la configuration du compartiment à l'aide du Tenant Manager.

À propos de cette tâche

Vous configurez les notifications d'événements en associant un fichier XML de configuration de notification à un compartiment source. Le fichier XML de configuration de notification suit les conventions S3 pour la configuration des notifications de compartiment, avec la destination (rubrique Amazon SNS, rubrique Kafka ou point de terminaison webhook) spécifiée comme l'URN d'un point de terminaison.

Pour obtenir des informations générales sur les notifications d'événements et leur configuration, consultez la "Documentation Amazon". Pour des informations sur la manière dont StorageGRID implémente l'API de configuration des notifications de compartiment S3, consultez la "Instructions pour la mise en œuvre des applications clientes S3".

Notez les exigences et caractéristiques suivantes lors de la configuration des notifications d'événements pour un compartiment :

  • Lorsque vous créez et appliquez un fichier XML de configuration de notification valide, celui-ci doit utiliser l'URN d'un point de terminaison de notification d'événement pour chaque destination.

  • Bien que la notification d'événements puisse être configurée sur un compartiment avec S3 Object Lock activé, les métadonnées S3 Object Lock (y compris Retain Until Date et Legal Hold status) des objets ne seront pas incluses dans les messages de notification.

  • Une fois les notifications d'événements configurées, lorsqu'un événement spécifié se produit pour un objet dans le compartiment source, une notification est générée et envoyée au sujet Amazon SNS, au sujet Kafka ou au point de terminaison webhook utilisé comme destination.

  • Si vous activez les notifications d'événements pour un compartiment contenant des objets, les notifications ne sont envoyées que pour les actions effectuées après l'enregistrement de la configuration des notifications.

Étapes

  1. Activez les notifications pour votre compartiment source :

    • Utilisez un éditeur de texte pour créer le fichier XML de configuration des notifications requis pour activer les notifications d'événements, comme spécifié dans l'API de notification S3.

    • Lors de la configuration du fichier XML, utilisez l'URN d'un point de terminaison de notifications d'événements comme sujet de destination.

      <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. Dans le Tenant Manager, sélectionnez STORAGE (S3) > Buckets.

  3. Sélectionnez le nom du compartiment source.

    ${post_edited_translations.segment}

  4. Sélectionnez Services de la plateforme > Notifications d'événements.

  5. Cochez la case Activer les notifications d'événements.

  6. Collez le code XML de configuration des notifications dans la zone de texte, puis sélectionnez Enregistrer les modifications.

    Remarque Les services de plateforme doivent être activés pour chaque compte client par un administrateur StorageGRID à l'aide de Grid Manager ou de l'API de gestion Grid. Contactez votre administrateur StorageGRID si une erreur se produit lors de l'enregistrement du fichier de configuration XML.

  7. Vérifiez que les notifications d'événements sont correctement configurées :

    1. Effectuez une action sur un objet dans le compartiment source qui répond aux exigences pour déclencher une notification, comme configuré dans le fichier XML de configuration.

      Dans cet exemple, une notification d'événement est envoyée chaque fois qu'un objet est créé avec le images/ préfixe.

    2. Confirmez qu'une notification a été remise au sujet Amazon SNS, au sujet Kafka ou au point de terminaison webhook de destination.

      Par exemple, si votre sujet de destination est hébergé sur Amazon SNS, vous pouvez configurer le service pour qu'il vous envoie un e-mail lorsque la notification est livrée.

    {
   "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 la notification est reçue sur le sujet de destination, vous avez correctement configuré votre compartiment source pour les notifications StorageGRID.

Informations connexes