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à.
List Tags For Vault (GET tags)
Questa operazione elenca tutti i tag associati a un vault. L'operazione restituisce una mappa vuota se non sono presenti tag. Per ulteriori informazioni sui tag, consulta Assegnazione di tag alle risorse Amazon S3 Glacier.
Sintassi della richiesta
Per elencare i tag per un vault, invia una richiesta HTTP GET all'URI dei tag come illustrato nell'esempio di sintassi seguente.
GET /
AccountId
/vaults/vaultName
/tags HTTP/1.1 Host: glacier.Region
.amazonaws.com Date:Date
Authorization:SignatureValue
x-amz-glacier-version: 2012-06-01
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
Questa operazione non ha un corpo della richiesta.
Risposte
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200 OK
.
Sintassi della risposta
HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "Tags": { "string" : "string", "string" : "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.
- Tag
-
I tag associati al vault. Ogni tag consiste di una chiave e un valore.
Tipo: mappatura stringa a stringa
Required: Yes
Errori
Per informazioni sulle eccezioni e i messaggi di errore di Amazon S3 Glacier, consulta Risposte agli errori.
Esempi
Esempio: elenco di tag per un vault
L'esempio seguente elenca i tag per un vault.
Richiesta di esempio
In questo esempio, una richiesta GET viene inviata per recuperare un elenco di tag dal vault specificato.
GET /-/vaults/examplevault/tags 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 riesce, Amazon S3 Glacier (S3 Glacier) restituisce una risposta HTTP 200 OK
con un elenco di tag per il vault come mostrato nell'esempio seguente.
HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT Content-Type: application/json Content-Length: length { "Tags", { "examplekey1": "examplevalue1", "examplekey2": "examplevalue2" } }
Sezioni correlate
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli Amazon SDK specifici del linguaggio, consulta quanto segue: