Fazer upload de um arquivo para um cofre no S3 Glacier usando AWS SDK for .NET - Amazon S3 Glacier

Esta página é somente para clientes existentes do serviço S3 Glacier que usam o Vaults e o original de 2012. REST API

Se você estiver procurando por soluções de armazenamento de arquivamento, sugerimos usar as classes de armazenamento S3 Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para saber mais sobre essas opções de armazenamento, consulte Classes de armazenamento S3 Glacier e Armazenamento de dados de longo prazo usando classes de armazenamento S3 Glacier no Guia do usuário do Amazon S3. Essas classes de armazenamento usam o Amazon S3API, estão disponíveis em todas as regiões e podem ser gerenciadas no console do Amazon S3. Eles oferecem recursos como análise de custos de armazenamento, lente de armazenamento, recursos avançados de criptografia opcional e muito mais.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Fazer upload de um arquivo para um cofre no S3 Glacier usando AWS SDK for .NET

O exemplo de código do C# a seguir usa a API de nível superior do AWS SDK for .NET para fazer upload do arquivo de amostra para o cofre. No exemplo de código, observe o seguinte:

  • O exemplo cria uma instância da classe ArchiveTransferManager para o endpoint especificado da região do Amazon S3 Glacier.

  • Esse exemplo usa a região Oeste dos EUA (Oregon) us-west-2.

  • O exemplo usa a operação Upload da classe ArchiveTransferManager para fazer upload do arquivo. Para arquivos pequenos, esse método faz upload do arquivo diretamente no S3 Glacier. Para arquivos maiores, esta operação usa a operação de API de multipart upload no S3 Glacier para dividir o upload em várias partes para melhor recuperação de erros, se algum erro for encontrado durante o streaming dos dados para o S3 Glacier.

Para obter instruções passo a passo sobre como executar o exemplo a seguir, consulte Executar exemplos de código. Você precisa atualizar o código conforme mostrado com o nome do cofre e o nome do arquivo do qual deve ser feito upload.

nota

O S3 Glacier mantém um inventário de todos os arquivos nos cofres. Quando você fizer upload do arquivo no exemplo a seguir, ele não será exibido em um cofre no console de gerenciamento até o inventário de cofre ter sido atualizado. Essa atualização normalmente acontece uma vez por dia.

exemplo Fazer upload de um arquivo usando a API de nível superior do 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();
        }
    }
}