Wenn Sie mit dem Archivierungsspeicher in Amazon Simple Storage Service (Amazon S3) noch nicht vertraut sind, empfehlen wir Ihnen, sich zunächst über die S3-Glacier-Speicherklassen in Amazon S3 (S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive) zu informieren. Weitere Informationen finden Sie unter S3 Glacier-Speicherklassen
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.
Purchase Provisioned Capacity (POST provisioned-capacity)
Dieser Vorgang kauft eine bereitgestellte Kapazitätseinheit für ein AWS-Konto.
Eine bereitgestellte Kapazitätseinheit ist ab dem Datum und der Uhrzeit des Kaufs (dem Startdatum), einen Monat lang gültig. Die Einheit läuft am Ablaufdatum ab, das auf die nächste Sekunde gerundet genau einen Monat nach dem Startdatum liegt.
Wenn das Startdatum der 31. Tag eines Monats ist, dann ist der letzte Tag des nächsten Monats das Ablaufdatum. Beispiel: Ist das Startdatum der 31. August, dann ist der 30. September das Ablaufdatum. Ist das Startdatum der 31. Januar, dann ist der 28. Februar das Ablaufdatum.
Die bereitgestellte Kapazität hilft sicherzustellen, dass für Expedited-Abrufe Abrufkapazität verfügbar ist, wenn Sie sie benötigen. Jede Kapazitätseinheit stellt sicher, dass alle fünf Minuten mindestens drei Expedited-Abrufe durchgeführt werden können, und bietet bis zu 150 MB/s Abrufdurchsatz. Weitere Informationen über bereitgestellte Kapazität finden Sie unter Archiv-Abrufoptionen.
Anmerkung
Es gibt ein Limit von zwei bereitgestellten Kapazitätseinheiten pro AWS-Konto.
Anforderungen
Senden Sie eine HTTP-POST-Anforderung an den Provisioned-Capacity-URI, um eine Einheit bereitgestellter Kapazität für ein AWS-Konto zu kaufen.
Syntax
POST /AccountId/provisioned-capacity HTTP/1.1 Host: glacier.Region.amazonaws.com Date:DateAuthorization:SignatureValueContent-Length:Lengthx-amz-glacier-version: 2012-06-01
Anmerkung
Der AccountId-Wert ist die AWS-Konto-ID. Dieser Wert muss mit der AWS-Konto-ID übereinstimmen, die mit den zum Signieren der Anforderung verwendeten Anmeldeinformationen verknüpft ist. 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 Ihre Konto-ID angeben, müssen Sie sie ohne Bindestriche („-“) eingeben.
Anfrageparameter
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
Wenn die Anfrage erfolgreich ist, gibt der Service die HTTP-Antwort 201
Created zurück.
Syntax
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-capacity-id:CapacityId
Antwort-Header
Eine erfolgreiche Antwort umfasst zusätzlich zu den Antwort-Headern, die allen Vorgängen gemeinsam sind, die folgenden Antwort-Header. Weitere Informationen über allgemeine Antwort-Header finden Sie unter Allgemeine Antwort-Header.
| Name | Beschreibung |
|---|---|
|
|
Die ID, mit der die bereitgestellte Kapazitätseinheit identifiziert wird. Typ: Zeichenfolge |
Antworttext
Dieser Vorgang gibt keinen Antworttext zurück.
Fehler
Dieser Vorgang umfasst zusätzlich zu den möglichen Fehlern, die allen Amazon S3-Glacier-Vorgängen gemeinsam sind, die folgenden Fehler. Informationen zu Amazon-S3-Glacier-Fehlern und eine Liste der Fehlercodes finden Sie unter Fehlermeldungen.
| Code | Beschreibung | HTTP-Statuscode | Typ |
|---|---|---|---|
LimitExceededException |
Wird zurückgegeben, wenn die gestellte Anfrage das Limit für Einheiten bereitgestellter Kapazität des Kontos überschreiten würde. | 400 Bad Request |
Client |
Beispiele
Das Folgende ist ein Beispiel für den Kauf bereitgestellter Kapazität für ein Konto.
Beispielanfrage
Im folgenden Beispiel wir eine HTTP-POST-Anfrage gesendet, um eine Einheit bereitgestellter Kapazität zu kaufen.
POST /123456789012/provisioned-capacity HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 Content-Length:lengthx-amz-glacier-version: 2012-06-01
Beispielantwort
Falls die Anforderung erfolgreich war, gibt Amazon S3 Glacier (S3 Glacier) als Antwort HTTP 201 Created zurück, wie im folgenden Beispiel gezeigt.
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z
Zugehörige Abschnitte
