Verwendung von Amazon SQSSNS, Amazon und Lambda

Die Aktivierung von Benachrichtigungen erfolgt auf Bucket-Ebene. Sie speichern Informationen zur Benachrichtigungskonfiguration in der Benachrichtigungen-Unterressourcen die einem Bucket zugeordnet sind. Nachdem Sie die Bucket-Benachrichtigungskonfiguration erstellt oder geändert haben, dauert es normalerweise etwa fünf Minuten, bis die Änderungen wirksam werden. Ein s3:TestEvent tritt auf, wenn die Benachrichtigung zum ersten Mal aktiviert wird. Sie können jede der folgenden Methoden verwenden, um die Benachrichtigungskonfiguration zu verwalten:

• Verwenden der Amazon-S3-Konsole – Die Benutzeroberfläche der Konsole ermöglicht Ihnen, eine Benachrichtigungskonfiguration für einen Bucket einzurichten, ohne Code schreiben zu müssen. Weitere Informationen finden Sie unter Aktivieren und Konfigurieren von Ereignis-Benachrichtigungen mit der Amazon-S3-Konsole.

• Programmgesteuert mit dem AWS SDKs— Intern SDKs rufen sowohl die Konsole als auch Amazon S3 REST API auf, um die Unterressourcen für Benachrichtigungen zu verwalten, die dem Bucket zugeordnet sind. Hier finden Sie Beispiele für Benachrichtigungskonfigurationen, die Folgendes verwenden AWS SDK, sieheExemplarische Vorgehensweise: Konfiguration eines Buckets für Benachrichtigungen (SNSThema oder SQS Warteschlange).

  Anmerkung

  Sie können die Amazon S3 REST API S3-Anrufe auch direkt von Ihrem Code aus tätigen. Dies kann jedoch umständlich sein, da Sie dazu Code schreiben müssen, um Ihre Anforderungen zu authentifizieren.

Unabhängig von der Methode, die Sie verwenden, speichert Amazon S3 die Benachrichtigungskonfiguration wie XML in der Benachrichtigungs-Subressource, die einem Bucket zugeordnet ist. Weitere Informationen zu Bucket-Subressourcen finden Sie unter Optionen für die Bucket-Konfiguration.

Anmerkung

Wenn Sie aufgrund gelöschter Ziele mehrere fehlgeschlagene Ereignisbenachrichtigungen haben, erhalten Sie möglicherweise die Meldung Die folgenden Zielkonfigurationen konnten nicht überprüft werden, wenn Sie versuchen, sie zu löschen. Sie können dieses Problem in der S3-Konsole beheben, indem Sie alle fehlgeschlagenen Benachrichtigungen gleichzeitig löschen.

Themen

• Erteilen von Berechtigungen zur Veröffentlichung von Ereignis-Benachrichtigungsmeldungen an einem Ziel
• Aktivieren und Konfigurieren von Ereignis-Benachrichtigungen mit der Amazon-S3-Konsole
• Programmgesteuerte Konfiguration von Ereignis-Benachrichtigungen
• Exemplarische Vorgehensweise: Konfiguration eines Buckets für Benachrichtigungen (SNSThema oder SQS Warteschlange)
• Konfigurieren von Ereignis-Benachrichtigungen mithilfe der Namensfilterung
• Struktur von Ereignismeldungen

Programmgesteuerte Konfiguration von Ereignis-Benachrichtigungen

Standardmäßig sind für keinen Ereignistyp Benachrichtigungen aktiviert. Aus diesem Grund speichert die Benachrichtigung-Unterressourcen anfänglich eine leere Konfiguration.

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

Um Benachrichtigungen für Ereignisse bestimmter Typen zu aktivieren, ersetzen Sie die durch die XML entsprechende Konfiguration, die die Ereignistypen, die Amazon S3 veröffentlichen soll, und das Ziel, an dem die Ereignisse veröffentlicht werden sollen, identifiziert. Für jedes Ziel fügen Sie eine entsprechende XML Konfiguration hinzu.

Um Ereignisnachrichten in einer SQS Warteschlange zu veröffentlichen

Um eine SQS Warteschlange als Benachrichtigungsziel für einen oder mehrere Ereignistypen festzulegen, fügen Sie die hinzuQueueConfiguration.

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

Um Ereignisnachrichten zu einem SNS Thema zu veröffentlichen

Um ein SNS Thema als Benachrichtigungsziel für bestimmte Ereignistypen festzulegen, fügen Sie den hinzuTopicConfiguration.

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

Um das aufzurufen AWS Lambda Funktion und Bereitstellung einer Ereignisnachricht als Argument

Um eine Lambda-Funktion als Benachrichtigungsziel für bestimmte Ereignistypen festzulegen, fügen Sie CloudFunctionConfiguration hinzu.

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

So entfernen Sie alle in einem Bucket konfigurierten Benachrichtigungen

Um alle für einen Bucket konfigurierten Benachrichtigungen zu entfernen, speichern Sie ein leeres <NotificationConfiguration/>-Element in der notification-Subressource.

Wenn Amazon S3 ein Ereignis des spezifischen Typs erkennt, veröffentlicht es eine Meldung mit der Ereignisinformation. Weitere Informationen finden Sie unter Struktur von Ereignismeldungen.

Weitere Informationen zur Konfiguration von Ereignis-Benachrichtigungen finden Sie in den folgenden Themen:

• Exemplarische Vorgehensweise: Konfiguration eines Buckets für Benachrichtigungen (SNSThema oder SQS Warteschlange).

• Konfigurieren von Ereignis-Benachrichtigungen mithilfe der Namensfilterung