

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

# Get Vault Lock (GET lock-policy)
<a name="api-GetVaultLock"></a>

## Description
<a name="api-GetVaultLock-description"></a>

Questa operazione consente di recuperare i seguenti attributi dalla sottorisorsa `lock-policy` impostata nel vault specificato: 
+ La policy di Vault Lock impostata nel vault.
+ Lo stato del blocco di vault, ovvero `InProgess` o `Locked`.
+ La scadenza dell'ID del blocco. L'ID di blocco è utilizzato per completare il processo di blocco di vault.
+ Quando il blocco di vault è stato avviato ed è passato allo stato `InProgress`.

Lo stato `InProgress` di un blocco della vault viene attivato chiamando [Initiate Vault Lock (POST lock-policy)](api-InitiateVaultLock.md). Lo stato `Locked` di un blocco della vault viene attivato chiamando [Complete Vault Lock (POST lockId)](api-CompleteVaultLock.md). Puoi arrestare il processo di blocco della vault chiamando [Abort Vault Lock (DELETE lock-policy)](api-AbortVaultLock.md) Per ulteriori informazioni sul processo di blocco della vault, consulta [Serratura Amazon Glacier Vault](vault-lock.md).

Se nessuna policy di Vault Lock è impostata nel vault, l'operazione restituisce un errore `404 Not found`. Per ulteriori informazioni sulle policy di blocco della vault, consulta [Policy di Vault Lock](vault-lock-policy.md).

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

Per restituire la policy di Vault Lock corrente e altri attributi, invia una richiesta HTTP `GET` all'URI della sottorisorsa `lock-policy` del vault come illustrato nell'esempio di sintassi seguente.

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

```
1. GET /AccountId/vaults/vaultName/lock-policy 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-GetVaultLock-requests-parameters"></a>

Questa operazione non utilizza parametri richiesta.

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

Questa operazione non ha un corpo della richiesta.

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

In risposta, Amazon Glacier (Amazon Glacier) restituisce la policy di accesso al vault in formato JSON nel corpo della risposta. 

### Sintassi
<a name="api-GetVaultLock-responses-syntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
				
{
  "Policy": "string",
  "State": "string",
  "ExpirationDate": "string",
  "CreationDate":"string"
}
```

### Intestazioni di risposta
<a name="api-GetVaultLock-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-GetVaultLock-responses-elements"></a>

Il corpo della risposta 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: String

 **Stato**   
Lo stato del blocco di vault.  
 Tipo: String  
 Valori validi: `InProgress``|Locked`

 **ExpirationDate**   
La data e l'ora di scadenza (in formato UTC) dell'ID del blocco. Questo valore può essere `null` se lo stato del blocco di vault è `Locked`.  
*Tipo*: una rappresentazione di stringa nel formato data ISO 8601, ad esempio `2013-03-20T17:03:43.221Z`.

 **CreationDate**   
La data e l'ora (in formato UTC) del passaggio del blocco di vault allo stato `InProgress`.  
*Tipo*: una rappresentazione di stringa nel formato data ISO 8601, ad esempio `2013-03-20T17:03:43.221Z`.

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

L'esempio seguente mostra come ottenere una policy di Vault Lock.

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

In questo esempio, una richiesta `GET` è inviata all'URI di una sottorisorsa `lock-policy` della vault.

```
1. GET /-/vaults/examplevault/lock-policy 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
```

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

Se la richiesta ha avuto esito positivo, Amazon Glacier restituisce la policy di accesso al vault come stringa JSON nel corpo della risposta. La stringa JSON restituita utilizza "\$1" come carattere di escape, come illustrato nella richiesta di esempio [Initiate Vault Lock (POST lock-policy)](api-InitiateVaultLock.md). Nell'esempio seguente la stringa JSON è invece restituita senza caratteri escape per una migliore leggibilità. 

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: length
 6. 
 7. {
 8.   "Policy": "
 9.     {
10.       "Version": "2012-10-17",		 	 	 
11.       "Statement": [
12.         {
13.           "Sid": "Define-vault-lock",
14.           "Principal": {
15.             "AWS": "arn:aws:iam::999999999999:root"
16.           },
17.           "Effect": "Deny",
18.           "Action": "glacier:DeleteArchive",
19.           "Resource": [
20.             "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
21.           ],
22.           "Condition": {
23.             "NumericLessThanEquals": {
24.               "glacier:ArchiveAgeInDays": "365"
25.             }
26.           }
27.         }
28.       ]
29.     }
30.   ",
31.   "State": "InProgress",
32.   "ExpirationDate": "exampledate",
33.   "CreationDate": "exampledate"  
34. }
```

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

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

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

 
+ [Initiate Vault Lock (POST lock-policy)](api-InitiateVaultLock.md)

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