**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 Java
<a name="retrieving-vault-info-sdk-java"></a>

**Topics**
+ [Recuperar metadados de um cofre](#retrieve-vault-info-sdk-java-lowlevel-one-vault)
+ [Recuperar metadados de todos os cofres em uma região](#retrieve-vault-info-sdk-java-lowlevel-all-vaults)
+ [Exemplo: recuperar metadados de cofre usando o Amazon SDK para Java](#retrieving-vault-info-sdk-java-example)

## Recuperar metadados de um cofre
<a name="retrieve-vault-info-sdk-java-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 Amazon SDK para Java. 

 

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 [Usando o AWS SDK para Java com o Amazon Glacier](using-aws-sdk-for-java.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 Java a seguir ilustra as etapas anteriores. 

```
DescribeVaultRequest request = new DescribeVaultRequest()
	.withVaultName("*** provide vault name***");

DescribeVaultResult result = client.describeVault(request);

System.out.print(
        "\nCreationDate: " + result.getCreationDate() +
        "\nLastInventoryDate: " + result.getLastInventoryDate() +
        "\nNumberOfArchives: " + result.getNumberOfArchives() + 
        "\nSizeInBytes: " + result.getSizeInBytes() + 
        "\nVaultARN: " + result.getVaultARN() + 
        "\nVaultName: " + result.getVaultName());
```

 

**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-java-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 Java a seguir recupera uma lista de cofres na região `us-west-2`. 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.setEndpoint("https://glacier.us-west-2.amazonaws.com/");

String marker = null;
do {            
    ListVaultsRequest request = new ListVaultsRequest()
        .withLimit("5")
        .withMarker(marker);
    ListVaultsResult listVaultsResult = client.listVaults(request);
    
    List<DescribeVaultOutput> vaultList = listVaultsResult.getVaultList();
    marker = listVaultsResult.getMarker();
    for (DescribeVaultOutput vault : vaultList) {
        System.out.println(
                "\nCreationDate: " + vault.getCreationDate() +
                "\nLastInventoryDate: " + vault.getLastInventoryDate() +
                "\nNumberOfArchives: " + vault.getNumberOfArchives() + 
                "\nSizeInBytes: " + vault.getSizeInBytes() + 
                "\nVaultARN: " + vault.getVaultARN() + 
                "\nVaultName: " + vault.getVaultName()); 
    }
} while (marker != 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. Se houver mais cofres a serem listados, o campo `marker` de resposta conterá o nome de recurso da Amazon (ARN) do cofre no qual deve continuar a lista com uma nova solicitação; do contrário, o campo `marker` será nulo. 

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: recuperar metadados de cofre usando o Amazon SDK para Java
<a name="retrieving-vault-info-sdk-java-example"></a>

Para obter um exemplo de código funcional, consulte [Exemplos: como criar um cofre usando a AWS SDK para Java](creating-vaults-sdk-java.md#creating-vaults-sdk-java-example). O exemplo de código do Java cria um cofre e recupera os metadados do cofre.