**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](https://aws.amazon.com/s3/storage-classes/glacier/). Amazon Glacier (servizio autonomo originale basato su vault) non accetta più nuovi clienti. 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](https://aws.amazon.com/s3/storage-classes/glacier/), che offrono un'esperienza cliente superiore con disponibilità Regione AWS completa, costi inferiori e integrazione dei servizi APIs basata su bucket S3. AWS Se desideri funzionalità avanzate, prendi in considerazione la migrazione alle classi di storage Amazon S3 Glacier utilizzando la [AWS nostra Solutions Guidance per il trasferimento di dati dai vault Amazon Glacier alle classi di storage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). 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 Vaults (GET vaults) ## Descrizione Questa operazione elenca tutti i vault appartenenti all'account dell'utente che effettua la richiesta. L'elenco restituito nella risposta è ordinato in base ai valori ASCII dei nomi di vault. Per impostazione predefinita, questa operazione restituisce fino a 10 elementi per richiesta. Se sono presenti più vault da elencare, il campo `marker` nel corpo della risposta contiene l'ARN (Amazon Resource Name) del vault da cui continuare l'elenco con una nuova richiesta List Vaults. In caso contrario, il campo `marker` è `null`. Nella tua prossima richiesta List Vaults imposti il `marker` parametro sul valore che Amazon Glacier (Amazon Glacier) ha restituito nelle risposte alla tua precedente richiesta List Vaults. Puoi anche limitare il numero di vault restituiti nella risposta specificando il parametro `limit` nella richiesta. ## Richieste Per ottenere un elenco, invia una richiesta `GET` alla risorsa *vaults*. ### Sintassi ``` 1. GET /AccountId/vaults HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 ``` **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 utilizza i seguenti parametri di richiesta. | Nome | Descrizione | Richiesto | | --- | --- | --- | | limit | Il numero massimo di vault da restituire. Il limite di default è 10. Il numero di vault restituiti può essere inferiore al limite specificato, ma mai superiore. ▬Tipo: stringa Vincoli: il valore intero minimo è 1. Il valore intero massimo è 10. | No | | marker | Una stringa utilizzata per la paginazione. `marker` specifica l'ARN dopo il quale deve iniziare l'elenco. (il vault specificato da `marker` non è incluso nell'elenco restituito). Ottieni il valore `marker` da una precedente risposta di List Vaults. Devi includere `marker` solo se continui la paginazione dei risultati iniziata in una precedente richiesta List Vaults. Se per il contrassegno specifichi un valore vuoto (""), viene restituito un elenco di vault che inizia dal primo vault. ▬Tipo: stringa Vincoli: nessuno | No | ### 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](api-common-request-headers.md). ### Corpo della richiesta Questa operazione non ha un corpo della richiesta. ## Risposte ### Sintassi ``` HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "Marker": String "VaultList": [ { "CreationDate": String, "LastInventoryDate": String, "NumberOfArchives": Number, "SizeInBytes": Number, "VaultARN": String, "VaultName": 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](api-common-response-headers.md). ### Corpo della risposta Il corpo della risposta contiene i campi JSON descritti di seguito. **CreationDate** La data di creazione dell'archivio in formato UTC. *Tipo:* stringa. Una rappresentazione di stringa nel formato di data ISO 8601, ad esempio `2013-03-20T17:03:43.221Z`. **LastInventoryDate** La data dell'ultimo inventario vault in formato UTC. Questo campo può essere null se un inventario non è ancora stato generato per il vault, ad esempio, se hai appena creato il vault. Per informazioni sulla generazione di un inventario per una vault, consulta [Initiate Job (POST jobs)](api-initiate-job-post.md). *Tipo*: una rappresentazione di stringa nel formato data ISO 8601, ad esempio `2013-03-20T17:03:43.221Z`. **Marker** `vaultARN` rappresenta il punto da cui continuare la paginazione dei risultati. Puoi utilizzare il parametro `marker` in un'altra richiesta List Vaults per ottenere ulteriori vault nell'elenco. Se non vi sono altri vault, questo valore è `null`. ▬*Tipo:* stringa **NumberOfArchives** Il numero di archivi nel vault alla data dell'ultimo inventario. *Tipo*: numero **SizeInBytes** La dimensione totale in byte di tutti gli archivi nel vault, incluso l'overhead di ogni archivio, alla data dell'ultimo inventario. *Tipo*: numero **VaultARN** L'ARN della vault. ▬*Tipo:* stringa **VaultList** Un matrice di oggetti, con ogni oggetto che fornisce una descrizione di un vault. *Tipo*: matrice **VaultName** Il nome del vault. ▬*Tipo:* stringa ### Errori Per informazioni sulle eccezioni e sui messaggi di errore di Amazon Glacier, consulta. [Risposte agli errori](api-error-responses.md) ## Esempi ### Esempio: elenco di tutti i vault L'esempio seguente elenca tutti i vault. Poiché i parametri `marker` e `limit` non sono specificati nella richiesta, vengono restituiti fino a 10 vault. #### Richiesta di esempio ``` 1. GET /-/vaults HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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 Il parametro `Marker` è `null` a indicare che non ci sono altri vault da elencare. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: 497 6. 7. { 8. "Marker": null, 9. "VaultList": [ 10. { 11. "CreationDate": "2012-03-16T22:22:47.214Z", 12. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 13. "NumberOfArchives": 2, 14. "SizeInBytes": 12334, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1", 16. "VaultName": "examplevault1" 17. }, 18. { 19. "CreationDate": "2012-03-19T22:06:51.218Z", 20. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 21. "NumberOfArchives": 0, 22. "SizeInBytes": 0, 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2", 24. "VaultName": "examplevault2" 25. }, 26. { 27. "CreationDate": "2012-03-19T22:06:51.218Z", 28. "LastInventoryDate": "2012-03-25T12:14:31.121Z", 29. "NumberOfArchives": 0, 30. "SizeInBytes": 0, 31. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3", 32. "VaultName": "examplevault3" 33. } 34. ] 35. } ``` ### Esempio: elenco parziale di vault L'esempio seguente restituisce due vault a partire dal vault specificato dal parametro `marker`. #### Richiesta di esempio ``` 1. GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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 Nell'elenco vengono restituiti due vault. Il parametro `Marker` contiene l'ARN del vault per continuare la paginazione in un'altra richiesta List Vaults. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: 497 6. 7. { 8. "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3", 9. "VaultList": [ 10. { 11. "CreationDate": "2012-03-16T22:22:47.214Z", 12. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 13. "NumberOfArchives": 2, 14. "SizeInBytes": 12334, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1", 16. "VaultName": "examplevault1" 17. }, 18. { 19. "CreationDate": "2012-03-19T22:06:51.218Z", 20. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 21. "NumberOfArchives": 0, 22. "SizeInBytes": 0, 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2", 24. "VaultName": "examplevault2" 25. } 26. ] 27. } ``` ## Sezioni correlate + [Create Vault (PUT vault)](api-vault-put.md) + [Delete Vault (DELETE vault)](api-vault-delete.md) + [Initiate Job (POST jobs)](api-initiate-job-post.md) + [Identity and Access Management per Amazon Glacier](security-iam.md) ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue SDKs Amazon specifiche per lingua, consulta quanto segue: + [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/list-vaults.html)