Usando o AWS SDK para .NET com o Amazon Glacier - Amazon Glacier
Usar a API de nível inferiorUsar a API de nível superiorExecutar exemplos do .NETDefinição do endpoint

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

Se você estiver procurando por soluções de armazenamento de arquivos, recomendamos usar as classes de armazenamento Amazon 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 as classes de armazenamento do Amazon Glacier.

O Amazon Glacier (serviço autônomo original baseado em cofre) não aceitará mais novos clientes a partir de 15 de dezembro de 2025, sem impacto para os clientes existentes. O Amazon Glacier é um serviço independente APIs que armazena dados em cofres e é diferente das classes de armazenamento Amazon S3 e Amazon S3 Glacier. Seus dados existentes permanecerão seguros e acessíveis no Amazon Glacier indefinidamente. Nenhuma migração é necessária. Para armazenamento de arquivamento de baixo custo e longo prazo, AWS recomenda as classes de armazenamento Amazon S3 Glacier, que oferecem uma experiência superior ao cliente com APIs base em buckets S3, disponibilidade Região da AWS total, custos mais baixos e integração de serviços. AWS Se você quiser recursos aprimorados, considere migrar para as classes de armazenamento do Amazon S3 Glacier usando AWS nossa orientação de soluções para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier.

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

Usando o AWS SDK para .NET com o Amazon Glacier

A AWS SDK para .NET API está disponível emAWSSDK.dll. Para obter informações sobre como baixar o AWS SDK para .NET, acesse Bibliotecas de códigos de amostra. Conforme descrito emUsando o AWS SDKs com o Amazon Glacier, o AWS SDK para .NET fornece tanto o nível alto quanto o nível baixo APIs.

nota

A API de baixo nível e a API de alto nível fornecem clientes seguros para acessar o Amazon Glacier. De acordo com as melhores práticas, seus aplicativos devem criar um único cliente e reutilizá-lo entre os threads.

Usar a API de nível inferior

A AmazonGlacierClient classe de baixo nível fornece todos os métodos que mapeiam as operações REST subjacentes do Amazon Glacier (Amazon Glacier) (). Referência de API para Amazon Glacier Ao chamar qualquer um desses métodos, você deve criar um objeto de solicitação correspondente e fornecer um objeto de resposta no qual o método possa retornar uma resposta do Amazon Glacier à operação.

Por exemplo, a classe AmazonGlacierClient fornece o método CreateVault para criar um cofre. Esse método é mapeado para a operação REST Create Vault (consulte Create Vault (PUT vault)). Para usar esse método, você deve criar instâncias das CreateVaultResponse classes CreateVaultRequest e para fornecer informações de solicitação e receber uma resposta do Amazon Glacier, conforme mostrado no seguinte trecho de código C#:

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

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

CreateVaultResponse response = client.CreateVault(request);

Todos os exemplos de nível inferior no guia usam esse padrão.

nota

O segmento do código anterior especifica AccountId durante a criação da solicitação. No entanto, ao usar o AWS SDK para .NET, o AccountId na solicitação é opcional e, portanto, todos os exemplos de baixo nível neste guia não definem esse valor. Esse AccountId é o Conta da AWS ID. Esse valor deve corresponder ao Conta da AWS ID associado às credenciais usadas para assinar a solicitação. Você pode especificar o Conta da AWS ID ou, opcionalmente, um '-'. Nesse caso, o Amazon Glacier usa Conta da AWS o ID associado às credenciais usadas para assinar a solicitação. Se você especificar o ID da conta, não inclua hifens nele. Ao usar AWS SDK para .NET, se você não fornecer o ID da conta, a biblioteca definirá o ID da conta como '-'.

Usar a API de nível superior

Para simplificar ainda mais o desenvolvimento de seu aplicativo, o AWS SDK para .NET fornece a ArchiveTransferManager classe que implementa uma abstração de alto nível para alguns dos métodos na API de baixo nível. Ele fornece métodos úteis, como Upload e Download, para as operações de arquivo.

Por exemplo, o trecho de código do C# a seguir usa o método de nível superior Upload para fazer upload de um arquivo. 

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;

Observe que todas as operações realizadas se aplicam à AWS região especificada ao criar o ArchiveTransferManager objeto. Todos os exemplos de nível superior neste guia usam esse padrão.

nota

A classe ArchiveTransferManager de nível superior ainda precisa do cliente AmazonGlacierClient de nível inferior, que você pode passar explicitamente, ou o ArchiveTransferManager criará o cliente.

Executar exemplos de código

A maneira mais fácil de começar a usar os exemplos de código .NET é instalar o AWS SDK para .NET. Para mais informações, acesse Amazon SDK para .NET.

O procedimento a seguir descreve as etapas para você testar os exemplos de código fornecidos neste guia.

Processo geral de criação dos exemplos de código do .NET (usando o Visual Studio)

1

Crie um perfil de credenciais para suas AWS credenciais, conforme descrito no tópico Configuração de credenciais do Amazon SDK for .NET. AWS

2

Crie um novo projeto do Visual Studio usando o modelo AWS Projeto Vazio.

3

Substitua o código no arquivo do projeto, Program.cs, com o código da seção que você está lendo.

4

Execute o código. Verifique se o objeto é criado usando o Console de gerenciamento da AWS. Para obter mais informações sobre Console de gerenciamento da AWS, acesse http://aws.amazon.com/console/.

Definição do endpoint

Por padrão, AWS SDK para .NET define o endpoint para a região Oeste dos EUA (Oregon) (https://glacier.us-west-2.amazonaws.com). Você pode definir o endpoint para outras AWS regiões, conforme mostrado nos trechos de C# a seguir.

O trecho de código a seguir mostra como definir o endpoint para a região Oeste dos EUA (Oregon) (us-west-2) na API de nível inferior.

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

O trecho de código a seguir mostra como definir o endpoint para a região oeste dos EUA (Oregon) na API de nível superior.

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

Para obter uma lista atual de AWS regiões e endpoints compatíveis, consulteAcessando o Amazon Glacier.