Verwenden von AWS SDK für Java mit Amazon Glacier - Amazon Glacier
Verwenden der Low-Level-APIVerwenden der High-Level-APIAusführung von Java-Beispielen unter Verwendung von EclipseFestlegen des Endpunkts

Diese Seite ist nur für Bestandskunden des Amazon Glacier-Service bestimmt, die Vaults und die ursprüngliche REST-API von 2012 verwenden.

Wenn Sie nach Archivspeicherlösungen suchen, empfehlen wir die Verwendung der Amazon Glacier-Speicherklassen in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive. Weitere Informationen zu diesen Speicheroptionen finden Sie unter Amazon Glacier-Speicherklassen.

Amazon Glacier (ursprünglicher eigenständiger, vault-basierter Service) akzeptiert ab dem 15. Dezember 2025 keine Neukunden mehr, ohne dass dies Auswirkungen auf Bestandskunden hat. Amazon Glacier ist ein eigenständiger Service APIs , der Daten in Tresoren speichert und sich von den Speicherklassen Amazon S3 und Amazon S3 Glacier unterscheidet. Ihre vorhandenen Daten bleiben in Amazon Glacier auf unbestimmte Zeit sicher und zugänglich. Es ist keine Migration erforderlich. Für kostengünstige, langfristige Archivierungsspeicherung AWS empfiehlt sich die Amazon S3 Glacier-Speicherklasse, die mit S3-Bucket-Basis, voller AWS-Region Verfügbarkeit APIs, geringeren Kosten und AWS Serviceintegration ein hervorragendes Kundenerlebnis bieten. Wenn Sie erweiterte Funktionen wünschen, sollten Sie eine Migration zu Amazon S3 Glacier-Speicherklassen in Betracht ziehen, indem Sie unseren AWS Lösungsleitfaden für die Übertragung von Daten aus Amazon Glacier-Tresoren in Amazon S3 Glacier-Speicherklassen verwenden.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden von AWS SDK für Java mit Amazon Glacier

Das AWS SDK für Java bietet sowohl High-Level als auch Low-Level APIs für Amazon Glacier (Amazon Glacier), wie unter beschriebenVerwenden von AWS SDKs mit Amazon Glacier. Informationen zum Herunterladen von finden Sie unter Amazon SDK for Java. AWS SDK für Java

Anmerkung

Das AWS SDK für Java bietet Thread-sichere Clients für den Zugriff auf Amazon Glacier. Als bewährte Methode sollten Ihre Anwendungen einen Client erstellen und diesen zwischen den Threads wiederverwenden.

Verwenden der Low-Level-API

Die AmazonGlacierClient Low-Level-Klasse stellt alle Methoden bereit, die den zugrunde liegenden REST-Operationen von Amazon Glacier (API-Referenz für Amazon Glacier) zugeordnet sind. Wenn Sie eine dieser Methoden aufrufen, müssen Sie ein entsprechendes Anforderungsobjekt erstellen und ein Antwortobjekt bereitstellen, in dem die Methode die Amazon Glacier-Antwort auf den Vorgang zurückgeben kann.

Beispielsweise stellt die AmazonGlacierClient-Klasse die createVault-Methode für die Erstellung eines Tresors zur Verfügung. Diese Methode lässt sich der zugrunde liegenden REST-Operation „Create Vault” zuordnen (siehe Create Vault (PUT vault)). Um diese Methode zu verwenden, müssen Sie Instances des CreateVaultResult Objekts erstellen, das die Amazon Glacier-Antwort empfängt, wie im folgenden Java-Codeausschnitt dargestellt:

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

CreateVaultRequest request = new CreateVaultRequest()
    .withAccountId("-")
    .withVaultName(vaultName);
CreateVaultResult result = client.createVault(createVaultRequest);

Alle Low-Level-Beispiele in diesem Handbuch entsprechen diesem Muster.

Anmerkung

Im vorstehenden Codesegment wird beim Erstellen der Anfrage AccountID angegeben. Bei Verwendung von ist das AWS SDK für JavaAccountId in der Anfrage jedoch optional, und daher wird dieser Wert nicht in allen einfachen Beispielen in diesem Handbuch festgelegt. Das AccountId ist die AWS-Konto ID. Dieser Wert muss mit der AWS-Konto ID übereinstimmen, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Sie können entweder die AWS-Konto ID oder optional ein '-' angeben. In diesem Fall verwendet Amazon Glacier die AWS-Konto ID, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Wenn Sie Ihre Konto-ID angeben, müssen Sie sie ohne Bindestriche eingeben. Wenn Sie bei der Verwendung AWS SDK für Java die Konto-ID nicht angeben, setzt die Bibliothek die Konto-ID auf '-'.

