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
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 Vault Lock (GET lock-policy)
Descrizione
Questa operazione consente di recuperare i seguenti attributi dalla sottorisorsa lock-policy
impostata nel vault specificato:
-
La policy di Vault Lock impostata nel vault.
-
Lo stato del blocco di vault, ovvero
InProgess
oLocked
. -
La scadenza dell'ID del blocco. L'ID di blocco è utilizzato per completare il processo di blocco di vault.
-
Quando il blocco di vault è stato avviato ed è passato allo stato
InProgress
.
Lo stato InProgress
di un blocco del vault viene attivato chiamando Initiate Vault Lock (POST lock-policy). Lo stato Locked
di un blocco del vault viene attivato chiamando Complete Vault Lock (POST lockId). Puoi arrestare il processo di blocco del vault chiamando Abort Vault Lock (DELETE lock-policy) Per ulteriori informazioni sul processo di blocco del vault, consulta Vault Lock di S3 Glacier.
Se nessuna policy di Vault Lock è impostata nel vault, l'operazione restituisce un errore 404
Not found
. Per ulteriori informazioni sulle policy di Vault Lock, consulta Policy di Vault Lock.
Richieste
Per restituire la policy di Vault Lock corrente e altri attributi, invia una richiesta HTTP GET
all'URI della sottorisorsa lock-policy
del vault come illustrato nell'esempio di sintassi seguente.
Sintassi
GET /
AccountId
/vaults/vaultName
/lock-policy HTTP/1.1 Host: glacier.Region
.amazonaws.com Date:Date
Authorization:SignatureValue
x-amz-glacier-version: 2012-06-01
Nota
Il valore AccountId
è l'ID dell'Account AWS dell'account proprietario del vault. 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 utilizzi un ID account, non includere alcun trattino ("-") 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
Questa operazione non ha un corpo della richiesta.
Risposte
In risposta, Amazon S3 Glacier (S3 Glacier) restituisce la policy di accesso a vault in formato JSON nel corpo della risposta.
Sintassi
HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: length { "Policy": "string", "State": "string", "ExpirationDate": "string", "CreationDate":"string" }
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
Il corpo della risposta 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
- Stato
-
Lo stato del blocco di vault.
Tipo: string
Valori validi:
InProgress
|
Locked
- ExpirationDate
-
La data e l'ora di scadenza (in formato UTC) dell'ID del blocco. Questo valore può essere
null
se lo stato del blocco di vault èLocked
.Tipo: una rappresentazione di stringa nel formato data ISO 8601, ad esempio
2013-03-20T17:03:43.221Z
. - CreationDate
-
La data e l'ora (in formato UTC) del passaggio del blocco di vault allo stato
InProgress
.Tipo: una rappresentazione di stringa nel formato data ISO 8601, ad esempio
2013-03-20T17:03:43.221Z
.
Errori
Per informazioni sulle eccezioni e i messaggi di errore di Amazon S3 Glacier, consulta Risposte agli errori.
Esempi
L'esempio seguente mostra come ottenere una policy di Vault Lock.
Richiesta di esempio
In questo esempio, una richiesta GET
è inviata all'URI di una sottorisorsa lock-policy
del vault.
GET /-/vaults/examplevault/lock-policy 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
Risposta di esempio
Se la richiesta ha esito positivo, S3 Glacier restituisce la policy di accesso a vault in forma di stringa JSON nel corpo della risposta. La stringa JSON restituita utilizza "\" come carattere di escape, come illustrato nella richiesta di esempio Initiate Vault Lock (POST lock-policy). Nell'esempio seguente la stringa JSON è invece restituita senza caratteri escape per una migliore leggibilità.
HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Type: application/json Content-Length: length { "Policy": " { "Version": "2012-10-17", "Statement": [ { "Sid": "Define-vault-lock", "Principal": { "AWS": "arn:aws:iam::999999999999:root" }, "Effect": "Deny", "Action": "glacier:DeleteArchive", "Resource": [ "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault" ], "Condition": { "NumericLessThanEquals": { "glacier:ArchiveAgeInDays": "365" } } } ] } ", "State": "InProgress", "ExpirationDate": "exampledate", "CreationDate": "exampledate" }
Sezioni correlate
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli Amazon SDK specifici del linguaggio, consulta quanto segue: