Utilisation d'Amazon SQSSNS, Amazon et Lambda

L'activation des notifications s'effectue au niveau du compartiment. Vous stockez les informations de configuration de la notification dans la sous-ressource notification qui est associée à un compartiment. Après avoir créé ou modifié la configuration de notification du compartiment, il faut généralement attendre 5 minutes pour que les modifications prennent effet. Lorsque la notification est activée pour la première fois, un événement s3:TestEvent se produit. Suivez l'une des méthodes suivantes pour gérer la configuration des notifications :

• Via la console Amazon S3 – Vous pouvez utilisez l'interface de la console pour définir une configuration de notifications pour un compartiment sans écrire de code. Pour plus d’informations, consultez Activation et configuration des notifications d'événements à l'aide de la console Amazon S3.

• En utilisant par programmation le AWS SDKs — En interne, à la fois la console et l'SDKsappel à Amazon S3 REST API pour gérer les sous-ressources de notification associées au compartiment. Pour des exemples de configurations de notification utilisées AWS SDK, voirProcédure pas à pas : Configuration d'un compartiment pour les notifications (SNSsujet ou SQS file d'attente).

  Note

  Vous pouvez également passer les REST API appels Amazon S3 directement à partir de votre code. Toutefois, cette méthode peut s'avérer fastidieuse, car vous devez écrire du code pour authentifier vos demandes.

Quelle que soit la méthode que vous utilisez, Amazon S3 stocke la configuration des notifications comme XML dans la sous-ressource de notification associée à un compartiment. Pour plus d’informations sur les sous-ressources de compartiment, consultez Options de configuration des compartiments.

Rubriques

• Octroi d'autorisations pour la publication de messages de notification d'événement vers une destination
• Activation et configuration des notifications d'événements à l'aide de la console Amazon S3
• Configuration des notifications d'événements par programmation
• Procédure pas à pas : Configuration d'un compartiment pour les notifications (SNSsujet ou SQS file d'attente)
• Configuration des notifications d'événement à l'aide du filtrage des noms de clé d'objet
• Structure des messages d'événements

Configuration des notifications d'événements par programmation

Par défaut, les notifications sont désactivées pour tous les types d'événements. Par conséquent, la sous-ressource notification stocke initialement une configuration vide.

<NotificationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> 
</NotificationConfiguration>

Pour activer les notifications pour des types d'événements spécifiques, vous devez les XML remplacer par la configuration appropriée qui identifie les types d'événements que vous souhaitez qu'Amazon S3 publie et la destination où vous souhaitez que les événements soient publiés. Pour chaque destination, vous ajoutez une XML configuration correspondante.

Pour publier des messages d'événements dans une SQS file d'attente

Pour définir une SQS file d'attente comme destination de notification pour un ou plusieurs types d'événements, ajoutez leQueueConfiguration.

<NotificationConfiguration>
  <QueueConfiguration>
    <Id>optional-id-string</Id>
    <Queue>sqs-queue-arn</Queue>
    <Event>event-type</Event>
    <Event>event-type</Event>
     ...
  </QueueConfiguration>
   ...
</NotificationConfiguration>

Pour publier des messages d'événements dans un SNS sujet

Pour définir un SNS sujet comme destination de notification pour des types d'événements spécifiques, ajoutez leTopicConfiguration.

<NotificationConfiguration>
  <TopicConfiguration>
     <Id>optional-id-string</Id>
     <Topic>sns-topic-arn</Topic>
     <Event>event-type</Event>
     <Event>event-type</Event>
      ...
  </TopicConfiguration>
   ...
</NotificationConfiguration>

Pour appeler la AWS Lambda fonction et fournir un message d'événement en tant qu'argument

Pour définir une fonction Lambda comme destination de notification pour des types d'événements spécifiques, ajoutez l'élément CloudFunctionConfiguration.

<NotificationConfiguration>
  <CloudFunctionConfiguration>   
     <Id>optional-id-string</Id>   
     <CloudFunction>cloud-function-arn</CloudFunction>        
     <Event>event-type</Event>      
     <Event>event-type</Event>      
      ...  
  </CloudFunctionConfiguration>
   ...
</NotificationConfiguration>

Suppression de toute les notifications configurées pour un compartiment

Pour supprimer toutes les notifications configurées pour un compartiment, enregistrez un élément <NotificationConfiguration/> vide dans la sous-ressource notification.

Lorsque Amazon S3 détecte un événement qui appartient au type spécifié, il publie un message contenant les informations relatives à cet événement. Pour plus d’informations, consultez Structure des messages d'événements.

Pour plus d'informations sur la configuration des notifications d'événements, consultez les rubriques suivantes :

• Procédure pas à pas : Configuration d'un compartiment pour les notifications (SNSsujet ou SQS file d'attente).

• Configuration des notifications d'événement à l'aide du filtrage des noms de clé d'objet