Initiate Vault Lock (POST lock-policy) - Amazon S3 Glacier

Questa pagina è riservata ai clienti esistenti del servizio S3 Glacier che utilizzano Vaults e l'originale del 2012. REST API

Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage S3 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 S3 Glacier e lo storage dei dati a lungo termine con le classi di storage S3 Glacier nella Amazon S3 User Guide. Queste classi di storage utilizzano Amazon S3API, sono disponibili in tutte le regioni e possono essere gestite all'interno della console Amazon S3. Offrono funzionalità come Storage Cost Analysis, Storage Lens, funzionalità di crittografia opzionali avanzate e altro ancora.

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 Vault Lock, 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 del vault chiamando Abort Vault Lock (DELETE lock-policy) e ottenere lo stato del blocco del vault chiamando Get Vault Lock (GET lock-policy). Per ulteriori informazioni sul processo di blocco del vault, consulta Vault Lock di S3 Glacier.

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: Date Authorization: SignatureValue Content-Length: Length x-amz-glacier-version: 2012-06-01 { "Policy": "string" }

Nota

Il valore di AccountId è l'ID dell'Account AWS. Questo valore deve corrispondere all'ID dell'Account AWS associato alle credenziali utilizzate per firmare la richiesta. Puoi specificare l'ID dell'Account AWS o eventualmente un "-" (trattino), nel qual caso Amazon S3 Glacier utilizza l'ID dell'Account AWS 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: string

Campo obbligatorio: sì

Risposte

Amazon S3 Glacier (S3 Glacier) restituisce una risposta HTTP 201 Created, se la policy 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: string

Corpo della risposta

Questa operazione non restituisce un corpo della risposta.

Errori

Per informazioni sulle eccezioni e i messaggi di errore di Amazon S3 Glacier, consulta Risposte agli errori.

Esempi

Richiesta di esempio

L'esempio seguente invia una richiesta HTTP PUT all'URI della sottorisorsa lock-policy del 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 esito positivo, S3 Glacier restituisce una risposta HTTP 201 Created, come mostrato 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

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli Amazon SDK specifici del linguaggio, consulta quanto segue: