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

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

Se você estiver procurando soluções de armazenamento de arquivos, sugerimos usar as classes de armazenamento do S3 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 Classes de armazenamento do Amazon S3 Glacier e Noções básicas sobre as classes de armazenamento S3 Glacier para armazenamento de dados de longo prazo no Guia do usuário do Amazon S3. Essas classes de armazenamento usam a API do Amazon S3, estão disponíveis em todas as regiões e podem ser gerenciadas no console do Amazon S3. Elas oferecem análise de custos de armazenamento, Lente de Armazenamento, recursos avançados de criptografia opcionais e muito mais.

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 Listar cofres, defina o parâmetro marker como o valor retornado pelo Amazon S3 Glacier (S3 Glacier) nas respostas à solicitação Listar cofres 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

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 uma Conta da AWS ID ou, opcionalmente, um único '-' (hífen). Nesse caso, o Amazon S3 Glacier usa Conta da AWS a ID associada à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 de 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.

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.

Type: 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.

Type: string

VaultList

Uma matriz de objetos, com cada objeto apresentando uma descrição de um cofre.

Tipo: matriz

VaultName

O nome do cofre.

Type: string

Erros

Para obter informações sobre exceções e mensagens de erro do Amazon S3 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: