

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

# Initiate Vault Lock (POST lock-policy)
<a name="api-InitiateVaultLock"></a>

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

Questa operazione avvia la procedura di blocco di vault effettuando le seguenti operazioni: 
+ Installazione di una policy di Vault Lock nel vault specificato.
+ Impostazione dello stato del blocco di vault su `InProgress`.
+ Restituzione dell'ID di blocco utilizzato per completare il processo di blocco di vault. 

Puoi impostare una policy di Vault Lock per vault, la cui dimensione non deve essere superiore a 20 KB. Per ulteriori informazioni sulle policy di blocco della vault, consulta [Policy di Vault Lock](vault-lock-policy.md).

Devi completare il processo di blocco di vault entro 24 ore dall'attivazione dello stato `InProgress` del blocco. Al termine delle 24 ore, l'ID del blocco scade, il vault passa automaticamente dallo stato `InProgress` a un altro stato e la policy di Vault Lock viene rimossa dal vault. Chiama [Complete Vault Lock (POST lockId)](api-CompleteVaultLock.md) per completare il processo di blocco di vault impostando lo stato del blocco di vault su `Locked`. 

**Nota**  
Quando lo stato di un blocco di vault è `Locked`, non puoi avviare un nuovo blocco di vault per il vault.

Puoi arrestare il processo di blocco della vault chiamando [Abort Vault Lock (DELETE lock-policy)](api-AbortVaultLock.md) e ottenere lo stato del blocco della vault chiamando [Get Vault Lock (GET lock-policy)](api-GetVaultLock.md). Per ulteriori informazioni sul processo di blocco della vault, consulta [Serratura Amazon Glacier Vault](vault-lock.md).

Se questa operazione viene chiamata quando lo stato del blocco di vault è `InProgress`, l'operazione restituisce un errore `AccessDeniedException`. Quando lo stato del blocco di vault è `InProgress`, devi dapprima chiamare [Abort Vault Lock (DELETE lock-policy)](api-AbortVaultLock.md) per poter avviare una nuova policy di Vault Lock. 

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

Per avviare un processo di blocco di vault, invia una richiesta HTTP `POST` all'URI della sottorisorsa `lock-policy` del vault, come illustrato nell'esempio di sintassi seguente.

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

```
 1. POST /AccountId/vaults/vaultName/lock-policy 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
 7. 			
 8. {
 9.   "Policy": "string"
10. }
```

 

**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-InitiateVaultLock-requests-parameters"></a>

Questa operazione non utilizza parametri richiesta.

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

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

 **Policy**   
La policy di Vault Lock in forma di stringa JSON, che utilizza "\$1" come carattere di escape.  
 Tipo: stringa   
 Campo obbligatorio: sì

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

Amazon Glacier (Amazon Glacier) restituisce `HTTP 201 Created` una risposta, se la politica viene accettata.

### Sintassi
<a name="api-InitiateVaultLock-response-syntax"></a>

```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-lock-id: lockId
```

### Intestazioni di risposta
<a name="api-InitiateVaultLock-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  | 
| --- | --- | 
|  x-amz-lock-id  |  L'ID di blocco utilizzato per completare il processo di blocco di vault.  ▬Tipo: stringa  | 

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

Questa operazione non restituisce un corpo della risposta.

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

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

L'esempio seguente invia una richiesta HTTP `PUT` all'URI della sottorisorsa `lock-policy` della vault. La stringa JSON `Policy` utilizza "\$1" come carattere di escape.

```
1. PUT /-/vaults/examplevault/lock-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
7. 
8. {"Policy":"{\"Version\":\"2012-10-17\",		 	 	 \"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}
```

### Risposta di esempio
<a name="api-InitiateVaultLock-example-response"></a>

Se la richiesta ha avuto esito positivo, Amazon Glacier restituisce `HTTP 201 Created` una risposta, come illustrato nell'esempio seguente.

```
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. x-amz-lock-id: AE863rKkWZU53SLW5be4DUcW
```

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

 
+ [Abort Vault Lock (DELETE lock-policy)](api-AbortVaultLock.md)

 
+ [Complete Vault Lock (POST lockId)](api-CompleteVaultLock.md)

 
+ [Get Vault Lock (GET lock-policy)](api-GetVaultLock.md)

## Vedi anche
<a name="api-InitiateVaultLock_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/initiate-vault-lock.html) 