List Provisioned Capacity (GET provisioned-capacity) - Amazon S3 Glacier
Sintaxe da solicitaçãoParâmetros de solicitaçãoCabeçalhos de solicitaçãoCorpo da solicitaçãoRespostasExemplosSeções relacionadas

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

List Provisioned Capacity (GET provisioned-capacity)

Esta operação lista a capacidade provisionada para a Conta da AWS especificada. Para obter mais informações sobre a capacidade provisionada, consulte Opções de recuperação de arquivos.

Uma unidade de capacidade provisionada dura um mês a partir da data e hora da compra, que é a data de início. A unidade expira na data de expiração, que é exatamente um mês depois da data de início até o segundo mais próximo.

Se a data de início é dia 31 de um mês, a data de expiração será o último dia do mês seguinte. Por exemplo, se a data de início é dia 31 de agosto, a data de expiração será dia 30 de setembro. Se a data de início é dia 31 de janeiro, a data de expiração será dia 28 de fevereiro. Você pode consultar essa funcionalidade em Exemplo de resposta.

Sintaxe da solicitação

Para listar a capacidade de recuperação provisionada para uma conta, envie uma solicitação GET HTTP para o URI de capacidade provisionado conforme mostrado no exemplo de sintaxe a seguir.

GET /AccountId/provisioned-capacity 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. Esse valor deve corresponder ao ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. 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ê especificar o ID da 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

Se a operação for bem-sucedida, o serviço reenviará uma resposta 200 OK HTTP.

Sintaxe da resposta

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
   "ProvisionedCapacityList": 
      {
         "CapacityId" : "string",
         "StartDate" : "string"
         "ExpirationDate" : "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.

CapacityId

O ID que identifica a unidade de capacidade provisionada.

Tipo: string

StartDate

A data em que a unidade de capacidade provisionada foi comprada, 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.

ExpirationDate

A data em que a unidade de capacidade provisionada expira, em UTC.

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

Erros

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

Exemplos

O exemplo a seguir lista as unidades de capacidade provisionada para uma conta.

Exemplo de solicitação

Neste exemplo, uma solicitação GET é enviada para recuperar uma lista das unidades de capacidade provisionada para a conta especificada.

GET /123456789012/priority-capacity 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

Se a solicitação for bem-sucedida, o Amazon S3 Glacier (S3 Glacier) retornará um HTTP 200 OK com uma lista de unidades de capacidade provisionada para a conta, conforme mostrado no exemplo a seguir.

A unidade de capacidade provisionada listada primeiro é um exemplo de unidade com data de início no dia 31 de janeiro de 2017 e data de expiração no dia 28 de fevereiro de 2017. Conforme mencionado anteriormente, se a data de início é dia 31 de um mês, a data de expiração será o último dia do mês seguinte.

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

{
   "ProvisionedCapacityList",
      {
         "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z",
         "StartDate": "2017-01-31T14:26:33.031Z",
         "ExpirationDate": "2017-02-28T14:26:33.000Z",
      },
      {
         "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z",
         "StartDate": "2016-12-13T20:11:51.095Z"",
         "ExpirationDate": "2017-01-13T20:11:51.000Z" ",
      },
      ...
}