Recupero di metadati di vault in Amazon S3 Glacier mediante l'AWS SDK for Java

Recupero di metadati di vault per un vault

Puoi recuperare metadati per un determinato vault o per tutti i vault in una determinata regione AWS. Di seguito è riportata la procedura per recuperare metadati di vault per un vault specifico utilizzando l'API di basso livello dell'Amazon SDK per Java.

1. Crea un'istanza della classe AmazonGlacierClient (client).

   Devi specificare la regione AWS in cui si trova il vault. Tutte le operazioni che esegui utilizzando questo client si applicano a quella regione AWS.

2. Fornisci informazioni sulla richiesta creando un'istanza della classe DescribeVaultRequest.

   Amazon S3 Glacier (S3 Glacier) richiede di fornire un nome di vault e il tuo ID account. Se non specifichi un ID account, viene utilizzato l'ID account associato alle credenziali che hai fornito per firmare la richiesta. Per ulteriori informazioni, consulta Utilizzo di AWS SDK for Java con Amazon S3 Glacier.

3. Eseguire il metodo describeVault fornendo l'oggetto della richiesta come parametro.

   Le informazioni sui metadati di vault che S3 Glacier restituisce sono disponibili nell'oggetto DescribeVaultResult.

Il seguente frammento di codice Java illustra la procedura precedente.

DescribeVaultRequest request = new DescribeVaultRequest()
	.withVaultName("*** provide vault name***");

DescribeVaultResult result = client.describeVault(request);

System.out.print(
        "\nCreationDate: " + result.getCreationDate() +
        "\nLastInventoryDate: " + result.getLastInventoryDate() +
        "\nNumberOfArchives: " + result.getNumberOfArchives() + 
        "\nSizeInBytes: " + result.getSizeInBytes() + 
        "\nVaultARN: " + result.getVaultARN() + 
        "\nVaultName: " + result.getVaultName());

Nota

Per informazioni sulla REST API sottostante, consulta Describe Vault (GET vault).

Recupero di metadati di vault per tutti i vault in una regione

Puoi utilizzare il metodo listVaults anche per recuperare metadati per tutti i vault in una regione AWS specifica.

Il seguente frammento di codice Java recupera un elenco di vault nella regione us-west-2. La richiesta limita a 5 il numero di vault restituiti nella risposta. Il frammento di codice effettua una serie di chiamate listVaults per recuperare l'intero elenco di vault dalla regione AWS.

AmazonGlacierClient client;
client.setEndpoint("https://glacier.us-west-2.amazonaws.com/");

String marker = null;
do {            
    ListVaultsRequest request = new ListVaultsRequest()
        .withLimit("5")
        .withMarker(marker);
    ListVaultsResult listVaultsResult = client.listVaults(request);
    
    List<DescribeVaultOutput> vaultList = listVaultsResult.getVaultList();
    marker = listVaultsResult.getMarker();
    for (DescribeVaultOutput vault : vaultList) {
        System.out.println(
                "\nCreationDate: " + vault.getCreationDate() +
                "\nLastInventoryDate: " + vault.getLastInventoryDate() +
                "\nNumberOfArchives: " + vault.getNumberOfArchives() + 
                "\nSizeInBytes: " + vault.getSizeInBytes() + 
                "\nVaultARN: " + vault.getVaultARN() + 
                "\nVaultName: " + vault.getVaultName()); 
    }
} while (marker != null);

Nel segmento di codice precedente, se non specifichi il valore Limit nella richiesta, S3 Glacier restituisce fino a 10 vault, come definito dall'API di S3 Glacier. Se sono presenti più vault da elencare, il campo marker della risposta contiene l'ARN (Amazon Resource Name) del vault in cui continuare l'elenco con una nuova richiesta. In caso contrario, il campo marker è null.

Nota che le informazioni restituite per ogni vault nell'elenco sono le stesse che ottieni chiamando il metodo describeVault per un determinato vault.

Nota

Il metodo listVaults chiama la REST API sottostante (consulta List Vaults (GET vaults)).

Esempio: recupero di metadati di vault mediante Amazon SDK per Java

Per un esempio di codice, consulta Esempio: creazione di un vault mediante l'AWS SDK for Java. L'esempio di codice Java crea un vault e recupera i metadati di vault.