**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à. # Set Data Retrieval Policy (PUT policy) ## Descrizione Questa operazione imposta e quindi implementa una politica di recupero dei dati nella regione specificata nella AWS richiesta. `PUT` È possibile impostare una politica per AWS regione per un. Account AWS La policy viene implementata alcuni minuti dopo un'operazione `PUT` riuscita. L'operazione di impostazione di policy non ha effetto sui processi di recupero in corso prima dell'implementazione della policy. Per ulteriori informazioni sulle policy di recupero dati, consulta [Politiche di recupero dei dati di Amazon Glacier](data-retrieval-policy.md). ## Richieste ### Sintassi Per impostare una policy di recupero dati, invia una richiesta HTTP PUT all'URI della policy di recupero dati come illustrato nell'esempio di sintassi seguente. ``` 1. PUT /AccountId/policies/data-retrieval 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": 10. { 11. "Rules":[ 12. { 13. "Strategy": String, 14. "BytesPerHour": Number 15. } 16. ] 17. } 18. } ``` **Nota** Il `AccountId` valore è l' Account AWS ID. 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 Questa operazione non utilizza parametri richiesta. ### Intestazioni di richiesta 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 Il corpo della richiesta contiene i campi JSON descritti di seguito. **BytesPerHour** Il numero massimo di byte che possono essere recuperati in un'ora. Questo campo è obbligatorio solo se il valore del campo Strategy è `BytesPerHour`. L'operazione PUT verrà rifiutata se il campo Strategy non è impostato su `BytesPerHour` e imposti questo campo. *Tipo*: numero *Obbligatorio*: sì, se il campo Strategy è impostato su `BytesPerHour`. In caso contrario, no. *Valori validi*: il valore intero minimo 1. Il valore intero massimo è compreso tra 2^63 e 1 (inclusi). **Regole** La regola di policy. Sebbene si tratti di un tipo di elenco, attualmente deve esistere una sola regola, che contiene un campo Strategia e facoltativamente un campo. BytesPerHour *Tipo*: matrice *Campo obbligatorio*: sì **Strategia** Il tipo di policy di recupero dati da impostare. ▬*Tipo:* stringa *Campo obbligatorio*: sì 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). ## Risposte ### Sintassi ``` HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date ``` ### Intestazioni di risposta 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 Questa operazione non restituisce un corpo della risposta. ### Errori Per informazioni sulle eccezioni e sui messaggi di errore di Amazon Glacier, consulta. [Risposte agli errori](api-error-responses.md) ## Esempi ### Richiesta di esempio L'esempio seguente invia una richiesta HTTP PUT con il campo Strategy impostato su `BytesPerHour`. ``` 1. PUT /-/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 6. 7. { 8. "Policy": 9. { 10. "Rules":[ 11. { 12. "Strategy":"BytesPerHour", 13. "BytesPerHour":10737418240 14. } 15. ] 16. } 17. } ``` L'esempio seguente invia una richiesta HTTP PUT con il campo Strategy impostato su `FreeTier`. ``` 1. PUT /-/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 6. 7. { 8. "Policy": 9. { 10. "Rules":[ 11. { 12. "Strategy":"FreeTier" 13. } 14. ] 15. } 16. } ``` L'esempio seguente invia una richiesta HTTP PUT con il campo Strategy impostato su `None`. ``` 1. PUT /-/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 6. 7. { 8. "Policy": 9. { 10. "Rules":[ 11. { 12. "Strategy":"None" 13. } 14. ] 15. } 16. } ``` ### Risposta di esempio Se la richiesta ha avuto esito positivo, Amazon Glacier (Amazon Glacier) imposta la politica e restituisce `HTTP 204 No Content` un come mostrato nell'esempio seguente. ``` 1. HTTP/1.1 204 No Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT ``` ## Sezioni correlate + [Get Data Retrieval Policy (GET policy)](api-GetDataRetrievalPolicy.md) + [Initiate Job (POST jobs)](api-initiate-job-post.md)