Get Vault Notifications (GET notification-configuration)

Beschreibung

Diese Operation ruft die notification-configuration-Unterressource ab, die auf dem Tresor eingerichtet ist, (siehe Set Vault Notification Configuration (PUT notification-configuration). Wenn die Benachrichtigungskonfiguration für einen Tresor nicht eingerichtet ist, gibt die Operation einen 404 Not Found-Fehler zurück. Weitere Informationen zu Tresorbenachrichtigungen finden Sie unter Konfigurieren von Tresorbenachrichtigungen in Amazon S3 Glacier.

Anforderungen

Um Informationen zur Benachrichtigungskonfiguration abzurufen, senden Sie eine GET-Anfrage an den URI der notification-configuration-Unterressource des Tresors.

Syntax

GET /AccountId/vaults/VaultName/notification-configuration HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

Anmerkung

Der AccountId-Wert ist die AWS-Konto-ID des Kontos, dem der Tresor gehört. Sie können entweder eine AWS-Konto-ID oder optional einen einzelnen Bindestrich („-“) angeben. Bei Angabe eines Bindestrichs verwendet Amazon S3 Glacier die AWS-Konto-ID, die mit den zum Signieren der Anforderung verwendeten Anmeldeinformationen verknüpft ist. Wenn Sie eine Konto-ID verwenden, darf die ID keine Bindestriche („-“) enthalten.

Anfrageparameter

Dieser Vorgang verwendet keine Anforderungsparameter.

Anforderungsheader

Für diesen Vorgang werden ausschließlich Anforderungs-Header verwendet, die für alle Vorgänge gelten. Weitere Informationen über allgemeine Anforderungs-Header finden Sie unter Häufig verwendete Anforderungsheader.

Anforderungstext

Dieser Vorgang besitzt keinen Anforderungstext.

Antworten

Syntax

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
  "Events": [
    String,
    ...
  ],
  "SNSTopic": String
}

Antwort-Header

Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter Allgemeine Antwort-Header.

Antworttext

Der Antworttext enthält die folgenden JSON-Felder.

Ereignisse

Eine Liste mit einem oder mehreren Ereignissen, für die Amazon S3 Glacier (S3 Glacier) eine Benachrichtigung an das angegebene Amazon-SNS-Thema senden wird. Informationen über Tresorereignisse, für die Sie Tresore so konfigurieren können, dass Benachrichtigungen veröffentlicht werden, finden Sie unter Set Vault Notification Configuration (PUT notification-configuration).

Typ: Array

SNSTopic

Der Amazon-Ressourcenname (ARN) des Amazon Simple Notification Service (Amazon SNS)-Themas. Weitere Informationen finden Sie unter Erste Schritte mit Amazon SNS im Handbuch „Erste Schritte“ für den Amazon Simple Notification Service.

Typ: Zeichenfolge

Fehler

Weitere Informationen über Ausnahmen und Fehlermeldungen in Amazon S3 Glacier finden Sie unter Fehlermeldungen.

Beispiele

Das folgende Beispiel zeigt, wie die Benachrichtigungskonfiguration für einen Tresor abgerufen wird.

Beispielanfrage

In diesem Beispiel wird eine GET-Anfrage an die notification-configuration-Unterressource eines Tresors gesendet.

GET /-/vaults/examplevault/notification-configuration HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Beispielantwort

Falls die Anforderung erfolgreich beantwortet wird, wird das Dokument zur Konfiguration der Prüfprotokollierung im Antworttext im JSON-Format angezeigt. In diesem Beispiel zeigt die Konfiguration, dass Benachrichtigungen für zwei Ereignisse (ArchiveRetrievalCompleted und InventoryRetrievalCompleted) an das Amazon-SNS-Thema arn:aws:sns:us-west-2:012345678901:mytopic gesendet werden.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 150
  
{
  "Events": [
    "ArchiveRetrievalCompleted",
    "InventoryRetrievalCompleted"
  ],
  "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"
}

Zugehörige Abschnitte

• Delete Vault Notifications (DELETE notification-configuration)

• Set Vault Notification Configuration (PUT notification-configuration)

• Identitäts- und Zugriffsverwaltung für Amazon S3 Glacier

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen Amazon-SDKs finden Sie unter:

• AWS Command Line Interface