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

# Create Vault (PUT vault)
<a name="api-vault-put"></a>

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

Questa operazione crea un nuovo vault con il nome specificato.  Il nome del vault deve essere univoco all'interno di una AWS regione per un Account AWS. È possibile creare fino a 1.000 vault per account. Per informazioni sulla creazione di altri vault, consulta la pagina dei dettagli del [prodotto Amazon Glacier](https://aws.amazon.com/glacier).

Quando assegni un nome a un vault, devi considerare quanto segue. 

 
+  I nomi possono contenere un numero di caratteri compreso tra 1 e 255. 
+ I caratteri validi sono a-z, , A-Z0-9, "\$1" (trattino basso), "-" (trattino) e "." (punto).

Questa operazione è idempotente, puoi inviare la stessa richiesta più volte e non ha ulteriori effetti dopo la prima volta che Amazon Glacier (Amazon Glacier) crea il vault specificato.

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

### Sintassi
<a name="api-vault-put-requests-syntax"></a>

Per creare un vault, invia una richiesta HTTP PUT all'URI del vault da creare.

```
1. PUT /AccountId/vaults/VaultName HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
```

 

**Nota**  
Il valore è l'ID. `AccountId` Account AWS Questo valore deve corrispondere all' Account AWS ID associato alle credenziali utilizzate per firmare la richiesta. 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 specifichi l'ID del tuo account, non devi includere trattini ("-") nell'ID.

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

Questa operazione non utilizza parametri richiesta.

### Intestazioni di richiesta
<a name="api-vault-put-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-put-requests-elements"></a>

Per questa operazione, il corpo della richiesta deve essere vuoto (0 byte).

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

### Sintassi
<a name="api-vault-putresponse-syntax"></a>

```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
```

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

Una risposta corretta include le seguenti intestazioni di risposta, oltre alle intestazioni di risposta comuni a tutte le operazioni. Per informazioni sulle intestazioni di risposta comuni, consulta [Intestazioni di risposta comuni](api-common-response-headers.md).


|  Nome  |  Descrizione | 
| --- | --- | 
| `Location`  | Il percorso URI relativo del vault che è stato creato. ▬Tipo: stringa | 

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

Questa operazione non restituisce un corpo della risposta.

### Errori
<a name="api-vault-put-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-put-examples"></a>

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

L'esempio seguente invia una richiesta HTTP PUT per creare un vault denominato `examplevault`. 

```
1. PUT /-/vaults/examplevault 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. Content-Length: 0
6. 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-put-example-response"></a>

Amazon Glacier crea il vault e ne restituisce il percorso URI relativo nell'intestazione. `Location` L'ID account è sempre visualizzato nell'intestazione `Location` indipendentemente da quanto specificato nella richiesta, ovvero l'ID account o un trattino ('`-`').

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. Location: /111122223333/vaults/examplevault
```

## Sezioni correlate
<a name="related-sections-vault-put"></a>

 
+ [List Vaults (GET vaults)](api-vaults-get.md)
+ [Delete Vault (DELETE vault)](api-vault-delete.md)
+ [Identity and Access Management per Amazon Glacier](security-iam.md)

## Vedi anche
<a name="vault-put-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/create-vault.html)