List Vaults (GET vaults) - Amazon S3 Glacier
DescrizioneRichiesteRisposteEsempiSezioni correlateVedi anche

Questa pagina è riservata ai clienti esistenti del servizio S3 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 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 l'API Amazon S3, 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 sicurezza tra cui diverse opzioni di crittografia 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à.

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 richiesta List Vaults successiva, imposta il parametro marker sul valore restituito da Amazon S3 Glacier (S3 Glacier) nelle risposte alla richiesta List Vaults precedente. 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

GET /AccountId/vaults 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 utilizza i seguenti parametri di richiesta.

Nome Descrizione Obbligatorio
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: string

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: string

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.

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.

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 un vault, consulta Initiate Job (POST jobs).

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 del 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 i messaggi di errore di Amazon S3 Glacier, consulta Risposte agli errori.

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

GET /-/vaults 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

Il parametro Marker è null a indicare che non ci sono altri vault da elencare.

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: 497	

{
  "Marker": null,
  "VaultList": [ 
   {
    "CreationDate": "2012-03-16T22:22:47.214Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 2,
    "SizeInBytes": 12334,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
    "VaultName": "examplevault1"
   }, 
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
    "VaultName": "examplevault2"
   },
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-25T12:14:31.121Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
    "VaultName": "examplevault3"
   } 
  ]
}

Esempio: elenco parziale di vault

L'esempio seguente restituisce due vault a partire dal vault specificato dal parametro marker.

Richiesta di esempio

GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 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

Nell'elenco vengono restituiti due vault. Il parametro Marker contiene l'ARN del vault per continuare la paginazione in un'altra richiesta List Vaults.

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: 497	

{
  "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
  "VaultList": [ 
   {
    "CreationDate": "2012-03-16T22:22:47.214Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 2,
    "SizeInBytes": 12334,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
    "VaultName": "examplevault1"
   }, 
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
    "VaultName": "examplevault2"
   }
  ]
}

Vedi anche

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