

 **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](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (ursprünglicher eigenständiger, auf Tresor basierender Service) akzeptiert keine Neukunden mehr. 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](https://aws.amazon.com/s3/storage-classes/glacier/), 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](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/) 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 SDKs mit Amazon Glacier
<a name="using-aws-sdk"></a>

AWS bietet Ihnen SDKs die Möglichkeit, Anwendungen für Amazon Glacier zu entwickeln. Die SDK-Bibliotheken umfassen die zugrunde liegende Amazon Glacier-API und vereinfachen so Ihre Programmieraufgaben. Beispielsweise müssen Sie für jede an Amazon Glacier gesendete Anfrage eine Signatur hinzufügen, um Ihre Anfragen zu authentifizieren. Wenn Sie die SDK-Bibliotheken verwenden, müssen Sie nur Ihre AWS Sicherheitsanmeldedaten in Ihrem Code angeben, und die Bibliotheken berechnen die erforderliche Signatur und fügen sie in die an Amazon Glacier gesendete Anfrage ein. AWS SDKs Sie stellen Bibliotheken bereit, die der zugrunde liegenden REST-API zugeordnet sind, und stellen Objekte bereit, mit denen Sie auf einfache Weise Anfragen erstellen und Antworten verarbeiten können. 

**Topics**
+ [AWS SDK-Bibliotheken für Java und .NET](#java-.net-sdk-libraries)
+ [Amazon Glacier mit einem AWS SDK verwenden](sdk-general-information-section.md)
+ [Verwenden von AWS SDK für Java mit Amazon Glacier](using-aws-sdk-for-java.md)
+ [Verwenden von AWS SDK für .NET mit Amazon Glacier](using-aws-sdk-for-dot-net.md)

Das AWS Command Line Interface (AWS CLI) ist ein einheitliches Tool zur Verwaltung Ihres AWS-Services, einschließlich Amazon Glacier. Informationen zum Herunterladen von finden AWS CLI Sie unter [AWS Command Line Interface](https://aws.amazon.com/cli/). Eine Liste der Amazon Glacier CLI-Befehle finden Sie in der [AWS CLI Befehlsreferenz](https://docs.aws.amazon.com/cli/latest/reference/glacier/index.html). 

## AWS SDK-Bibliotheken für Java und .NET
<a name="java-.net-sdk-libraries"></a>

Die AWS SDKs für Java und .NET bieten Wrapper-Bibliotheken auf hoher und niedriger Ebene. 

Beispiele für die Arbeit mit Amazon Glacier finden Sie im AWS SDK für Java und AWS SDK für .NET überall in diesem Entwicklerhandbuch. 

### Was ist die Low-Level-&API?
<a name="what-is-low-level-api"></a>

Die Low-Level-Wrapper-Bibliotheken bilden eng die zugrunde liegende REST-API ([API-Referenz für Amazon Glacier](amazon-glacier-api.md)) ab, die von Amazon Glacier unterstützt wird. Für jeden Amazon Glacier-REST-Vorgang bietet die Low-Level-API eine entsprechende Methode, ein Anforderungsobjekt, mit dem Sie Anforderungsinformationen bereitstellen können, und ein Antwortobjekt, mit dem Sie die Amazon Glacier-Antwort verarbeiten können. Die Low-Level-Wrapper-Bibliotheken sind die vollständigste Implementierung der zugrunde liegenden Amazon Glacier-Operationen. 

Weitere Informationen zu diesen SDK-Bibliotheken finden Sie unter [Verwenden von AWS SDK für Java mit Amazon Glacier](using-aws-sdk-for-java.md) und [Verwenden von AWS SDK für .NET mit Amazon Glacier](using-aws-sdk-for-dot-net.md).

### Was ist die High-Level-&API?
<a name="what-is-high-level-api"></a>

Zur weiteren Vereinfachung der Anwendungsentwicklung bieten diese Bibliotheken für einige Operationen eine Abstraktion auf höherer Ebene. Beispiel: 
+ Hochladen eines Archivs: Zum Hochladen eines Archivs mit der Low-Level-API müssen Sie zusätzlich zum Dateinamen und dem Namen des Tresors, in dem Sie das Archiv speichern möchten, eine Prüfsumme (SHA-256-Struktur-Hash) der Nutzlast angeben. Die High-Level-API berechnet jedoch die Prüfsumme für Sie.
+ Herunterladen eines Archivs oder eines Tresorbestands: Zum Herunterladen eines Archivs mithilfe der Low-Level-API initiieren Sie zunächst einen Auftrag, warten, bis der Auftrag abgeschlossen ist, und rufen dann die Auftragsausgabe ab. Sie müssen zusätzlichen Code schreiben, um ein Amazon Simple Notification Service (Amazon SNS) -Thema einzurichten, damit Amazon Glacier Sie benachrichtigt, wenn der Job abgeschlossen ist. Sie benötigen außerdem einen Abfragemechanismus, der überprüft, ob eine Nachricht über den Abschluss des Auftrags an das Thema übermittelt wurde. Die High-Level-API stellt zum Herunterladen eines Archivs eine Methode bereit, die alle diese Schritte erledigt. Sie geben lediglich eine Archiv-ID und den Pfad zu dem Ordner an, in dem Sie die heruntergeladenen Daten speichern möchten. 

Weitere Informationen zu diesen SDK-Bibliotheken finden Sie unter [Verwenden von AWS SDK für Java mit Amazon Glacier](using-aws-sdk-for-java.md) und [Verwenden von AWS SDK für .NET mit Amazon Glacier](using-aws-sdk-for-dot-net.md).

### Situationen für die Verwendung der High-Level- und der Low-Level-API
<a name="when-to-use-high-low-api"></a>

Wenn die High-Level-API Methoden bietet, die Sie zum Ausführen der Operation benötigen, ist es in der Regel ratsam, die High-Level-API zu verwenden, weil damit der gesamte Vorgang vereinfacht wird. Wenn die High-Level-API keine vorteilhaften Funktionen bietet, können Sie die Low-Level-API verwenden. Die Low-Level-API ermöglicht die differenzierte Steuerung der Operation, z. B. mittels einer Logik für Wiederholversuche bei Fehlern. Beim Hochladen eines Archivs verwendet die High-Level-API beispielsweise die Dateigröße, um zu bestimmen, ob das Archiv in einer einzigen Operation oder mithilfe der API für mehrteilige Uploads hochgeladen wird. Für den Fall, dass der Hochladevorgang fehlschlägt, verfügt die API ebenfalls über eine integrierte Logik für Wiederholversuche. Falls für Ihre Anwendung eine differenzierte Steuerung dieser Entscheidungen erforderlich ist, können Sie die Low-Level-API verwenden.

# Amazon Glacier mit einem AWS SDK verwenden
<a name="sdk-general-information-section"></a>

AWS Software Development Kits (SDKs) sind für viele beliebte Programmiersprachen verfügbar. Jedes SDK bietet eine API, Codebeispiele und Dokumentation, die es Entwicklern erleichtern, Anwendungen in ihrer bevorzugten Sprache zu erstellen.


| SDK-Dokumentation | Codebeispiele | 
| --- | --- | 
| [AWS SDK für C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp) | [AWS SDK für C\$1\$1 Codebeispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp) | 
| [AWS CLI](https://docs.aws.amazon.com/cli) | [AWS CLI Code-Beispiele](https://docs.aws.amazon.com/code-library/latest/ug/cli_2_code_examples.html) | 
| [AWS SDK für Go](https://docs.aws.amazon.com/sdk-for-go) | [AWS SDK für Go Code-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/gov2) | 
| [AWS SDK für Java](https://docs.aws.amazon.com/sdk-for-java) | [AWS SDK für Java Code-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2) | 
| [AWS SDK für JavaScript](https://docs.aws.amazon.com/sdk-for-javascript) | [AWS SDK für JavaScript Code-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3) | 
| [AWS SDK für Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin) | [AWS SDK für Kotlin Code-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin) | 
| [AWS SDK für .NET](https://docs.aws.amazon.com/sdk-for-net) | [AWS SDK für .NET Code-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3) | 
| [AWS SDK für PHP](https://docs.aws.amazon.com/sdk-for-php) | [AWS SDK für PHP Code-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php) | 
| [AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell) | [AWS -Tools für PowerShell Code-Beispiele](https://docs.aws.amazon.com/code-library/latest/ug/powershell_5_code_examples.html) | 
| [AWS SDK für Python (Boto3)](https://docs.aws.amazon.com/pythonsdk) | [AWS SDK für Python (Boto3) Code-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python) | 
| [AWS SDK für Ruby](https://docs.aws.amazon.com/sdk-for-ruby) | [AWS SDK für Ruby Code-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby) | 
| [AWS SDK für Rust](https://docs.aws.amazon.com/sdk-for-rust) | [AWS SDK für Rust Code-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1) | 
| [AWS SDK für SAP ABAP](https://docs.aws.amazon.com/sdk-for-sapabap) | [AWS SDK für SAP ABAP Code-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap) | 
| [AWS SDK für Swift](https://docs.aws.amazon.com/sdk-for-swift) | [AWS SDK für Swift Code-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/swift) | 

Spezifische Beispiele für Amazon Glacier finden Sie unter[Codebeispiele für Amazon Glacier mit AWS SDKs](service_code_examples.md).

**Beispiel für die Verfügbarkeit**  
Sie können nicht finden, was Sie brauchen? Fordern Sie ein Codebeispiel an, indem Sie unten den Link **Provide feedback** (Feedback geben) auswählen.

# Verwenden von AWS SDK für Java mit Amazon Glacier
<a name="using-aws-sdk-for-java"></a>

Das AWS SDK für Java bietet sowohl High-Level als auch Low-Level APIs für Amazon Glacier (Amazon Glacier), wie unter beschrieben[Verwenden von AWS SDKs mit Amazon Glacier](using-aws-sdk.md). Informationen zum Herunterladen von finden Sie unter [Amazon SDK for Java](https://aws.amazon.com/sdkforjava/). 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.

**Topics**
+ [Verwenden der Low-Level-API](#about-low-level-java-api)
+ [Verwenden der High-Level-API](#about-high-level-java-api)
+ [Ausführen von Java-Beispielen für Amazon Glacier mit Eclipse](#setting-up-and-testing-sdk-java)
+ [Festlegen des Endpunkts](#setting-sdk-java-endpoint)

## Verwenden der Low-Level-API
<a name="about-low-level-java-api"></a>

Die `AmazonGlacierClient` Low-Level-Klasse stellt alle Methoden bereit, die den zugrunde liegenden REST-Operationen von Amazon Glacier ([API-Referenz für Amazon Glacier](amazon-glacier-api.md)) 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)](api-vault-put.md)). 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 Java`AccountId` 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
<a name="about-high-level-java-api"></a>

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
<a name="setting-up-and-testing-sdk-java"></a>

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](https://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](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html) 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-Managementkonsole erstellt wurde. Weitere Informationen zum AWS-Managementkonsole finden Sie [unter http://aws.amazon.com/console/](https://aws.amazon.com/console/). | 

## Festlegen des Endpunkts
<a name="setting-sdk-java-endpoint"></a>

Standardmäßig AWS SDK für Java verwendet der den Endpunkt`https://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.

**Example**  

```
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 unter[Zugriff auf Amazon Glacier](amazon-glacier-accessing.md).

# Verwenden von AWS SDK für .NET mit Amazon Glacier
<a name="using-aws-sdk-for-dot-net"></a>

Die AWS SDK für .NET API ist verfügbar in`AWSSDK.dll`. Informationen zum Herunterladen von finden Sie unter [Beispielcodebibliotheken](https://aws.amazon.com/sdkfornet/). AWS SDK für .NET Wie unter beschrieben[Verwenden von AWS SDKs mit Amazon Glacier](using-aws-sdk.md), AWS SDK für .NET bietet der sowohl die High-Level- als auch die APIs Low-Level-Version. 

**Anmerkung**  
Die Low-Level-API und die High-Level-API bieten 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.

**Topics**
+ [Verwenden der Low-Level-API](#about-low-level-dotnet-api)
+ [Verwenden der High-Level-API](#about-high-level-dotnet-api)
+ [Ausführen von Codebeispielen](#setting-up-and-testing-sdk-dotnet)
+ [Festlegen des Endpunkts](#setting-sdk-dot-net-endpoint)

## Verwenden der Low-Level-API
<a name="about-low-level-dotnet-api"></a>

Die `AmazonGlacierClient` Low-Level-Klasse stellt alle Methoden bereit, die den zugrunde liegenden REST-Vorgängen von Amazon Glacier (Amazon Glacier) ([API-Referenz für Amazon Glacier](amazon-glacier-api.md)) zugeordnet sind. Wenn Sie eine dieser Methoden aufrufen, müssen Sie ein entsprechendes Anforderungsobjekt erstellen und ein Antwortobjekt bereitstellen, in dem die Methode eine 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)](api-vault-put.md)). Um diese Methode zu verwenden, müssen Sie Instances der `CreateVaultResponse` Klassen `CreateVaultRequest` und erstellen, um Anforderungsinformationen bereitzustellen und eine Amazon Glacier-Antwort zu erhalten, wie im folgenden C\$1-Codeausschnitt dargestellt:

 

```
AmazonGlacierClient client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USEast1); 

CreateVaultRequest request = new CreateVaultRequest()
{
  AccountId = "-",
  VaultName = "*** Provide vault name ***"
};

CreateVaultResponse response = client.CreateVault(request);
```

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 die AWS SDK für .NET Angabe `AccountId` in der Anfrage jedoch optional. 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 .NET die Konto-ID nicht angeben, setzt die Bibliothek die Konto-ID auf '-'. 

## Verwenden der High-Level-API
<a name="about-high-level-dotnet-api"></a>

Um Ihre Anwendungsentwicklung weiter zu vereinfachen, AWS SDK für .NET 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 C\$1-Codeausschnitt die High-Level-Methode `Upload` zum Hochladen eines Archivs verwendet. 

 

```
string vaultName = "examplevault";
string archiveToUpload = "c:\folder\exampleArchive.zip";

var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USEast1);
string archiveId = manager.Upload(vaultName, "archive description", archiveToUpload).ArchiveId;
```

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` Alle High-Level-Beispiele in diesem Handbuch entsprechen diesem Muster. 

 

**Anmerkung**  
Auch die `ArchiveTransferManager`-Klasse der High-Level-API braucht den Low-Level-Client `AmazonGlacierClient`, den Sie entweder explizit übergeben oder von `ArchiveTransferManager` erstellen lassen können.

## Ausführen von Codebeispielen
<a name="setting-up-and-testing-sdk-dotnet"></a>

Am einfachsten gelingt der Einstieg in die .NET-Codebeispiele durch die Installation von AWS SDK für .NET. Weitere Informationen finden Sie im Artikel zum [Amazon-SDK für .NET](https://aws.amazon.com/sdkfornet/). 

Im folgenden Verfahren werden die Schritte beschrieben, mit denen Sie die in diesem Handbuch bereitgestellten Codebeispiele testen können.


**Allgemeines Vorgehen zum Erstellen der .NET-Codebeispiele (mit Visual Studio)**  

|  |  | 
| --- |--- |
| 1 | Erstellen Sie ein Anmeldeinformationsprofil für Ihre AWS Anmeldeinformationen, wie im Thema [Konfiguration von AWS Anmeldeinformationen](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/creds-assign.html) für Amazon SDK for .NET beschrieben.  | 
| 2 |  Erstellen Sie ein neues Visual-Studio-Projekt mit der Vorlage *AWS Empty Project*.   | 
| 3 | Ersetzen des Codes in der Projektdatei, `Program.cs`, durch den Code in dem Abschnitt, den Sie gerade lesen.  | 
| 4 |   Führen Sie den Code aus. Stellen Sie sicher, dass das Objekt mit der AWS-Managementkonsole erstellt wurde. Weitere Informationen zu AWS-Managementkonsole finden Sie [unter http://aws.amazon.com/console/](https://aws.amazon.com/console/).  | 

## Festlegen des Endpunkts
<a name="setting-sdk-dot-net-endpoint"></a>

Standardmäßig AWS SDK für .NET legt der als Endpunkt die Region USA West (Oregon) fest (`https://glacier.us-west-2.amazonaws.com`). Sie können den Endpunkt auf andere AWS Regionen festlegen, wie in den folgenden C\$1-Snippets gezeigt.

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

**Example**  

```
AmazonGlacierClient client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2);
```

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

 

```
var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2);
```

Eine aktuelle Liste der unterstützten AWS Regionen und Endpunkte finden Sie unter. [Zugriff auf Amazon Glacier](amazon-glacier-accessing.md)