Erstellen eines Tresors in Amazon S3 Glacier mithilfe derAWS SDK for Java

Die Low-Level-API bietet Methoden für alle Tresorvorgänge und ermöglicht das Erstellen und Löschen von Tresoren, das Abrufen einer Tresorbeschreibung und einer Liste der in einer bestimmtenAWS-Regionaus. Im Folgenden werden die Schritte zum Erstellen eines Tresors mit AWS SDK for Java beschrieben.

1. Erstellen einer Instance der AmazonGlacierClient-Klasse (Client).

   Sie müssen einAWS-Regionin dem ein Tresor erstellt werden soll. Alle Operationen, die Sie mit diesem Client durchführen, gelten für diesenAWS-Regionaus.

2. Um die Anforderungsinformationen bereitzustellen, erstellen Sie eine Instance der CreateVaultRequest-Klasse.

   Für Amazon S3 Glacier (S3 Glacier) ist es erforderlich, dass Sie einen Tresornamen und Ihre Konto-ID angeben Wenn Sie keine Konto-ID angeben, wird die Konto-ID übernommen, die den Anmeldeinformationen zugeordnet ist, die Sie zum Signieren der Anfrage verwenden. Weitere Informationen finden Sie unter Verwendung derAWS SDK for Javamit Amazon S3 Glacier.

3. Führen Sie die createVault-Methode aus, indem das Anforderungsobjekt als Parameter festgelegt wird.

   Die von S3 Glacier zurückgegebene Antwort ist in derCreateVaultResult-Objekt.

Der folgende Java-Codeausschnitt veranschaulicht die vorherigen Schritte. Der Ausschnitt erstellt einen Tresor in der Region us-west-2. DieLocationit prints ist der relative URI des Tresors, einschließlich Ihrer Konto-ID, derAWS-Regionund der Name des Tresors.

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());

Anmerkung

Weitere Information zur zugrunde liegenden REST-API finden Sie unter Create Vault (PUT vault).

Beispiel: Erstellen eines Tresors mit der AWS SDK for Java

Im folgenden Java-Codebeispiel wird ein Tresor in erstelltus-west-2Region (weitere Informationen finden Sie unterAWS-Regionenfinden Sie unter,Zugriff auf Amazon S3 Glacier zugreifen) enthalten. Außerdem ruft der Beispielcode die Tresorinformationen ab und listet alle Tresore in derselben aufAWS-Region, und löscht dann den erstellten Tresor.

Für step-by-step Anweisungen zum Ausführen des folgenden Beispiels finden Sie unter.Ausführung von Java-Beispielen für Amazon S3 Glacier unter Verwendung von Eclipseaus.

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);
    }

}