Purchase Provisioned Capacity (POST provisioned-capacity) - Amazon S3 Glacier

Diese Seite ist nur für Bestandskunden des S3 Glacier-Dienstes bestimmt, die Vaults und die ursprüngliche 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 die Amazon S3 S3-API, 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.

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

Um eine bereitgestellte Kapazitätseinheit für einen zu erwerben, AWS-Konto senden Sie eine POST HTTP-Anfrage an die URI für bereitgestellte Kapazität.

Syntax

POST /AccountId/provisioned-capacity HTTP/1.1 Host: glacier.Region.amazonaws.com Date: Date Authorization: SignatureValue Content-Length: Length x-amz-glacier-version: 2012-06-01

Anmerkung

Der AccountId Wert ist die ID. AWS-Konto 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 S3 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

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

x-amz-capacity-id

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: length x-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