Describe Vault (GET vault) - Amazon S3 Glacier
DescriçãoSolicitaçõesRespostasExemplosSeções relacionadasConsulte também

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

Se você estiver procurando por soluções de armazenamento de arquivamento, sugerimos usar as classes de armazenamento 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 S3 Glacier e Armazenamento de dados de longo prazo usando classes de armazenamento S3 Glacier 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. Eles oferecem recursos como análise de custos de armazenamento, lente de armazenamento, recursos de segurança, incluindo várias opções de criptografia 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á.

Describe Vault (GET vault)

Descrição

Essa operação retorna informações sobre um cofre, inclusive o Amazon Resource Name (ARN – Nome de recurso da Amazon), a data na qual o cofre foi criado, o número de arquivos contidos no cofre e o tamanho total de todos os arquivos no cofre. O número de arquivos e o tamanho total são desde o inventário de cofre gerado mais recentemente pelo Amazon S3 Glacier (S3 Glacier) (consulte Trabalhando com Vaults no Amazon S3 Glacier). O S3 Glacier gera inventários de cofre aproximadamente diários. Isso significa que, se você adicionar ou remover um arquivo de um cofre e enviar imediatamente uma solicitação Describe Vault, a resposta poderá não refletir as alterações.

Solicitações

Para obter informações sobre um cofre, envie uma solicitação GET para o URI do recurso de cofre específico.

Sintaxe

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

nota

O valor de AccountId é o ID de Conta da AWS da conta proprietária do cofre. Você pode especificar um ID de Conta da AWS ou, de forma opcional, um '-' (hífen) único; nesse caso, o Amazon S3 Glacier usa o ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.

Parâmetros de solicitação

Essa operação não usa parâmetros de solicitaçã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

{
  "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 UTC quando o cofre foi criado.

Tipo: uma representação de string no formato de data ISO 8601, por exemplo 2013-03-20T17:03:43.221Z.

LastInventoryDate

A data UTC quando o S3 Glacier concluiu o inventário de cofre mais recente. 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.

NumberOfArchives

O número de arquivos no cofre de acordo com o último inventário de cofre. Esse campo retornará nulo se um inventário ainda não tiver sido executado no cofre; por exemplo, se você tiver acabado de criar o cofre.

Tipo: número

SizeInBytes

O tamanho total em bytes dos arquivos no cofre, inclusive eventuais custos indiretos por arquivo, desde a data do último inventário. Esse campo retornará null se um inventário ainda não tiver sido executado no cofre; por exemplo, se você tiver acabado de criar o cofre.

Tipo: número

VaultARN

O nome de recurso da Amazon (ARN) do cofre.

Tipo: string

VaultName

O nome do cofre que foi especificado no momento da criação. O nome do cofre também é incluído no ARN do cofre.

Tipo: string

Erros

Para obter informações sobre exceções e mensagens de erro do Amazon S3 Glacier, consulte Respostas de erro.

Exemplos

Exemplo de solicitação

O exemplo a seguir demonstra como obter informações sobre o cofre chamado examplevault.

GET /-/vaults/examplevault 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

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: 260

{
  "CreationDate" : "2012-02-20T17:01:45.198Z",
  "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
  "NumberOfArchives" : 192,
  "SizeInBytes" : 78088912,
  "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
  "VaultName" : "examplevault"
}

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: