Esta página destina-se somente a clientes atuais do serviço S3 Glacier que usam cofres e a API REST original de 2012.
Se você estiver procurando soluções de armazenamento de arquivos, sugerimos usar as classes de armazenamento do 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 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á.
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
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.
Tópicos
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 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. Esse AccountId é o ID da Conta da AWS. Esse valor deve corresponder ao ID de 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, |
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 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, consulte Acessar o Amazon S3 Glacier.
