Abrufen von Tresormetadaten in Amazon S3 Glacier mit AWS SDK for .NET - Amazon S3 Glacier
Abrufen von Tresor-Metadaten für einen TresorAbrufen von Tresor-Metadaten für alle Tresore in einer RegionBeispiel: Tresorvorgänge bei Verwendung von .NET

Diese Seite richtet sich nur an Bestandskunden des S3 Glacier-Dienstes, die Vaults und die ursprüngliche REST-API von 2012 verwenden.

Wenn Sie nach Archivspeicherlösungen suchen, empfehlen wir die Verwendung der S3 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 S3 Glacier-Speicherklassen und Langfristige Datenspeicherung mit S3 Glacier-Speicherklassen im Amazon S3 S3-Benutzerhandbuch. Diese Speicherklassen verwenden die Amazon S3 S3-API, sind in allen Regionen verfügbar und können in der Amazon S3 S3-Konsole verwaltet werden. Sie bieten Funktionen wie Speicherkostenanalyse, Storage Lens, Sicherheitsfunktionen einschließlich mehrerer Verschlüsselungsoptionen und mehr.

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.

Abrufen von Tresormetadaten in Amazon S3 Glacier mit AWS SDK for .NET

Abrufen von Tresor-Metadaten für einen Tresor

Sie können Metadaten für einen bestimmten Tresor oder für alle Tresore in einer bestimmten AWS-Region abrufen. Nachfolgend werden die Schritte zum Abrufen der Tresor-Metadaten für einen bestimmten Tresor mithilfe der Low-Level-API von AWS SDK for .NET beschrieben.

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

    Sie müssen eine AWS-Region angeben, in der sich der Tresor befindet. Alle Operationen, die Sie mit diesem Client ausführen, gelten für diese AWS-Region.

  2. Um die Anforderungsinformationen bereitzustellen, erstellen Sie eine Instance der DescribeVaultRequest-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 Anforderung verwenden. Weitere Informationen finden Sie unter Verwenden von AWS SDK for .NET mit Amazon S3 Glacier.

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

    Die von S3 Glacier zurückgegebenen Tresormetadaten sind im DescribeVaultResult-Objekt verfügbar.

Der folgende C#-Codeausschnitt veranschaulicht die vorherigen Schritte. Im Codeausschnitt werden Metadateninformationen eines vorhandenen Tresors in der Region „USA West (Oregon)“ abgerufen. 

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

DescribeVaultRequest describeVaultRequest = new DescribeVaultRequest()
{
  VaultName = "*** Provide vault name ***"
};  
DescribeVaultResponse describeVaultResponse = client.DescribeVault(describeVaultRequest);
Console.WriteLine("\nVault description...");
Console.WriteLine(
   "\nVaultName: " + describeVaultResponse.VaultName +
   "\nVaultARN: " + describeVaultResponse.VaultARN +
   "\nVaultCreationDate: " + describeVaultResponse.CreationDate +
   "\nNumberOfArchives: " + describeVaultResponse.NumberOfArchives +
   "\nSizeInBytes: " + describeVaultResponse.SizeInBytes +
   "\nLastInventoryDate: " + describeVaultResponse.LastInventoryDate 
   );

Anmerkung

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

Abrufen von Tresor-Metadaten für alle Tresore in einer Region

Sie können auch die ListVaults-Methode verwenden, um Metadaten für alle Tresore in einer bestimmten AWS-Region abzurufen.

Mit dem folgenden C#-Codeausschnitt wird eine Liste der Tresore in der Region „USA West (Oregon)“ abgerufen. Die Anzahl der bei der Anforderung zurückgegebenen Tresore ist auf 5 beschränkt. Der Codeausschnitt führt danach eine Reihe von ListVaults-Aufrufen aus, um die gesamte Tresorliste aus der AWS-Region abzurufen. 

AmazonGlacierClient client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2);
string lastMarker = null;
Console.WriteLine("\n List of vaults in your account in the specific AWS Region ...");
do
{
  ListVaultsRequest request = new ListVaultsRequest()
  {
    Limit = 5,
    Marker = lastMarker
  };
  ListVaultsResponse response = client.ListVaults(request);
   
  foreach (DescribeVaultOutput output in response.VaultList)
  {
    Console.WriteLine("Vault Name: {0} \tCreation Date: {1} \t #of archives: {2}",
                      output.VaultName, output.CreationDate, output.NumberOfArchives); 
  }
  lastMarker = response.Marker;
} while (lastMarker != null);

Wenn Sie im vorhergehenden Codesegment den Wert Limit in der Anforderung nicht angeben, gibt S3 Glacier bis zu 10 Tresore zurück, wie durch die S3-Glacier-API festgelegt.

Beachten Sie, dass die Informationen, die in der Liste für jeden Tresor zurückgegeben werden, mit den Informationen übereinstimmen, die Sie durch Aufrufen der DescribeVault-Methode für einen bestimmten Tresor erhalten.

Anmerkung

Durch die ListVaults-Methode wird die zugrunde liegende REST-API aufgerufen (siehe List Vaults (GET vaults)).

Beispiel: Abrufen von Tresor-Metadaten mit der Low-Level-API von AWS SDK for .NET

Ein funktionierendes Codebeispiel finden Sie unter Beispiel: Tresorvorgänge bei Verwendung der Low-Level-API von AWS SDK for .NET. Der folgende C#-Beispielcode erstellt einen Tresor und ruft die Tresor-Metadaten ab.