

 **Questa pagina è riservata ai clienti esistenti del servizio Amazon Glacier che utilizzano Vaults e l'API REST originale del 2012.**

Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage Amazon Glacier in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Per ulteriori informazioni su queste opzioni di storage, consulta le classi di storage di [Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (servizio autonomo originale basato su vault) non accetta più nuovi clienti. Amazon Glacier è un servizio APIs autonomo che archivia i dati in vault ed è distinto dalle classi di storage Amazon S3 e Amazon S3 Glacier. I dati esistenti rimarranno sicuri e accessibili in Amazon Glacier a tempo indeterminato. Non è richiesta alcuna migrazione. Per uno storage di archiviazione a lungo termine a basso costo, AWS consiglia le classi di storage [Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), che offrono un'esperienza cliente superiore con disponibilità Regione AWS completa, costi inferiori e integrazione dei servizi APIs basata su bucket S3. AWS Se desideri funzionalità avanzate, prendi in considerazione la migrazione alle classi di storage Amazon S3 Glacier utilizzando la [AWS nostra Solutions Guidance per il trasferimento di dati dai vault Amazon Glacier alle classi di storage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

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

Questa operazione restituisce informazioni relative a un vault, tra cui l'ARN (Amazon Resource Name), la data di creazione, il numero di archivi che contiene e la dimensione totale di tutti quegli archivi. Il numero di archivi e la loro dimensione totale si riferiscono all'ultimo inventario del vault generato da Amazon Glacier (Amazon Glacier) (vedi). [Lavorare con Vaults in Amazon Glacier](working-with-vaults.md) Amazon Glacier genera inventari di vault all'incirca ogni giorno. Ciò significa che se aggiungi o rimuovi un archivio in un vault e quindi invii immediatamente una richiesta Describe Vault, è possibile che la risposta non rifletta le modifiche. 

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

Per ottenere informazioni su un vault, invia una richiesta `GET` all'URI della risorsa vault specifica.

### Sintassi
<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
```

 

**Nota**  
Il `AccountId` valore è l' Account AWS ID dell'account proprietario del vault. Puoi specificare un Account AWS ID o facoltativamente un singolo '`-`' (trattino), nel qual caso Amazon Glacier utilizza Account AWS l'ID associato alle credenziali utilizzate per firmare la richiesta. Se utilizzi un ID account, non includere alcun trattino ("-") nell'ID.

### Parametri della richiesta
<a name="api-vault-get-requests-parameters"></a>

Questa operazione non utilizza parametri richiesta.

### Intestazioni di richiesta
<a name="api-vault-get-requests-headers"></a>

Questa operazione utilizza solo le intestazioni richiesta che sono comuni a tutte le operazioni. Per informazioni sulle intestazioni richiesta comuni, consulta [Intestazioni di richiesta comuni](api-common-request-headers.md).

### Corpo della richiesta
<a name="api-vault-get-requests-elements"></a>

Questa operazione non ha un corpo della richiesta.

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

### Sintassi
<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
}
```

### Intestazioni di risposta
<a name="api-vault-get-responses-headers"></a>

Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta [Intestazioni di risposta comuni](api-common-response-headers.md).

### Corpo della risposta
<a name="api-vault-get-responses-elements"></a>

Il corpo della risposta contiene i campi JSON descritti di seguito.

**CreationDate**  
La data di creazione del vault in formato UTC.   
*Tipo*: una rappresentazione di stringa nel formato data ISO 8601, ad esempio `2013-03-20T17:03:43.221Z`.

**LastInventoryDate**  
La data UTC in cui Amazon Glacier ha completato l'ultimo inventario del vault. Per informazioni sulla generazione di un inventario per una vault, consulta [Initiate Job (POST jobs)](api-initiate-job-post.md).  
*Tipo*: una rappresentazione di stringa nel formato data ISO 8601, ad esempio `2013-03-20T17:03:43.221Z`.

**NumberOfArchives**  
Il numero di archivi nel vault alla data dell'ultimo inventario vault. Questo campo restituirà null se un inventario non è ancora stato generato per il vault, ad esempio, se hai appena creato il vault.  
*Tipo*: numero

**SizeInBytes**  
La dimensione totale in byte degli archivi nel vault, incluso l'overhead di ogni archivio, alla data dell'ultimo inventario. Questo campo restituirà `null` se un inventario non è ancora stato generato per il vault, ad esempio, se hai appena creato il vault.  
*Tipo*: numero

**VaultARN**  
L'ARN della vault.  
▬*Tipo:* stringa

**VaultName**  
Il nome di vault specificato al momento della creazione. Questo nome è incluso anche nell'ARN del vault.  
▬*Tipo:* stringa

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

Per informazioni sulle eccezioni e sui messaggi di errore di Amazon Glacier, consulta. [Risposte agli errori](api-error-responses.md)

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

### Richiesta di esempio
<a name="api-vault-get-example-request"></a>

L'esempio seguente mostra come ottenere informazioni sul vault denominato `examplevault`.

```
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
```

### Risposta di esempio
<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. }
```

## Sezioni correlate
<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 per Amazon Glacier](security-iam.md)

## Vedi anche
<a name="api-vault-get_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue SDKs Amazon specifiche per lingua, consulta quanto segue:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/describe-vault.html) 