Konfigurieren von Tresorbenachrichtigungen in Amazon S3 Glacier - Amazon S3 Glacier

Diese Seite richtet sich nur an Bestandskunden des S3 Glacier-Dienstes, die Vaults und das Original REST API von 2012 verwenden.

Wenn Sie nach Archivspeicherlösungen suchen, empfehlen wir die Verwendung der S3 Glacier-Speicherklassen in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive. Weitere Informationen zu diesen Speicheroptionen finden Sie unter S3 Glacier-Speicherklassen und Langfristige Datenspeicherung mit S3 Glacier-Speicherklassen im Amazon S3 S3-Benutzerhandbuch. Diese Speicherklassen verwenden Amazon S3API, sind in allen Regionen verfügbar und können in der Amazon S3 S3-Konsole verwaltet werden. Sie bieten Funktionen wie Speicherkostenanalyse, Storage Lens, erweiterte optionale Verschlüsselungsfunktionen und mehr.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konfigurieren von Tresorbenachrichtigungen in Amazon S3 Glacier

Das Abrufen von beliebigen Daten aus Amazon S3 Glacier, etwa eines Archivs aus einem Tresor oder eines Tresorinventars, ist ein zweistufiger Prozess.

  1. Initiieren Sie einen Abrufauftrag.

  2. Sie können die Auftragsausgabe herunterladen, nachdem der Auftrag abgeschlossen wurde.

Sie können eine Benachrichtigungskonfiguration für einen Tresor einrichten, sodass nach Abschluss eines Auftrags eine Nachricht an ein Amazon Simple Notification Service (Amazon SNS)-Thema gesendet wird.

Konfigurieren von Tresorbenachrichtigungen in S3 Glacier: Allgemeine Konzepte

Eine Anforderung für einen S3-Glacier-Abrufauftrag wird asynchron ausgeführt. Sie müssen warten, bis S3 Glacier den Auftrag abgeschlossen hat, bevor Sie die Ausgabe abrufen können. Sie können S3 Glacier regelmäßig abfragen, um den Status des Auftrags zu ermitteln, aber dies ist kein optimaler Ansatz. S3 Glacier unterstützt auch Benachrichtigungen. Wenn ein Auftrag abgeschlossen wurde, kann er eine Mitteilung an ein Amazon Simple Notification Service (Amazon SNS)-Thema senden. Dafür müssen Sie eine Benachrichtigungskonfiguration für den Tresor einrichten. In der Konfiguration identifizieren Sie eines oder mehrere Ereignisse und ein Amazon-SNS-Thema, an das S3 Glacier eine Nachricht senden soll, wenn das Ereignis eintritt.

S3 Glacier definiert Ereignisse, die sich speziell auf den Abschluss eines Auftrags beziehen (ArchiveRetrievalCompleted, InventoryRetrievalCompleted). Diese können Sie der Benachrichtigungskonfiguration des Tresors hinzufügen. Wenn ein bestimmter Auftrag abgeschlossen wurde, veröffentlicht S3 Glacier eine Benachrichtigung im SNS-Thema.

Die Benachrichtigungskonfiguration ist ein JSON-Dokument, wie im folgenden Beispiel gezeigt.

{ "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] }

Sie können für einen Tresor nur ein Amazon-SNS-Thema konfigurieren.

Anmerkung

Das Hinzufügen einer Benachrichtigungskonfiguration zu einem Tresor führt dazu, dass S3 Glacier jedes Mal eine Benachrichtigung sendet, wenn das in der Benachrichtigungskonfiguration angegebene Ereignis eintritt. Optional können Sie auch in jeder Anforderung zur Auftragsinitiierung ein Amazon-SNS-Thema angeben. Wenn Sie sowohl die Benachrichtigungskonfiguration für den Tresor hinzufügen als auch ein Amazon-SNS-Thema in Ihrer Anforderung zur Auftragsinitiierung angeben, sendet S3 Glacier beide Benachrichtigungen.

Die Nachricht zum Abschluss des Auftrags, die S3 Glacier sendet, enthält Informationen wie den Typ des Auftrags (InventoryRetrieval, ArchiveRetrieval), den Status des Auftragsabschlusses, den Namen des SNS-Themas, den Auftragsstatuscode und den Tresor-ARN. Die folgende Beispielbenachrichtigung wurde von S3 Glacier an ein SNS-Thema gesendet, nachdem ein InventoryRetrieval-Auftrag abgeschlossen wurde.

{ "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSizeInBytes": null, "Completed": true, "CompletionDate": "2012-06-12T22:20:40.790Z", "CreationDate": "2012-06-12T22:20:36.814Z", "InventorySizeInBytes":11693, "JobDescription": "my retrieval job", "JobId":"HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", "SHA256TreeHash":null, "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", "StatusCode":"Succeeded", "StatusMessage": "Succeeded", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" }

Wenn das Feld Completed wahr ist, müssen Sie auch anhand des StatusCode überprüfen, ob der Job erfolgreich beendet wurde oder fehlgeschlagen ist.

Anmerkung

Das Amazon-SNS-Thema muss dem Tresor erlauben, eine Benachrichtigung zu veröffentlichen. Standardmäßig kann nur der Eigentümer des Amazon-SNS-Themas eine Nachricht im Thema veröffentlichen. Wenn das Amazon-SNS-Thema und der Tresor jedoch unterschiedlichen AWS-Konten gehören, müssen Sie das Amazon-SNS-Thema so konfigurieren, dass es Veröffentlichungen vom Tresor akzeptiert. Sie können die Richtlinie für das Amazon-SNS-Thema in der Amazon-SNS-Konsole konfigurieren.

Weitere Informationen zu Amazon SNS finden Sie unter Erste Schritte mit Amazon SNS.