Verwenden von AWS SDK für .NET mit Amazon Glacier

Die AWS SDK für .NET API ist verfügbar inAWSSDK.dll. Informationen zum Herunterladen von finden Sie unter Beispielcodebibliotheken. AWS SDK für .NET Wie unter beschriebenVerwenden von AWS SDKs mit Amazon Glacier, 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.

Verwenden der Low-Level-API

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) 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)). 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#-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

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#-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

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.

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 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 Management Console erstellt wurde. Weitere Informationen zu AWS Management Console finden Sie unter http://aws.amazon.com/console/.

Festlegen des Endpunkts

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#-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.

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. Zugreifen auf Amazon Glacier