**Diese Seite ist nur für Bestandskunden des Amazon Glacier-Service bestimmt, die Vaults und die ursprüngliche REST-API von 2012 verwenden.** Wenn Sie nach Archivspeicherlösungen suchen, empfehlen wir die Verwendung der Amazon 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 [Amazon Glacier-Speicherklassen](https://aws.amazon.com/s3/storage-classes/glacier/). Amazon Glacier (ursprünglicher eigenständiger, auf Tresor basierender Service) akzeptiert keine Neukunden mehr. Amazon Glacier ist ein eigenständiger Service APIs , der Daten in Tresoren speichert und sich von den Speicherklassen Amazon S3 und Amazon S3 Glacier unterscheidet. Ihre vorhandenen Daten bleiben in Amazon Glacier auf unbestimmte Zeit sicher und zugänglich. Es ist keine Migration erforderlich. Für kostengünstige, langfristige Archivierungsspeicherung AWS empfiehlt sich die [Amazon S3 Glacier-Speicherklasse](https://aws.amazon.com/s3/storage-classes/glacier/), die mit S3-Bucket-Basis, voller AWS-Region Verfügbarkeit APIs, geringeren Kosten und AWS Serviceintegration ein hervorragendes Kundenerlebnis bieten. Wenn Sie erweiterte Funktionen wünschen, sollten Sie eine Migration zu Amazon S3 Glacier-Speicherklassen in Betracht ziehen, indem Sie unseren [AWS Lösungsleitfaden für die Übertragung von Daten aus Amazon Glacier-Tresoren in Amazon S3 Glacier-Speicherklassen](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/) verwenden. 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`. In Ihrer nächsten List Vaults-Anfrage setzen Sie den `marker` Parameter auf den Wert, den Amazon Glacier (Amazon Glacier) in den Antworten auf Ihre vorherige List Vaults-Anfrage 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 ``` 1. GET /AccountId/vaults HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. 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 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 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 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](api-common-request-headers.md). ### 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](api-common-response-headers.md). ### 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)](api-initiate-job-post.md). *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 Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unter[Fehlermeldungen](api-error-responses.md). ## 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 ``` 1. GET /-/vaults HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: 497 6. 7. { 8. "Marker": null, 9. "VaultList": [ 10. { 11. "CreationDate": "2012-03-16T22:22:47.214Z", 12. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 13. "NumberOfArchives": 2, 14. "SizeInBytes": 12334, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1", 16. "VaultName": "examplevault1" 17. }, 18. { 19. "CreationDate": "2012-03-19T22:06:51.218Z", 20. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 21. "NumberOfArchives": 0, 22. "SizeInBytes": 0, 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2", 24. "VaultName": "examplevault2" 25. }, 26. { 27. "CreationDate": "2012-03-19T22:06:51.218Z", 28. "LastInventoryDate": "2012-03-25T12:14:31.121Z", 29. "NumberOfArchives": 0, 30. "SizeInBytes": 0, 31. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3", 32. "VaultName": "examplevault3" 33. } 34. ] 35. } ``` ### Beispiel: Teilweise Liste von Tresoren Das folgende Beispiel gibt zwei Tresore zurück, beginnend mit dem vom `marker` angegebenen Tresor. #### Beispielanfrage ``` 1. GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: 497 6. 7. { 8. "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3", 9. "VaultList": [ 10. { 11. "CreationDate": "2012-03-16T22:22:47.214Z", 12. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 13. "NumberOfArchives": 2, 14. "SizeInBytes": 12334, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1", 16. "VaultName": "examplevault1" 17. }, 18. { 19. "CreationDate": "2012-03-19T22:06:51.218Z", 20. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 21. "NumberOfArchives": 0, 22. "SizeInBytes": 0, 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2", 24. "VaultName": "examplevault2" 25. } 26. ] 27. } ``` ## Zugehörige Abschnitte + [Create Vault (PUT vault)](api-vault-put.md) + [Delete Vault (DELETE vault)](api-vault-delete.md) + [Initiate Job (POST jobs)](api-initiate-job-post.md) + [Identity and Access Management für Amazon Glacier](security-iam.md) ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen Amazon SDKs finden Sie im Folgenden: + [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/list-vaults.html)