**Esta página destina-se somente a clientes atuais do serviço Amazon Glacier que usam cofres e a API REST original de 2012.**

Se você estiver procurando soluções de armazenamento de arquivos do Amazon Glacier, recomendamos usar as classes de armazenamento do 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 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

O Amazon Glacier (serviço autônomo original baseado em cofre) não está mais aceitando novos clientes. 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](https://aws.amazon.com/s3/storage-classes/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 nossas [Orientações de soluções da AWS para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-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á.

# Recuperação de metadados do Vault no Amazon Glacier usando o AWS SDK para .NET
<a name="retrieving-vault-info-sdk-dotnet"></a>

**Topics**
+ [Recuperar metadados de um cofre](#retrieve-vault-info-sdk-dotnet-lowlevel-one-vault)
+ [Recuperar metadados de todos os cofres em uma região](#retrieve-vault-info-sdk-dotnet-lowlevel-all-vaults)
+ [Exemplo: Recuperação de metadados do Vault usando a API de baixo nível do AWS SDK para .NET](#creating-vaults-sdk-dotnet-example)

## Recuperar metadados de um cofre
<a name="retrieve-vault-info-sdk-dotnet-lowlevel-one-vault"></a>

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

 

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

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

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

   O Amazon 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 para .NET com o Amazon Glacier](using-aws-sdk-for-dot-net.md).

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

   As informações de metadados de cofre retornadas pelo Amazon Glacier estão disponíveis no objeto `DescribeVaultResult`.

O trecho de código do C\$1 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)](api-vault-get.md). 

## Recuperar metadados de todos os cofres em uma região
<a name="retrieve-vault-info-sdk-dotnet-lowlevel-all-vaults"></a>

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

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

 

```
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 Amazon Glacier retornará até 10 cofres, conforme definido pela API do Amazon 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)](api-vaults-get.md)). 

## Exemplo: Recuperação de metadados do Vault usando a API de baixo nível do AWS SDK para .NET
<a name="creating-vaults-sdk-dotnet-example"></a>

Para obter um exemplo de código funcional, consulte [Exemplo: operações do Vault usando a API de baixo nível do AWS SDK para .NET](creating-vaults-dotnet-sdk.md#vault-operations-example-dotnet-lowlevel). O exemplo de código do C\$1 cria um cofre e recupera os metadados do cofre.