List Vaults (GET vaults) - Amazon S3 Glacier
BeschreibungAnforderungenAntwortenBeispieleZugehörige AbschnitteWeitere Informationen finden Sie unter:

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 und Speicherklassen für die Archivierung von Objekten im Amazon S3 S3-Benutzerhandbuch.

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.

List Vaults (GET vaults)

Beschreibung

Diese Operation listet alle Tresore auf, die das Konto des aufrufenden Benutzers besitzt. Die zurückgegebene Liste ist ASCII-sortiert nach Tresorname.

Standardmäßig gibt diese Operation bis zu 10 Elemente pro Anfrage zurück. Wenn mehr aufzulistende Tresore vorhanden sind, enthält das Feld marker im Antworttext den Amazon-Ressourcennamen (ARN) des Tresors, bei dem die Liste mit einer neuen List Vaults-Anfrage fortzusetzen ist, andernfalls hat das Feld marker den Wert null. Legen Sie in Ihrer nächsten „List Vaults“-Anforderung den Parameter marker auf den Wert fest, den Amazon S3 Glacier (S3 Glacier) in den Antworten auf Ihre vorherige „List Vaults“-Anforderung zurückgegeben hat. Sie können die in der Antwort zurückgegebene Anzahl der Tresore auch begrenzen, indem Sie in der Anfrage den Parameter limit angeben.

Anforderungen

Um eine Liste der Tresore abzurufen, senden Sie eine GET-Anfrage an die Ressource Tresore.

Syntax

GET /AccountId/vaults HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-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

Diese Operation verwendet die folgenden Anforderungsparameter.

Name Beschreibung Erforderlich
limit

Die maximale Anzahl der zurückzugebenden Tresore. Das Standardlimit ist 10. Die Anzahl der zurückgegebenen Tresore kann kleiner sein als das festgelegte Limit, aber die Anzahl der zurückgegebenen Tresore überschreitet das Limit nie.

Typ: Zeichenfolge

Beschränkungen: Mindestganzzahlwert 1. Höchstganzzahlwert 10.

 Nein
marker

Eine zur Paginierung verwendete Zeichenfolge. marker gibt den ARN des Tresors an, nach dem die Auflistung der Tresore beginnen soll. (Der von marker angegebene Tresor ist in der zurückgegebenen Liste nicht enthalten.) Rufen Sie den Wert für marker aus einer vorherigen List Vaults-Antwort ab. Sie müssen marker nur dann einschließen, wenn Sie die Paginierung der Ergebnisse fortsetzen, die in einer vorherigen List Vaults-Anfrage gestartet wurde. Die Angabe eines leeren Werts ("") für die Markierung gibt eine Liste von Tresoren zurück, die mit dem ersten Tresor beginnt.

Typ: Zeichenfolge

Einschränkungen: Keine

 Nein

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

{
  "Marker": String
  "VaultList": [ 
   {
    "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 Erstellungsdatum des Tresors, in UTC (Coordinated Universal Time).

Typ: Zeichenfolge. Eine Zeichenfolgendarstellung im ISO 8601-Datumsformat, zum Beispiel 2013-03-20T17:03:43.221Z.

LastInventoryDate

Das Datum der letzten Tresorinventur, in UTC (Coordinated Universal Time). Dieses Feld kann Null sein, wenn noch keine Inventur auf dem Tresor ausgeführt wurde, zum Beispiel, wenn Sie den Tresor gerade erst erstellt haben. Informationen zum Initiieren einer Inventur für einen Tresor finden Sie unter Initiate Job (POST jobs).

Typ: Eine Zeichenfolgendarstellung im ISO 8601-Datumsformat, z. B. 2013-03-20T17:03:43.221Z.

Marker

Der vaultARN, der angibt, wo die Paginierung der Ergebnisse fortgesetzt werden soll. Mithilfe des marker in einer anderen List Vaults-Anfrage erhalten Sie mehr Tresore in der Liste. Wenn keine anderen Tresore vorhanden sind, ist dieser Wert null.

Typ: Zeichenfolge

NumberOfArchives

Die Anzahl der Archive im Tresor am Datum der letzten Inventur.

Typ: Zahl

SizeInBytes

Die Gesamtgröße, in Bytes, aller Archive im Tresor, einschließlich jedes Overheads pro Archiv, am Datum der letzten Inventur.

Typ: Zahl

VaultARN

Der Amazon-Ressourcenname (ARN) des Tresors.

Typ: Zeichenfolge

VaultList

Ein Array von Objekten, von dem jedes Objekt eine Beschreibung eines Tresors bereitstellt.

Typ: Array

VaultName

Der Name des Tresors.

Typ: Zeichenfolge

Fehler

Weitere Informationen über Ausnahmen und Fehlermeldungen in Amazon S3 Glacier finden Sie unter Fehlermeldungen.

Beispiele

Beispiel: Alle Tresore auflisten

Das folgende Beispiel listet Tresore auf. Da die Parameter marker und limit in der Anfrage nicht angegeben sind, werden bis zu 10 Tresore zurückgegeben.

Beispielanfrage

GET /-/vaults 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

Der Marker ist null und zeigt damit an, dass keine aufzulistenden Tresore mehr vorhanden sind.

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: 497	

{
  "Marker": null,
  "VaultList": [ 
   {
    "CreationDate": "2012-03-16T22:22:47.214Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 2,
    "SizeInBytes": 12334,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
    "VaultName": "examplevault1"
   }, 
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
    "VaultName": "examplevault2"
   },
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-25T12:14:31.121Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
    "VaultName": "examplevault3"
   } 
  ]
}

Beispiel: Teilweise Liste von Tresoren

Das folgende Beispiel gibt zwei Tresore zurück, beginnend mit dem vom marker angegebenen Tresor.

Beispielanfrage

GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 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

Zwei Tresore werden in der Liste zurückgegeben. Der Marker enthält den ARN des Tresors, mit dem die Paginierung in einer weiteren List Vaults-Anfrage fortgesetzt wird.

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: 497	

{
  "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
  "VaultList": [ 
   {
    "CreationDate": "2012-03-16T22:22:47.214Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 2,
    "SizeInBytes": 12334,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
    "VaultName": "examplevault1"
   }, 
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
    "VaultName": "examplevault2"
   }
  ]
}

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen Amazon-SDKs finden Sie unter: