Creazione di un vault in Amazon S3 Glacier mediante AWS SDK for Java

L'interfaccia API di basso livello fornisce metodi per tutte le operazioni di vault, tra cui creare ed eliminare vault, ottenere la descrizione di un vault e visualizzare un elenco di vault creati in una determinata Regione AWS. Di seguito è riportata la procedura per creare un vault mediante il kit AWS SDK for Java.

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

   Devi specificare una Regione AWS in cui intendi creare un 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 CreateVaultRequest.

   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 createVault fornendo l'oggetto della richiesta come parametro.

   La risposta restituita da S3 Glacier è disponibile nell'oggetto CreateVaultResult.

Il seguente frammento di codice Java illustra la procedura precedente. Il frammento di codice crea un vault nella regione us-west-2 La Location è l'URI relativo del vault che include l'ID del tuo account, la Regione AWS e il nome del vault.

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

CreateVaultRequest request = new CreateVaultRequest()
    .withVaultName("*** provide vault name ***");
CreateVaultResult result = client.createVault(request);

System.out.println("Created vault successfully: " + result.getLocation());

Nota

Per informazioni sulla REST API sottostante, consulta Create Vault (PUT vault).

Esempio: creazione di un vault mediante l'AWS SDK for Java

L'esempio di codice Java seguente crea un vault nella regione us-west-2 (per ulteriori informazioni sulle Regioni AWS, consulta Accesso ad Amazon S3 Glacier). Inoltre, l'esempio di codice recupera le informazioni sul vault, elenca tutti i vault nella stessa Regione AWS e quindi elimina il vault creato.

Per istruzioni dettagliate su come eseguire l'esempio seguente, consulta Esecuzione di esempi Java per Amazon S3 Glacier mediante Eclipse.

import java.io.IOException;
import java.util.List;

import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.glacier.AmazonGlacierClient;
import com.amazonaws.services.glacier.model.CreateVaultRequest;
import com.amazonaws.services.glacier.model.CreateVaultResult;
import com.amazonaws.services.glacier.model.DeleteVaultRequest;
import com.amazonaws.services.glacier.model.DescribeVaultOutput;
import com.amazonaws.services.glacier.model.DescribeVaultRequest;
import com.amazonaws.services.glacier.model.DescribeVaultResult;
import com.amazonaws.services.glacier.model.ListVaultsRequest;
import com.amazonaws.services.glacier.model.ListVaultsResult;


public class AmazonGlacierVaultOperations {

    public static AmazonGlacierClient client;

    public static void main(String[] args) throws IOException {

    	ProfileCredentialsProvider credentials = new ProfileCredentialsProvider();
    	
        client = new AmazonGlacierClient(credentials);
        client.setEndpoint("https://glacier.us-east-1.amazonaws.com/");
        
        String vaultName = "examplevaultfordelete";

        try {            
            createVault(client, vaultName);
            describeVault(client, vaultName); 
            listVaults(client);
            deleteVault(client, vaultName);      

        } catch (Exception e) {
            System.err.println("Vault operation failed." + e.getMessage());
        }
    }

    private static void createVault(AmazonGlacierClient client, String vaultName) {
        CreateVaultRequest createVaultRequest = new CreateVaultRequest()
            .withVaultName(vaultName);
        CreateVaultResult createVaultResult = client.createVault(createVaultRequest);

        System.out.println("Created vault successfully: " + createVaultResult.getLocation());
    }

    private static void describeVault(AmazonGlacierClient client, String vaultName) {
        DescribeVaultRequest describeVaultRequest = new DescribeVaultRequest()
            .withVaultName(vaultName);
        DescribeVaultResult describeVaultResult  = client.describeVault(describeVaultRequest);

        System.out.println("Describing the vault: " + vaultName);
        System.out.print(
                "CreationDate: " + describeVaultResult.getCreationDate() +
                "\nLastInventoryDate: " + describeVaultResult.getLastInventoryDate() +
                "\nNumberOfArchives: " + describeVaultResult.getNumberOfArchives() + 
                "\nSizeInBytes: " + describeVaultResult.getSizeInBytes() + 
                "\nVaultARN: " + describeVaultResult.getVaultARN() + 
                "\nVaultName: " + describeVaultResult.getVaultName());
    }

    private static void listVaults(AmazonGlacierClient client) {
        ListVaultsRequest listVaultsRequest = new ListVaultsRequest();
        ListVaultsResult listVaultsResult = client.listVaults(listVaultsRequest);

        List<DescribeVaultOutput> vaultList = listVaultsResult.getVaultList();
        System.out.println("\nDescribing all vaults (vault list):");
        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()); 
        }
    }

    private static void deleteVault(AmazonGlacierClient client, String vaultName) {
        DeleteVaultRequest request = new DeleteVaultRequest()
            .withVaultName(vaultName);
        client.deleteVault(request);
        System.out.println("Deleted vault: " + vaultName);
    }

}