List Vaults (GET vaults) - Amazon Glacier
DescriçãoSolicitaçõesRespostasExemplosSeções relacionadasConsulte também

Esta página é somente para clientes atuais do serviço Amazon Glacier que usam Vaults e a API REST original de 2012.

Se você estiver procurando por soluções de armazenamento de arquivos, recomendamos usar as classes de armazenamento Amazon Glacier no 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 as classes de armazenamento do Amazon Glacier.

O Amazon Glacier (serviço autônomo original baseado em cofre) não aceitará mais novos clientes a partir de 15 de dezembro de 2025, sem impacto para os clientes existentes. 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, 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 AWS nossa orientação de soluções para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier.

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. Em sua próxima solicitação do List Vaults, você define o marker parâmetro para o valor que o Amazon Glacier (Amazon Glacier) retornou nas respostas à sua solicitação anterior do List Vaults. 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

GET /AccountId/vaults HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

nota

O AccountId valor é o Conta da AWS ID. Esse valor deve corresponder ao Conta da AWS ID associado às credenciais usadas para assinar a solicitação. Você pode especificar um Conta da AWS ID ou, opcionalmente, um único '-' (hífen). Nesse caso, o Amazon Glacier usa Conta da AWS o ID 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.

Name (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.

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.

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

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

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

GET /-/vaults HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
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.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Content-Type: application/json
Content-Length: 497	

{
  "Marker": null,
  "VaultList": [ 
   {
    "CreationDate": "2012-03-16T22:22:47.214Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 2,
    "SizeInBytes": 12334,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
    "VaultName": "examplevault1"
   }, 
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
    "VaultName": "examplevault2"
   },
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-25T12:14:31.121Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
    "VaultName": "examplevault3"
   } 
  ]
}

Exemplo: Partial List of Vaults

O exemplo a seguir retorna dois cofres começando pelo cofre especificado pelo marker.

Exemplo de solicitação

GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
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.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Content-Type: application/json
Content-Length: 497	

{
  "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
  "VaultList": [ 
   {
    "CreationDate": "2012-03-16T22:22:47.214Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 2,
    "SizeInBytes": 12334,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
    "VaultName": "examplevault1"
   }, 
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
    "VaultName": "examplevault2"
   }
  ]
}

Consulte também

Para obter mais informações sobre o uso dessa API em uma das linguagens específicas da Amazon SDKs, consulte o seguinte: