Recuperar metadados do cofre no usando o AWS SDK for .NET - Amazon S3 Glacier

Se você for novato no armazenamento de arquivo no Amazon Simple Storage Service (Amazon S3), recomendamos que comece aprendendo mais sobre as classes de armazenamento do S3 Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para obter mais informações, consulte Classes de armazenamento S3 Glacier e Classes de armazenamento para arquivamento de objetos no Guia do usuário do Amazon S3.

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

Recuperar metadados do cofre no usando o AWS SDK for .NET

Recuperar metadados de um cofre

Você pode recuperar metadados de um cofre específico ou de todos os cofres em uma região AWS específica. Estas são as etapas para recuperar metadados de um cofre específico usando a API de nível inferior do AWS SDK for .NET.

  1. Crie uma instância da classe AmazonGlacierClient (o cliente).

    Você precisa especificar uma região AWS onde o cofre reside. Todas as operações realizadas por você usando esse cliente se aplicam a essa região AWS.

  2. Forneça informações sobre a solicitação criando uma instância da classe DescribeVaultRequest.

    O Amazon S3 Glacier (S3 Glacier) exige que você forneça um nome de cofre e o ID da conta. Se você não fornecer um ID da conta, o ID da conta associado às credenciais fornecidas por você para assinar a solicitação será pressuposto. Para obter mais informações, consulte Como usar o AWS SDK for .NET com o Amazon S3 Glacier .

  3. Execute o método DescribeVault fornecendo o objeto de solicitação como um parâmetro.

    As informações de metadados de cofre retornadas pelo S3 Glacier; estão disponíveis no objetoDescribeVaultResult.

O trecho de código do C# a seguir ilustra as etapas anteriores. O trecho recupera informações de metadados de um cofre existente na região oeste dos EUA (Oregon) .

AmazonGlacierClient client; client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2); DescribeVaultRequest describeVaultRequest = new DescribeVaultRequest() { VaultName = "*** Provide vault name ***" }; DescribeVaultResponse describeVaultResponse = client.DescribeVault(describeVaultRequest); Console.WriteLine("\nVault description..."); Console.WriteLine( "\nVaultName: " + describeVaultResponse.VaultName + "\nVaultARN: " + describeVaultResponse.VaultARN + "\nVaultCreationDate: " + describeVaultResponse.CreationDate + "\nNumberOfArchives: " + describeVaultResponse.NumberOfArchives + "\nSizeInBytes: " + describeVaultResponse.SizeInBytes + "\nLastInventoryDate: " + describeVaultResponse.LastInventoryDate );

nota

Para obter informações sobre a API REST subjacente, consulte Describe Vault (GET vault).

Recuperar metadados de todos os cofres em uma região

Você também pode usar o método ListVaults para recuperar metadados de todos os cofres em uma região específica.

O trecho de código do C# recupera uma lista de cofres na egião oeste dos EUA (Oregon). A solicitação limita o número de cofres retornados na resposta a 5. Em seguida, o trecho de código faz uma série de chamadas ListVaults para recuperar toda a lista de cofres da região.

AmazonGlacierClient client; client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2); string lastMarker = null; Console.WriteLine("\n List of vaults in your account in the specific AWS Region ..."); do { ListVaultsRequest request = new ListVaultsRequest() { Limit = 5, Marker = lastMarker }; ListVaultsResponse response = client.ListVaults(request); foreach (DescribeVaultOutput output in response.VaultList) { Console.WriteLine("Vault Name: {0} \tCreation Date: {1} \t #of archives: {2}", output.VaultName, output.CreationDate, output.NumberOfArchives); } lastMarker = response.Marker; } while (lastMarker != null);

No segmento de código anterior, se você não especificar o valor Limit na solicitação, o S3 Glacier retornará até 10 cofres, conforme definido pela API do S3 Glacier.

As informações retornadas para cada cofre na lista são as mesmas obtidas por você chamando o método DescribeVault para um cofre específico.

nota

O método ListVaults chama a API REST subjacente (consulte List Vaults (GET vaults)).

Exemplo: recuperar metadados de cofre usando a API de nível inferior do AWS SDK for .NET

Para obter um exemplo de código funcional, consulte Exemplo: operações de cofre usando a API de nível inferior do AWS SDK for .NET. O exemplo de código do C# cria um cofre e recupera os metadados do cofre.