Verwenden der High-Level-API

Um Ihre Anwendungsentwicklung weiter zu vereinfachen, AWS SDK für Java stellt die die ArchiveTransferManager Klasse bereit, die eine Abstraktion auf höherer Ebene für einige Methoden in der Low-Level-API implementiert. Sie stellt nützliche Methoden wie upload und download für die Archivoperationen bereit.

Beispielsweise wird im folgenden Java-Codeausschnitt die High-Level-Methode upload zum Hochladen eines Archivs verwendet. 

String vaultName = "examplevault";
String archiveToUpload = "c:/folder/exampleArchive.zip";

ArchiveTransferManager atm = new ArchiveTransferManager(client, credentials);
String archiveId = atm.upload(vaultName, "Tax 2012 documents", new File(archiveToUpload)).getArchiveId();

Beachten Sie, dass alle Operationen, die Sie ausführen, für die AWS Region gelten, die Sie bei der Erstellung des Objekts angegeben haben. ArchiveTransferManager Wenn Sie keine Region angeben, wird die AWS AWS SDK für Java Region us-east-1 als AWS Standardregion festgelegt.

Alle High-Level-Beispiele in diesem Handbuch entsprechen diesem Muster.

Anmerkung

Die High-Level-Klasse ArchiveTransferManager kann mit einer AmazonGlacierClient-Instance oder einer AWSCredentials-Instance konstruiert werden.

Ausführen von Java-Beispielen für Amazon Glacier mit Eclipse

Am einfachsten gelingt der Einstieg in die Java-Codebeispiele, indem die neueste AWS Toolkit for Eclipse installiert wird. Informationen zum Installieren oder Aktualisieren des neuesten Toolkits finden Sie unter http://aws.amazon.com/eclipse. Die folgenden Aufgaben führen Sie durch das Erstellen und Testen der Java-Codebeispiele aus diesem Abschnitt.

Allgemeiner Vorgang bei der Erstellung von Java-Codebeispielen

1

Erstellen Sie ein Standard-Anmeldeinformationsprofil für Ihre AWS Anmeldeinformationen, wie im AWS SDK für Java Thema Bereitstellen von AWS Anmeldeinformationen im Amazon SDK for Java beschrieben.

2

Erstellen Sie ein neues AWS Java-Projekt in Eclipse. Das Projekt ist mit dem AWS SDK für Java vorkonfiguriert.

3

Kopieren Sie den Code aus dem Abschnitt, den Sie gerade lesen, in Ihr Projekt.

4

 Aktualisieren Sie den Code mit den erforderlichen Daten. Wenn Sie beispielsweise eine Datei hochladen, geben Sie den Dateipfad und den Bucket-Namen an.

5

Führen Sie den Code aus. Stellen Sie sicher, dass das Objekt mit der AWS Management Console erstellt wurde. Weitere Informationen zum AWS Management Console finden Sie unter http://aws.amazon.com/console/.

Festlegen des Endpunkts

Standardmäßig AWS SDK für Java verwendet der den Endpunkthttps://glacier.us-east-1.amazonaws.com. Sie können den Endpunkt explizit einrichten, wie in den folgenden Java-Codeausschnitten gezeigt.

Der folgende Codeausschnitt zeigt, wie der Endpunkt in der Low-Level-API auf die Region „USA West (Oregon)“ (us-west-2) festgelegt wird.

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

Der folgende Codeausschnitt zeigt, wie der Endpunkt in der High-Level-API auf die Region „USA West (Oregon)“ festgelegt wird.

glacierClient = new AmazonGlacierClient(credentials);
sqsClient = new AmazonSQSClient(credentials);
snsClient = new AmazonSNSClient(credentials);
        
glacierClient.setEndpoint("glacier.us-west-2.amazonaws.com");
sqsClient.setEndpoint("sqs.us-west-2.amazonaws.com");
snsClient.setEndpoint("sns.us-west-2.amazonaws.com");

ArchiveTransferManager atm = new ArchiveTransferManager(glacierClient, sqsClient, snsClient);

Eine Liste der unterstützten AWS Regionen und Endpunkte finden Sie unterZugreifen auf Amazon Glacier.