Como usar o AWS SDK for .NET com o Amazon S3 Glacier

A API do AWS SDK for .NET está disponível em AWSSDK.dll. Para obter informações sobre como fazer download do AWS SDK for .NET, acesse Bibliotecas de códigos de exemplo. Conforme descrito em Usando os AWS SDKs com o Amazon S3 Glacier, o AWS SDK for .NET fornece APIs de alto nível e de baixo nível.

nota

As APIs de nível inferior e superior fornecem clientes thread-safe para acessar o S3 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 classe AmazonGlacierClient de nível inferior fornece todos os métodos mapeados para as operações REST subjacentes do Amazon S3 Glacier (S3 Glacier) (Referência de API para Amazon S3 Glacier). Ao chamar qualquer um desses métodos, deve ser criado um objeto de solicitação correspondente e fornecer um objeto de resposta no qual o método possa retornar uma resposta S3 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, crie instâncias das classes CreateVaultRequest e CreateVaultResponse classes para fornecer informações de solicitação e receber uma resposta do S3 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, durante o uso do AWS SDK for .NET, o AccountId na solicitação é opcional e, assim, todos os exemplos de baixo nível neste guia não definem esse valor. O AccountId é o Conta da AWS ID. Esse valor deve corresponder ao ID Conta da AWS associado às credenciais usadas para assinar a solicitação. Especifique o Conta da AWS ID ou opcionalmente um '-', nesse caso, o S3 Glacier usa o Conta da AWS ID associado às credenciais usadas para assinar a solicitação. Se você especificar o ID da conta, não inclua hifens nele. Ao usar o AWS SDK for .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 do aplicativo, o AWS SDK for .NET fornece a classe ArchiveTransferManager 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;

Todas as operações realizadas por você 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 for .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.

1	Crie um perfil de credenciais para suas AWS credenciais conforme descrito no tópico Amazon SDK para .NET Como configurar AWS credenciais.
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 AWS Management Console. Para obter mais informações sobre o AWS Management Console, acesse https://aws.amazon.com/console/.

Definição do endpoint

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

O trecho de código a seguir mostra como definir o endpoint para a região (us-west-2) Oeste dos EUA (Oregon) 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, consulte Acessar o Amazon S3 Glacier.