**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 Data Retrieval Policy (GET policy)
<a name="api-GetDataRetrievalPolicy"></a>

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

Questa operazione restituisce la politica corrente di recupero dei dati per la AWS regione Account AWS e specificata nella richiesta. `GET` Per ulteriori informazioni sulle policy di recupero dati, consulta [Politiche di recupero dei dati di Amazon Glacier](data-retrieval-policy.md).

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

Per restituire la policy di recupero dati corrente, invia una richiesta HTTP `GET` all'URI della policy di recupero dati come illustrato nell'esempio di sintassi seguente.

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

```
1. GET /AccountId/policies/data-retrieval 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'ID. 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-GetDataRetrievalPolicy-requests-parameters"></a>

Questa operazione non utilizza parametri richiesta.

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

Questa operazione non ha un corpo della richiesta.

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

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
  "Policy":
    {
      "Rules":[
         {
            "BytesPerHour": Number,
            "Strategy": String	 
         }
       ]
    }
}
```

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

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

 

**BytesPerHour**  
Il numero massimo di byte che possono essere recuperati in un'ora.  
Questo campo è disponibile solo se il valore del campo **Strategy** è `BytesPerHour`.   
*Tipo*: numero

**Regole**  
La regola di policy. Sebbene si tratti di un tipo di elenco, attualmente esiste una sola regola, che contiene un campo Strategia e facoltativamente un campo. BytesPerHour   
*Tipo*: matrice

**Strategia**  
Il tipo di policy di recupero dati.  
▬*Tipo:* stringa  
Valori validi: `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour` equivale alla selezione di **Max Retrieval Rate (Tasso di recupero massimo)** nella console. `FreeTier` equivale alla selezione di **Free Tier Only (Solo piano gratuito)** nella console. `None` equivale alla selezione di **No Retrieval Policy (Nessuna policy di recupero)** nella console. Per ulteriori informazioni sulla selezione di policy di recupero dati nella console, consulta [Politiche di recupero dei dati di Amazon Glacier](data-retrieval-policy.md).

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

L'esempio seguente mostra come ottenere una policy di recupero dati.

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

In questo esempio, una richiesta `GET` è inviata all'URI della posizione di una policy.

```
1. GET /-/policies/data-retrieval 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-GetDataRetrievalPolicy-example-response"></a>

In una risposta corretta la policy di recupero dati è visualizzata nel corpo della risposta in formato JSON. 

```
 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: 85
 6.  
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.            "BytesPerHour":10737418240,
13.            "Strategy":"BytesPerHour"
14.           }
15.        ]
16.     }
17. }
```

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

 
+ [Set Data Retrieval Policy (PUT policy)](api-SetDataRetrievalPolicy.md)

 
+ [Initiate Job (POST jobs)](api-initiate-job-post.md)