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
Amazon Glacier (servizio autonomo originale basato su vault) non accetterà più nuovi clienti a partire dal 15 dicembre 2025, senza alcun impatto sui clienti esistenti. 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
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.
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.
PUT /AccountId/policies/data-retrieval HTTP/1.1 Host: glacier.Region.amazonaws.com Date:DateAuthorization:SignatureValueContent-Length:Lengthx-amz-glacier-version: 2012-06-01 { "Policy": { "Rules":[ { "Strategy": String, "BytesPerHour": Number } ] } }
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.
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 suBytesPerHoure 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|FreeTier|None.BytesPerHourequivale alla selezione di Max Retrieval Rate (Tasso di recupero massimo) nella console.FreeTierequivale alla selezione di Free Tier Only (Solo piano gratuito) nella console.Noneequivale 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.
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.
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
Esempi
Richiesta di esempio
L'esempio seguente invia una richiesta HTTP PUT con il campo Strategy impostato su BytesPerHour.
PUT /-/policies/data-retrieval HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 { "Policy": { "Rules":[ { "Strategy":"BytesPerHour", "BytesPerHour":10737418240 } ] } }
L'esempio seguente invia una richiesta HTTP PUT con il campo Strategy impostato su FreeTier.
PUT /-/policies/data-retrieval HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 { "Policy": { "Rules":[ { "Strategy":"FreeTier" } ] } }
L'esempio seguente invia una richiesta HTTP PUT con il campo Strategy impostato su None.
PUT /-/policies/data-retrieval HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 { "Policy": { "Rules":[ { "Strategy":"None" } ] } }
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.
HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT
Sezioni correlate