**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á. # List Vaults (GET vaults) ## Descrição Essa operação lista todos os cofres próprios chamando a conta do usuário. A lista retornada na resposta é classificada por nome de cofre ASCII. Por padrão, essa operação retorna até 10 itens por solicitação. Se houver mais cofres a serem listados, o campo `marker` no corpo da resposta conterá o Amazon Resource Name (ARN – Nome de recurso da Amazon) do cofre no qual deve continuar a lista com uma nova solicitação List Vaults; do contrário, o campo `marker` será `null`. Na próxima solicitação List Vaults, defina o parâmetro `marker` como o valor retornado pelo Amazon Glacier nas respostas à solicitação List Vaults anterior. Você também pode limitar o número de cofres retornados na resposta especificando o parâmetro `limit` na solicitação. ## Solicitações Para obter uma lista de cofres, envie uma solicitação `GET` para o recurso *cofres*. ### Sintaxe ``` 1. GET /AccountId/vaults HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 ``` **nota** O valor de `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. Você pode especificar um ID da Conta da AWS ou, de opcionalmente, um '`-`' (hífen) único. Nesse caso, o Amazon Glacier usa o ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Se você especificar o ID da conta, não inclua nenhum hífen ('-') no ID. ### Parâmetros da solicitação Esta operação usa os parâmetros de solicitação a seguir. | Nome | Descrição | Obrigatório | | --- | --- | --- | | limit | O número máximo de cofres a serem retornados. O limite padrão é 10. O número de cofres retornados pode ser menor que o limite especificado, mas o número de cofres retornados jamais excede o limite. Tipo: string Restrições: valor do inteiro mínimo de 1. Valor do inteiro máximo de 10. | Não | | marker | Uma string usada na paginação. `marker` especifica o ARN do cofre com o qual a listagem de cofres deve começar. (O cofre especificado por `marker` não está incluído na lista retornada.) Obtenha o valor `marker` de uma resposta List Vaults anterior. Você precisará incluir o `marker` somente se continuar a paginação dos resultados iniciada em uma solicitação List Vaults anterior. Especificar um valor vazio ("") para o marcador retorna uma lista de cofres a partir do primeiro cofre. Tipo: string Restrições: nenhuma | Não | ### Cabeçalhos de solicitação Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte [Cabeçalhos de solicitação comuns](api-common-request-headers.md). ### Corpo da Solicitação Essa operação não tem um corpo de solicitação. ## Respostas ### Sintaxe ``` HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "Marker": String "VaultList": [ { "CreationDate": String, "LastInventoryDate": String, "NumberOfArchives": Number, "SizeInBytes": Number, "VaultARN": String, "VaultName": String }, ... ] } ``` ### Cabeçalhos de resposta Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md). ### Corpo da resposta O corpo da resposta contém os seguintes campos JSON. **CreationDate** A data em que o cofre foi criado, em Coordinated Universal Time (UTC – Tempo universal coordenado). *Tipo*: string Uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`. **LastInventoryDate** A data do inventário de cofre mais recente, em UTC. Esse campo poderá ser nulo se um inventário ainda não tiver sido executado no cofre; por exemplo, se você tiver acabado de criar o cofre. Para obter mais informações sobre como iniciar um inventário para um cofre, consulte [Initiate Job (trabalhos POST)](api-initiate-job-post.md). *Tipo*: uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`. **Marker** O `vaultARN` que representa onde continuar a paginação dos resultados. Você usa o `marker` em outra solicitação List Vaults para obter mais cofres na lista. Se não houver cofres, esse valor será `null`. *Tipo:* string **NumberOfArchives** O número de arquivos no cofre desde a data do último inventário de cofre. *Tipo*: número **SizeInBytes** O tamanho total, em bytes, de todos os arquivos no cofre, inclusive eventuais custos indiretos por arquivo, desde a data do último inventário. *Tipo*: número **VaultARN** O nome de recurso da Amazon (ARN) do cofre. *Tipo:* string **VaultList** Uma matriz de objetos, com cada objeto apresentando uma descrição de um cofre. *Tipo*: matriz **VaultName** O nome do cofre. *Tipo:* string ### Erros Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md). ## Exemplos ### Exemplo: List All Vaults O exemplo a seguir lista os cofres. Como os parâmetros `marker` e `limit` não são especificados na solicitação, até 10 cofres são retornados. #### Exemplo de solicitação ``` 1. GET /-/vaults HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` #### Exemplo de resposta O `Marker` é `null`, o que indica não haver mais cofres a serem listados. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: 497 6. 7. { 8. "Marker": null, 9. "VaultList": [ 10. { 11. "CreationDate": "2012-03-16T22:22:47.214Z", 12. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 13. "NumberOfArchives": 2, 14. "SizeInBytes": 12334, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1", 16. "VaultName": "examplevault1" 17. }, 18. { 19. "CreationDate": "2012-03-19T22:06:51.218Z", 20. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 21. "NumberOfArchives": 0, 22. "SizeInBytes": 0, 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2", 24. "VaultName": "examplevault2" 25. }, 26. { 27. "CreationDate": "2012-03-19T22:06:51.218Z", 28. "LastInventoryDate": "2012-03-25T12:14:31.121Z", 29. "NumberOfArchives": 0, 30. "SizeInBytes": 0, 31. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3", 32. "VaultName": "examplevault3" 33. } 34. ] 35. } ``` ### Exemplo: Partial List of Vaults O exemplo a seguir retorna dois cofres começando pelo cofre especificado pelo `marker`. #### Exemplo de solicitação ``` 1. GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` #### Exemplo de resposta Dois cofres são retornados na lista. O `Marker` contém o ARN do cofre para continuar a paginação em outra solicitação List Vaults. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: 497 6. 7. { 8. "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3", 9. "VaultList": [ 10. { 11. "CreationDate": "2012-03-16T22:22:47.214Z", 12. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 13. "NumberOfArchives": 2, 14. "SizeInBytes": 12334, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1", 16. "VaultName": "examplevault1" 17. }, 18. { 19. "CreationDate": "2012-03-19T22:06:51.218Z", 20. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 21. "NumberOfArchives": 0, 22. "SizeInBytes": 0, 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2", 24. "VaultName": "examplevault2" 25. } 26. ] 27. } ``` ## Seções relacionadas + [Create Vault (PUT vault)](api-vault-put.md) + [Delete Vault (DELETE vault)](api-vault-delete.md) + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) + [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md) ## Consulte também Para obter mais informações sobre como usar essa API em um dos Amazon SDKs específicos de linguagem, consulte o seguinte: + [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/list-vaults.html)