**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 Data Retrieval Policy (PUT policy) ## Beschreibung Durch diesen Vorgang wird eine Datenabrufrichtlinie in der in der Anforderung angegebenen AWS Region festgelegt und anschließend umgesetzt. `PUT` Sie können eine Richtlinie pro AWS Region für eine festlegen. AWS-Konto Die Richtlinie wird bei einer erfolgreichen `PUT`-Operation innerhalb weniger Minuten umgesetzt. Die Operation zur Einrichtung der Richtlinie wirkt sich nicht auf Abrufaufträge aus, die in Bearbeitung waren, bevor die Richtlinie umgesetzt wurde. Weitere Informationen zu Datenabrufrichtlinien finden Sie unter [Amazon Glacier-Richtlinien für den Datenabruf](data-retrieval-policy.md). ## Anforderungen ### Syntax Senden Sie eine HTTP-PUT-Anfrage an den URI der Datenabrufrichtlinie, um eine Datenabrufrichtlinie einzurichten. Orientieren Sie sich dabei an dem folgenden Syntaxbeispiel. ``` 1. PUT /AccountId/policies/data-retrieval HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. Content-Length: Length 6. x-amz-glacier-version: 2012-06-01 7. 8. { 9. "Policy": 10. { 11. "Rules":[ 12. { 13. "Strategy": String, 14. "BytesPerHour": Number 15. } 16. ] 17. } 18. } ``` **Anmerkung** Der `AccountId` Wert ist die AWS-Konto ID. Dieser Wert muss mit der AWS-Konto ID übereinstimmen, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. 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 Ihre Konto-ID angeben, müssen Sie sie ohne Bindestriche („-“) eingeben. ### 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 Anforderungstext enthält die folgenden JSON-Felder. **BytesPerHour** Die Höchstanzahl an Bytes, die in einer Stunde abgerufen werden können. Dieses Feld ist nur dann ein Pflichtfeld, wenn der Wert im Strategy-Feld `BytesPerHour` ist. Ihre PUT-Operation wird abgelehnt, wenn das Strategy-Feld nicht auf `BytesPerHour` festgelegt ist und Sie dieses Feld festlegen. *Typ*: Zahl *Erforderlich*: Ja, wenn das Strategie-Feld auf `BytesPerHour` festgelegt ist. Ansonsten nein. *Gültige Werte*: Mindestganzzahlwert 1. Höchstganzzahlwert 2^63 - 1 inklusive. **Regeln** Die Richtlinienregel. Obwohl es sich um einen Listentyp handelt, darf es derzeit nur eine Regel geben, die ein Strategiefeld und optional ein BytesPerHour Feld enthält. *Typ*: Array *Erforderlich*: Ja **Strategie** Der Typ der einzurichtenden Datenabrufrichtlinie. *Typ:* Zeichenfolge *Erforderlich*: Ja Gültige Werte: `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour` entspricht der Auswahl von **Max Retrieval Rate (Max. Abrufrate)** in der Konsole. `FreeTier` entspricht der Auswahl von **Free Tier Only (Nur kostenloses Kontingent)** in der Konsole. `None` entspricht der Auswahl von **No Retrieval Policy (Keine Abrufrichtlinie)** in der Konsole. Weitere Informationen zur Auswahl von Datenabrufrichtlinien in der Konsole finden Sie unter [Amazon Glacier-Richtlinien für den Datenabruf](data-retrieval-policy.md). ## Antworten ### Syntax ``` HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date ``` ### 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](api-common-response-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 ### Beispielanfrage Im folgenden Beispiel wird eine HTTP-PUT-Anfrage gesendet, mit dem Strategy-Feld festgelegt auf `BytesPerHour`. ``` 1. PUT /-/policies/data-retrieval 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. "Policy": 9. { 10. "Rules":[ 11. { 12. "Strategy":"BytesPerHour", 13. "BytesPerHour":10737418240 14. } 15. ] 16. } 17. } ``` Im folgenden Beispiel wird eine HTTP-PUT-Anfrage gesendet, mit dem Strategy-Feld festgelegt auf `FreeTier`. ``` 1. PUT /-/policies/data-retrieval 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. "Policy": 9. { 10. "Rules":[ 11. { 12. "Strategy":"FreeTier" 13. } 14. ] 15. } 16. } ``` Im folgenden Beispiel wird eine HTTP-PUT-Anfrage gesendet, mit dem Strategy-Feld festgelegt auf `None`. ``` 1. PUT /-/policies/data-retrieval 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. "Policy": 9. { 10. "Rules":[ 11. { 12. "Strategy":"None" 13. } 14. ] 15. } 16. } ``` ### Beispielantwort Wenn die Anfrage erfolgreich war, legt Amazon Glacier (Amazon Glacier) die Richtlinie fest und gibt a zurück, `HTTP 204 No Content` wie im folgenden Beispiel gezeigt. ``` 1. HTTP/1.1 204 No Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT ``` ## Zugehörige Abschnitte + [Get Data Retrieval Policy (GET policy)](api-GetDataRetrievalPolicy.md) + [Initiate Job (POST jobs)](api-initiate-job-post.md)