**Esta página destina-se somente a clientes atuais do serviço Amazon Glacier que usam cofres e a API REST original de 2012.** Se você estiver procurando soluções de armazenamento de arquivos do Amazon Glacier, recomendamos usar as classes de armazenamento do 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 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/). O Amazon Glacier (serviço autônomo original baseado em cofre) não está mais aceitando novos clientes. 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](https://aws.amazon.com/s3/storage-classes/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 nossas [Orientações de soluções da AWS para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). 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](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 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](#api-ListProvisionedCapacity-example1-response). ## 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. ``` 1. GET /AccountId/provisioned-capacity HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. 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 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](api-common-request-headers.md). ## 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](api-common-response-headers.md). ### 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](api-error-responses.md). ## 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. ``` 1. GET /123456789012/priority-capacity HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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 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. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: length 6. 7. { 8. "ProvisionedCapacityList", 9. { 10. "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z", 11. "StartDate": "2017-01-31T14:26:33.031Z", 12. "ExpirationDate": "2017-02-28T14:26:33.000Z", 13. }, 14. { 15. "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z", 16. "StartDate": "2016-12-13T20:11:51.095Z"", 17. "ExpirationDate": "2017-01-13T20:11:51.000Z" ", 18. }, 19. ... 20. } ``` ## Seções relacionadas + [Purchase Provisioned Capacity (POST provisioned-capacity)](api-PurchaseProvisionedCapacity.md)