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
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:DateAuthorization:SignatureValuex-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
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 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 Glacier (Amazon Glacier) retornará HTTP 200 OK um com uma lista de unidades de capacidade provisionadas 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" ", }, ... }
Seções relacionadas