Hochladen eines Archivs in einen Tresor in S3 Glacier mit dem AWS SDK for .NET - Amazon S3 Glacier

Diese Seite richtet sich nur an Bestandskunden des S3 Glacier-Dienstes, die Vaults und das Original 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 Amazon S3API, sind in allen Regionen verfügbar und können in der Amazon S3 S3-Konsole verwaltet werden. Sie bieten Funktionen wie Speicherkostenanalyse, Storage Lens, erweiterte optionale Verschlüsselungsfunktionen 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.

Hochladen eines Archivs in einen Tresor in S3 Glacier mit dem AWS SDK for .NET

Im folgenden C#-Codebeispiel wird die High-Level-API des AWS SDK for .NET zum Hochladen eines Beispielarchivs in den Tresor verwendet. Beachten Sie im Codebeispiel Folgendes:

  • Das Beispiel erstellt eine Instance der ArchiveTransferManager-Klasse für den angegebenen Endpunkt der Amazon-S3-Glacier-Region.

  • In diesem Beispiel wird die Region „USA West (Oregon)“ (us-west-2) verwendet.

  • Im Beispiel wird der API-Vorgang Upload der ArchiveTransferManager-Klasse zum Hochladen des Archivs verwendet. Bei kleinen Archiven lädt dieser Vorgang das Archiv direkt in S3 Glacier hoch. Bei größeren Archiven verwendet der Vorgang die API für den mehrteiligen Upload in S3 Glacier, um den Upload zur besseren Wiederherstellung nach Fehlern in mehrere Teile aufzuteilen, falls beim Streaming der Daten zu S3 Glacier Fehler auftreten sollten.

Eine schrittweise Anleitung zur Ausführung des folgenden Beispiels finden Sie unter Ausführen von Codebeispielen. Sie müssen den Code wie gezeigt mit dem Namen Ihres Tresors und dem Namen des hochzuladenden Archivs aktualisieren.

Anmerkung

S3 Glacier führt eine Inventarliste aller in Ihren Tresoren enthaltenen Archive. Wenn Sie das Archiv im folgenden Beispiel hochladen, wird es in der Managementkonsole erst nach der Aktualisierung des Tresorinventars im Tresor angezeigt. Diese Aktualisierung wird in der Regel einmal täglich durchgeführt.

Beispiel – Hochladen eines Archivs mithilfe der High-Level-API des AWS SDK for .NET
using System;
using Amazon.Glacier;
using Amazon.Glacier.Transfer;
using Amazon.Runtime;

namespace glacier.amazon.com.rproxy.goskope.com.docsamples
{
    class ArchiveUploadHighLevel_GettingStarted
    {
        static string vaultName = "examplevault";
        static string archiveToUpload = "*** Provide file name (with full path) to upload ***";

        public static void Main(string[] args)
        {
            try
            {
                var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2);
                // Upload an archive.
                string archiveId = manager.Upload(vaultName, "getting started archive test", archiveToUpload).ArchiveId;
                Console.WriteLine("Copy and save the following Archive ID for the next step."); 
                Console.WriteLine("Archive ID: {0}", archiveId);
                Console.WriteLine("To continue, press Enter");
                Console.ReadKey();
            }
            catch (AmazonGlacierException e) { Console.WriteLine(e.Message); }
            catch (AmazonServiceException e) { Console.WriteLine(e.Message); }
            catch (Exception e) { Console.WriteLine(e.Message); }
            Console.WriteLine("To continue, press Enter");
            Console.ReadKey();
        }
    }
}