**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á. # Recuperar metadados do cofre no Amazon Glacier Você pode recuperar informações do cofre, como a data de criação do cofre, o número de arquivos no cofre e o tamanho total de todos os arquivos no cofre. O Amazon Glacier (Amazon Glacier) fornece chamadas de API para você recuperar essas informações para um cofre específico ou para todos os cofres em uma região específica em sua conta. AWS Se você recuperar uma lista de cofres, o Amazon Glacier retornará a lista classificada pelos valores ASCII dos nomes de cofre. A lista contém até 1.000 cofres. Você deve sempre verificar a resposta para um marcador no qual continuar a lista; se não houver mais itens, o campo do marcador será `null`. Você também pode limitar o número de cofres retornados na resposta. Se houver mais cofres do que os retornados na resposta, o resultado será paginado. Você precisa enviar solicitações adicionais para buscar o próximo conjunto de cofres. **Topics** + [Recuperação de metadados do Vault no Amazon Glacier usando o AWS SDK para Java](retrieving-vault-info-sdk-java.md) + [Recuperação de metadados do Vault no Amazon Glacier usando o AWS SDK para .NET](retrieving-vault-info-sdk-dotnet.md) + [Recuperar metadados do cofre usando a API REST](listing-vaults-rest-api.md) + [Recuperar metadados do cofre no Amazon Glacier usando a AWS Command Line Interface](retrieving-vault-info-cli.md) # Recuperação de metadados do Vault no Amazon Glacier usando o AWS SDK para Java **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 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 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 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 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. # Recuperação de metadados do Vault no Amazon Glacier usando o AWS SDK para .NET **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 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 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 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. # Recuperar metadados do cofre usando a API REST Para listar cofres usando a API REST, consulte [List Vaults (GET vaults)](api-vaults-get.md). Para descrever um cofre, consulte [Describe Vault (GET vault)](api-vault-get.md). # Recuperar metadados do cofre no Amazon Glacier usando a AWS Command Line Interface Este exemplo mostra como recuperar informações e metadados do cofre no Amazon Glacier usando a AWS Command Line Interface (AWS CLI). **Topics** + [(Pré-requisito) Configurar a AWS CLI](#Creating-Vaults-CLI-Setup) + [Recuperar metadados do cofre no usando o AWS CLI](#Retrieving-Vault-Metadata-CLI-Implementation) ## (Pré-requisito) Configurar a AWS CLI 1. Faça download e configure a AWS CLI. Para obter instruções, consulte os seguintes tópicos no *Guia do usuário do AWS Command Line Interface*: [Instalar a AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) [Configurando a AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) 1. Verifique a configuração digitando os comandos a seguir no prompt de comando. Esses comandos não fornecem as credenciais explicitamente, de modo que as credenciais do perfil padrão são usadas. + Tente usar o comando de ajuda. ``` aws help ``` + Para obter uma lista dos cofres do Amazon Glacier na conta configurada, use o comando `list-vaults`. Substitua *123456789012* pelo ID da sua Conta da AWS. ``` aws glacier list-vaults --account-id 123456789012 ``` + Para obter os dados da configuração atual para a AWS CLI, use o comando `aws configure list`. ``` aws configure list ``` ## Recuperar metadados do cofre no usando o AWS CLI + Use o comando `describe-vault` para descrever um cofre chamado *awsexamplevault* na conta *111122223333*. ``` aws glacier describe-vault --vault-name awsexamplevault --account-id 111122223333 ```