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à.
Initiate Vault Lock (POST lock-policy)
Descrizione
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.
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) 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) e ottenere lo stato del blocco della vault chiamando Get Vault Lock (GET lock-policy). Per ulteriori informazioni sul processo di blocco della vault, consulta Serratura Amazon Glacier Vault.
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) per poter avviare una nuova policy di Vault Lock.
Richieste
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
POST /AccountId/vaults/vaultName/lock-policy HTTP/1.1 Host: glacier.Region.amazonaws.com Date:DateAuthorization:SignatureValueContent-Length:Lengthx-amz-glacier-version: 2012-06-01 { "Policy": "string" }
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
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.
- Policy
-
La policy di Vault Lock in forma di stringa JSON, che utilizza "\" come carattere di escape.
Tipo: stringa
Campo obbligatorio: sì
Risposte
Amazon Glacier (Amazon Glacier) restituisce HTTP 201 Created una risposta, se la politica viene accettata.
Sintassi
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-lock-id: lockId
Intestazioni di risposta
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.
| Nome | Descrizione |
|---|---|
x-amz-lock-id
|
L'ID di blocco utilizzato per completare il processo di blocco di vault. ▬Tipo: stringa |
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 all'URI della sottorisorsa lock-policy della vault. La stringa JSON Policy utilizza "\" come carattere di escape.
PUT /-/vaults/examplevault/lock-policy HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 Content-Length: length x-amz-glacier-version: 2012-06-01 {"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
Se la richiesta ha avuto esito positivo, Amazon Glacier restituisce HTTP 201 Created una risposta, come illustrato nell'esempio seguente.
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT x-amz-lock-id: AE863rKkWZU53SLW5be4DUcW
Sezioni correlate
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue SDKs Amazon specifiche per lingua, consulta quanto segue: