Describe Vault (GET vault)

Beschreibung

Diese Operation gibt Informationen über einen Tresor zurück, einschließlich Tresor-ARN (Amazon-Ressourcenname), Datum der Erstellung, Anzahl der Archive im Tresor und Gesamtgröße aller Archive im Tresor. Die Anzahl der Archive und ihre Gesamtgröße entsprechen dem letzten von Amazon S3 Glacier (S3 Glacier) generierten Tresorinventar (sieheArbeiten mit Tresoren in Amazon S3 Glacier). S3 Glacier generiert ungefähr täglich Tresorbestände. Das bedeutet, dass wenn Sie ein Archiv zum Tresor hinzufügen oder aus ihm entfernen und dann sofort eine Anfrage zur Tresorbeschreibung senden, die Änderungen möglicherweise in der Antwort nicht reflektiert werden.

Anforderungen

Senden Sie eine GET-Anfrage an den URI der spezifischen Tresorressource, um Informationen über einen Tresor zu erhalten.

Syntax

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

Anmerkung

DerAccountId Wert ist dieAWS-Konto ID des Kontos, dem der Tresor gehört. 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 eine Konto-ID verwenden, fügen Sie keine Bindestriche ('-') in die ID ein.

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

Dieser Vorgang besitzt keinen Anforderungstext.

Antworten

Syntax

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
  "CreationDate" : String,
  "LastInventoryDate" : String,
  "NumberOfArchives" : Number,
  "SizeInBytes" : Number,
  "VaultARN" : String,
  "VaultName" : String
}

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.

Antworttext

Der Antworttext enthält die folgenden JSON-Felder.

CreationDate

Das UTC-Datum, zu dem der Tresor erstellt wurde.

Typ: Eine Zeichenkettendarstellung im ISO 8601-Datumsformat, zum Beispiel2013-03-20T17:03:43.221Z.

LastInventoryDate

Das UTC-Datum, an dem S3 Glacier die letzte Tresorinventur abgeschlossen hat. Informationen zum Initiieren einer Inventur für einen Tresor finden Sie unter Initiate Job (POST jobs).

Typ: Eine Zeichenkettendarstellung im ISO 8601-Datumsformat, zum Beispiel2013-03-20T17:03:43.221Z.

NumberOfArchives

Die Anzahl der Archive im Tresor gemäß der letzten Tresorinventur. Dieses Feld wird Null zurückgeben, wenn noch keine Inventur auf dem Tresor ausgeführt wurde, zum Beispiel, wenn Sie den Tresor gerade erst erstellt haben.

Typ: Zahl

SizeInBytes

Die Gesamtgröße in Bytes der Archive im Tresor, einschließlich jedes Overheads pro Archiv, am Datum der letzten Inventur. Dieses Feld wird null zurückgeben, wenn noch keine Inventur auf dem Tresor ausgeführt wurde, zum Beispiel, wenn Sie den Tresor gerade erst erstellt haben.

Typ: Zahl

VaultARN

Der Amazon-Ressourcenname (ARN) des Tresors.

Typ: Zeichenfolge

VaultName

Der Tresorname, der zum Zeitpunkt der Erstellung angegeben wurde. Der Tresorname ist auch in der ARN des Tresors enthalten.

Typ: Zeichenfolge

Fehler

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

Beispiele

Beispielanfrage

Das folgende Beispiel zeigt, wie Sie Informationen über den Tresor namens examplevault erhalten.

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

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Content-Type: application/json
Content-Length: 260

{
  "CreationDate" : "2012-02-20T17:01:45.198Z",
  "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
  "NumberOfArchives" : 192,
  "SizeInBytes" : 78088912,
  "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
  "VaultName" : "examplevault"
}

Zugehörige Abschnitte

• Create Vault (PUT vault)

• List Vaults (GET vaults)

• Delete Vault (DELETE vault)

• Initiate Job (POST jobs)

• 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