Utilizzo di AWS SDK per .NET con Amazon Glacier - Amazon Glacier
Utilizzo dell'API di basso livelloUtilizzo dell'API di alto livelloEsecuzione di esempi .NETImpostazione dell'endpoint

Questa pagina è riservata ai clienti esistenti del servizio Amazon Glacier che utilizzano Vaults e l'API REST originale del 2012.

Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage Amazon Glacier in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Per ulteriori informazioni su queste opzioni di storage, consulta le classi di storage di Amazon Glacier.

Amazon Glacier (servizio autonomo originale basato su vault) non accetterà più nuovi clienti a partire dal 15 dicembre 2025, senza alcun impatto sui clienti esistenti. Amazon Glacier è un servizio APIs autonomo che archivia i dati in vault ed è distinto dalle classi di storage Amazon S3 e Amazon S3 Glacier. I dati esistenti rimarranno sicuri e accessibili in Amazon Glacier a tempo indeterminato. Non è richiesta alcuna migrazione. Per uno storage di archiviazione a lungo termine a basso costo, AWS consiglia le classi di storage Amazon S3 Glacier, che offrono un'esperienza cliente superiore con disponibilità Regione AWS completa, costi inferiori e integrazione dei servizi APIs basata su bucket S3. AWS Se desideri funzionalità avanzate, prendi in considerazione la migrazione alle classi di storage Amazon S3 Glacier utilizzando la AWS nostra Solutions Guidance per il trasferimento di dati dai vault Amazon Glacier alle classi di storage Amazon S3 Glacier.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo di AWS SDK per .NET con Amazon Glacier

L' AWS SDK per .NET API è disponibile in. AWSSDK.dll Per informazioni sul download di AWS SDK per .NET, vai a Sample Code Libraries. Come descritto inUtilizzo di AWS SDKs con Amazon Glacier, AWS SDK per .NET fornisce sia il livello alto che quello basso APIs.

Nota

L'API di basso livello e l'API di alto livello forniscono client thread-safe per l'accesso ad Amazon Glacier. Come best practice, le tue applicazioni dovrebbero creare un client e riutilizzarlo tra i thread.

Utilizzo dell'API di basso livello

La AmazonGlacierClient classe di basso livello fornisce tutti i metodi associati alle operazioni REST sottostanti di Amazon Glacier (Amazon Glacier) (). Riferimento API per Amazon Glacier Quando chiami uno di questi metodi, devi creare un oggetto di richiesta corrispondente e fornire un oggetto di risposta in cui il metodo possa restituire una risposta Amazon Glacier all'operazione.

Ad esempio, la classe AmazonGlacierClient fornisce il metodo CreateVault per creare una vault. Questo metodo esegue la mappatura all'operazione REST Create Vault sottostante (vedi Create Vault (PUT vault)). Per utilizzare questo metodo, devi creare istanze delle CreateVaultResponse classi CreateVaultRequest and per fornire informazioni sulla richiesta e ricevere una risposta Amazon Glacier come mostrato nel seguente frammento di codice C#:

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

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

CreateVaultResponse response = client.CreateVault(request);

Tutti gli esempi di basso livello nella guida utilizzano questo modello.

Nota

Il segmento di codice precedente specifica AccountId quando si crea la richiesta. Tuttavia, quando si utilizza il AWS SDK per .NET, la AccountId nella richiesta è facoltativa e pertanto tutti gli esempi di basso livello in questa guida non impostano questo valore. AccountIdQuesto è l' Account AWS ID. Questo valore deve corrispondere all' Account AWS ID associato alle credenziali utilizzate per firmare la richiesta. Puoi specificare l' Account AWS ID o, facoltativamente, un «-», nel qual caso Amazon Glacier Account AWS utilizza l'ID associato alle credenziali utilizzate per firmare la richiesta. Se specifichi l'ID del tuo account, non includere trattini nell'ID. Quando si utilizza AWS SDK per .NET, se non si fornisce l'ID dell'account, la libreria imposta l'ID dell'account su '-'.

Utilizzo dell'API di alto livello

Per semplificare ulteriormente lo sviluppo dell'applicazione, AWS SDK per .NET fornisce la ArchiveTransferManager classe che implementa un'astrazione di livello superiore per alcuni metodi dell'API di basso livello. Questa classe offre metodi utili, ad esempio Upload e Download, per le operazioni di archivio.

Ad esempio, il frammento di codice C# seguente utilizza il metodo Upload di alto livello per caricare un archivio. 

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;

Nota che tutte le operazioni eseguite si applicano alla AWS regione specificata durante la creazione dell'oggetto. ArchiveTransferManager Tutti gli esempi di alto livello in questa guida utilizzano questo modello.

Nota

La classe ArchiveTransferManager di alto livello necessita ancora del client AmazonGlacierClient di basso livello, che puoi passare in modo esplicito, altrimenti ArchiveTransferManager crea il client.

Esecuzione di esempi di codice

Il modo più semplice di iniziare a utilizzare i codici di esempio .NET è installare l' AWS SDK per .NET. Per ulteriori informazioni, consulta Amazon SDK per .NET.

La procedura seguente ti consente di testare gli esempi di codice forniti in questa guida.

Procedura generale per la creazione di esempi di codice .NET (mediante Visual Studio)

1

Crea un profilo di credenziali per AWS le tue credenziali come descritto nell'argomento Amazon SDK for .NET Configurazione delle credenziali. AWS

2

Crea un nuovo progetto di Visual Studio utilizzando il modello Progetto AWS vuoto.

3

Sostituire il codice nel file di progetto, Program.cs, con il codice riportato nella sezione che si sta leggendo.

4

Eseguire il codice. Verificare l'avvenuta creazione dell'oggetto utilizzando la Console di gestione AWS. Per ulteriori informazioni su Console di gestione AWS, vai a http://aws.amazon.com/console/.

Impostazione dell'endpoint

Per impostazione predefinita, AWS SDK per .NET imposta l'endpoint sulla regione Stati Uniti occidentali (Oregon) (https://glacier.us-west-2.amazonaws.com). È possibile impostare l'endpoint su altre AWS regioni, come illustrato nei seguenti frammenti di C#.

Il frammento seguente mostra come impostare l'endpoint sulla regione Stati Uniti occidentali (Oregon) (us-west-2) nell'API di basso livello.

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

Il frammento seguente mostra come impostare l'endpoint sulla regione Stati Uniti occidentali (Oregon) nell'API di alto livello.

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

Per un elenco aggiornato delle AWS regioni e degli endpoint supportati, consulta. Accesso ad Amazon Glacier