**Diese Seite ist nur für Bestandskunden des Amazon Glacier-Service bestimmt, die Vaults und die ursprüngliche REST-API von 2012 verwenden.**
Wenn Sie nach Archivspeicherlösungen suchen, empfehlen wir die Verwendung der Amazon 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 [Amazon Glacier-Speicherklassen](https://aws.amazon.com/s3/storage-classes/glacier/).
Amazon Glacier (ursprünglicher eigenständiger, auf Tresor basierender Service) akzeptiert keine Neukunden mehr. Amazon Glacier ist ein eigenständiger Service APIs , der Daten in Tresoren speichert und sich von den Speicherklassen Amazon S3 und Amazon S3 Glacier unterscheidet. Ihre vorhandenen Daten bleiben in Amazon Glacier auf unbestimmte Zeit sicher und zugänglich. Es ist keine Migration erforderlich. Für kostengünstige, langfristige Archivierungsspeicherung AWS empfiehlt sich die [Amazon S3 Glacier-Speicherklasse](https://aws.amazon.com/s3/storage-classes/glacier/), die mit S3-Bucket-Basis, voller AWS-Region Verfügbarkeit APIs, geringeren Kosten und AWS Serviceintegration ein hervorragendes Kundenerlebnis bieten. Wenn Sie erweiterte Funktionen wünschen, sollten Sie eine Migration zu Amazon S3 Glacier-Speicherklassen in Betracht ziehen, indem Sie unseren [AWS Lösungsleitfaden für die Übertragung von Daten aus Amazon Glacier-Tresoren in Amazon S3 Glacier-Speicherklassen](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/) verwenden.
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.
# Set Vault Notification Configuration (PUT notification-configuration)
## Description
Das Abrufen eines Archivs und eines Tresorbestands sind asynchrone Vorgänge in Amazon Glacier (Amazon Glacier), für die Sie zuerst einen Job initiieren und warten müssen, bis der Job abgeschlossen ist, bevor Sie die Job-Ausgabe herunterladen können. Sie können einen Tresor so konfigurieren, dass er eine Mitteilung an ein Amazon Simple Notification Service (Amazon SNS)-Thema sendet, wenn diese Aufträge abgeschlossen sind. Sie können mithilfe dieser Operation Benachrichtigungen für den Tresor konfigurieren. Weitere Informationen finden Sie unter [Konfiguration von Tresor-Benachrichtigungen in Amazon Glacier](configuring-notifications.md).
Senden Sie eine PUT-Anforderung an die Unterressource `notification-configuration` des Tresors, um Tresorbenachrichtigungen zu konfigurieren. Eine Benachrichtigungskonfiguration ist spezifisch für einen Tresor. Daher wird sie auch als eine Unterressource des Tresors bezeichnet. Die Anfrage sollte ein JSON-Dokument enthalten, das ein Amazon Simple Notification Service (Amazon SNS) -Thema und die Ereignisse enthält, für die Amazon Glacier Benachrichtigungen zu diesem Thema senden soll.
Sie können einen Tresor so konfigurieren, dass er eine Benachrichtigung für die folgenden Tresorereignisse veröffentlicht:
+ **`ArchiveRetrievalCompleted`**: Dieses Ereignis tritt ein, wenn ein Auftrag, der für einen Archivabruf initiiert wurde, abgeschlossen ist ([Initiate Job (POST jobs)](api-initiate-job-post.md)). Der Status des abgeschlossenen Auftrags kann `Succeeded` oder `Failed` sein. Die Benachrichtigung, die an das SNS-Thema gesendet wird, ist die gleiche Ausgabe, wie sie von [Describe Job (GET JobID)](api-describe-job-get.md) zurückgegeben wurde.
+ **`InventoryRetrievalCompleted`**: Dieses Ereignis tritt ein, wenn ein Auftrag, der für einen Bestandsabruf initiiert wurde, abgeschlossen ist ([Initiate Job (POST jobs)](api-initiate-job-post.md)). Der Status des abgeschlossenen Auftrags kann `Succeeded` oder `Failed` sein. Die Benachrichtigung, die an das SNS-Thema gesendet wird, ist die gleiche Ausgabe, wie sie von [Describe Job (GET JobID)](api-describe-job-get.md) zurückgegeben wurde.
Amazon-SNS-Themen müssen die Berechtigung für den Tresor erteilen, damit Benachrichtigungen für das Thema veröffentlicht werden dürfen.
## Anforderungen
Senden Sie eine PUT-Anfrage an den URI der Unterressource `notification-configuration` des Tresors, um die Benachrichtigungskonfiguration auf Ihrem Tresor einzurichten. Geben Sie die Konfiguration im Antworttext an. Die Konfiguration umfasst den Namen des Amazon-SNS-Themas und ein Array von Ereignissen, die Benachrichtigungen für jedes Thema auslösen.
### Syntax
```
1. PUT /AccountId/vaults/VaultName/notification-configuration HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
6.
7. {
8. "SNSTopic": String,
9. "Events":[String, ...]
10. }
```
**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 ein einzelnes '`-`' (Bindestrich) angeben. In diesem Fall verwendet Amazon Glacier die AWS-Konto ID, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Wenn Sie eine Konto-ID verwenden, darf die ID keine Bindestriche („-“) enthalten.
### Anforderungsparameter
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](api-common-request-headers.md).
### Anforderungstext
Der JSON im Anfragentext enthält die folgenden Felder.
**-**-Ereignisse
Eine Reihe von einem oder mehreren Ereignissen, für die Amazon Glacier eine Benachrichtigung senden soll.
*Gültige Werte*: `ArchiveRetrievalCompleted` \$1 `InventoryRetrievalCompleted`
*Erforderlich*: Ja
*Typ*: Array
**SNSTopic**
Der ARN des Amazon-SNS-Themas. Weitere Informationen finden Sie unter [Erste Schritte mit Amazon SNS](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html) im *Handbuch „Erste Schritte“ für Amazon Simple Notification Service*.
*Erforderlich*: Ja
*Typ:* Zeichenfolge
## Antworten
Als Antwort gibt Amazon Glacier (Amazon Glacier) zurück`204 No Content`, ob die Benachrichtigungskonfiguration akzeptiert wurde.
### Syntax
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### Antwort-Header
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](api-common-request-headers.md).
### Antworttext
Dieser Vorgang gibt keinen Antworttext zurück.
### Fehler
Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unter[Fehlermeldungen](api-error-responses.md).
## Beispiele
Das folgende Beispiel zeigt, wie eine Tresorbenachrichtigung konfiguriert wird.
### Beispielanforderung
Die folgende Anforderung richtet die `examplevault`-Benachrichtigungskonfiguration so ein, dass Benachrichtigungen für zwei Ereignisse (`ArchiveRetrievalCompleted` und `InventoryRetrievalCompleted`) an das Amazon-SNS-Thema `arn:aws:sns:us-west-2:012345678901:mytopic` gesendet werden.
```
1. PUT /-/vaults/examplevault/notification-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
6.
7. {
8. "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"],
9. "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"
10. }
```
### Beispielantwort
Eine erfolgreiche Antwort gibt ein `204 No Content` zurück.
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Zugehörige Abschnitte
+ [Get Vault Notifications (GET notification-configuration)](api-vault-notifications-get.md)
+ [Delete Vault Notifications (DELETE notification-configuration)](api-vault-notifications-delete.md)
+ [Identity and Access Management für Amazon Glacier](security-iam.md)
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen Amazon SDKs finden Sie im Folgenden:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/set-vault-notifications.html)