

 **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.

# Describe Vault (GET vault)
<a name="api-vault-get"></a>

## Beschreibung
<a name="api-vault-get-description"></a>

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 zuletzt von Amazon Glacier (Amazon Glacier) generierten Tresorinventar (siehe[Arbeiten mit Tresoren in Amazon Glacier](working-with-vaults.md)). Amazon Glacier generiert etwa 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
<a name="api-vault-get-requests"></a>

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

### Syntax
<a name="api-vault-get-requests-syntax"></a>

```
1. GET /AccountId/vaults/VaultName 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 des Kontos, dem der Tresor gehört. 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 eine Konto-ID verwenden, darf die ID keine Bindestriche („-“) enthalten.

### Anforderungsparameter
<a name="api-vault-get-requests-parameters"></a>

Dieser Vorgang verwendet keine Anforderungsparameter.

### Anforderungsheader
<a name="api-vault-get-requests-headers"></a>

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
<a name="api-vault-get-requests-elements"></a>

Dieser Vorgang besitzt keinen Anforderungstext.

## Antworten
<a name="api-vault-get-responses"></a>

### Syntax
<a name="api-vault-get-responses-syntax"></a>

```
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
<a name="api-vault-get-responses-headers"></a>

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
<a name="api-vault-get-responses-elements"></a>

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, z. B. `2013-03-20T17:03:43.221Z`.

**LastInventoryDate**  
Das UTC-Datum, an dem Amazon Glacier die letzte Tresorinventur abgeschlossen hat. 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`.

**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
<a name="api-vault-get-responses-errors"></a>

Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unter[Fehlermeldungen](api-error-responses.md).

## Beispiele
<a name="api-vault-get-examples"></a>

### Beispielanfrage
<a name="api-vault-get-example-request"></a>

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
<a name="api-vault-get-example-response"></a>

```
 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: 260
 6. 
 7. {
 8.   "CreationDate" : "2012-02-20T17:01:45.198Z",
 9.   "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
10.   "NumberOfArchives" : 192,
11.   "SizeInBytes" : 78088912,
12.   "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
13.   "VaultName" : "examplevault"
14. }
```

## Zugehörige Abschnitte
<a name="related-sections-vault-get"></a>

 
+ [Create Vault (PUT vault)](api-vault-put.md)
+ [List Vaults (GET vaults)](api-vaults-get.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:
<a name="api-vault-get_SeeAlso"></a>

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/describe-vault.html) 