Create Vault (PUT vault)

Beschreibung

Mit dieser Operation wird ein neuer Tresor mit dem angegebenen Namen erstellt.  Der Name des Tresors muss in derAWS -Region eindeutig seinAWS-Konto. Sie können bis zu 1.000 Tresore pro Konto erstellen. Informationen zum Erstellen weiterer Tresore finden Sie auf der Amazon S3 Glacier-Produktdetailseite.

Sie müssen bei der Benennung eines Tresors die folgenden Richtlinien beachten.

• Namen können zwischen 1 und 255 Zeichen lang sein.

• Zulässige Zeichen sind a — z, A — 9, „_“ (Unterstrich), „_“ (Unterstrich), „-“ (Bindestrich) und „.“. (Punkt).

Dieser Vorgang ist idempotent, Sie können dieselbe Anfrage mehrmals senden und hat keine weiteren Auswirkungen, nachdem Amazon S3 Glacier (S3 Glacier) den angegebenen Tresor zum ersten Mal erstellt hat.

Anforderungen

Syntax

Zum Erstellen eines Tresors senden Sie eine HTTP PUT-Anforderung an den URI des zu erstellenden Tresors.

PUT /AccountId/vaults/VaultName HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01

Anmerkung

DerAccountId Wert ist dieAWS-Konto ID. Dieser Wert muss mit derAWS-Konto ID übereinstimmen, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Sie können entweder eineAWS-Konto ID oder optional ein einzelnes '-' (Bindestrich) angeben. In diesem Fall verwendet Amazon S3 Glacier dieAWS-Konto ID, die den Anmeldeinformationen zugeordnet ist, mit denen die Anfrage signiert wurde. Wenn Sie Ihre Konto-ID angeben, verwenden Sie keine Bindestriche ('-') in der ID.

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

Der Anforderungstext für diese Operation muss leer sein (0 Bytes).

Antworten

Syntax

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location

Antwort-Header

Eine erfolgreiche Antwort umfasst zusätzlich zu den Antwortheadern, die allen Vorgängen gemeinsam sind, die folgenden Antwortheader. Weitere Informationen zu allgemeinen Antwort-Headern finden Sie unterAllgemeine Antwort-Header.

Name	Beschreibung
Location	Der relative URI-Pad des erstellten Tresors. Typ: Zeichenfolge

Antworttext

Diese Produktion gibt keinen Antworttext zurück.

Fehler

Weitere Informationen zu Amazon S3 Glacier-Ausnahmen und -Fehlermeldungen finden Sie unterFehlermeldungen.

Beispiele

Beispielanfrage

Im folgenden Beispiel wird eine HTTP PUT-Anfrage gesendet, um einen Tresor namens examplevault zu erstellen.

PUT /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Content-Length: 0
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

S3 Glacier erstellt den Tresor und gibt den relativen URI-Pfad des Tresors imLocation Header zurück. Die Konto-ID wird im Location-Header immer angegeben. Dies ist unabhängig von der Angabe der Konto-ID oder eines Bindestrichs („-“) in der Anfrage.

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Location: /111122223333/vaults/examplevault

Zugehörige Abschnitte

• List Vaults (GET vaults)

• Delete Vault (DELETE vault)

• Identity and Access Management in Amazon 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