**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á.
# Respostas de erro
No caso de um erro, a API retorna uma das seguintes exceções:
| Código | Description | Código de status HTTP | Tipo |
| --- | --- | --- | --- |
| AccessDeniedException | Retornado se houve uma tentativa de acessar um recurso não permitido por uma política AWS Identity and Access Management (IAM) ou se o Conta da AWS ID incorreto foi usado no URI da solicitação. Para obter mais informações, consulte [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md). | 403 Forbidden | Cliente |
| BadRequest | Retornado se a solicitação não puder ser processada. | 400 Bad Request | Cliente |
| ExpiredTokenException | Retornado se o token de segurança usado na solicitação tiver expirado. | 403 Forbidden | Cliente |
| InsufficientCapacityException | Retornado se houver capacidade insuficiente para processar a solicitação expressa. Esse erro se aplica somente a recuperações expressas, e não a recuperações padrão ou em massa. | 503 Service Unavailable | Servidor |
| InvalidParameterValueException | Retornado se um parâmetro da solicitação estiver especificado incorretamente. | 400 Bad Request | Cliente |
| InvalidSignatureException | Retornado se a assinatura da solicitação for inválida. | 403 Forbidden | Cliente |
| LimitExceededException | Retornado se a solicitação resultar em um dos limites a seguir excedido, um limite de cofre, um limite de tags ou o limite da capacidade provisionada. | 400 Bad Request | Cliente |
| MissingAuthenticationTokenException | Retornado se dados da autenticação não forem encontrados para a solicitação. | 400 Bad Request | Cliente |
| MissingParameterValueException | Retornado se um cabeçalho obrigatório ou um parâmetro não for encontrado na solicitação. | 400 Bad Request | Cliente |
| PolicyEnforcedException | Retornado se um trabalho de recuperação excederá o limite da taxa de recuperação da política de dados atual. Para obter mais informações sobre políticas de recuperação de dados, consulte [Políticas de recuperação de dados do Amazon Glacier](data-retrieval-policy.md). | 400 Bad Request | Cliente |
| ResourceNotFoundException | Retornado se o recurso especificado, como um cofre, um ID de upload ou um ID de trabalho, não existir. | 404 Not Found | Cliente |
| RequestTimeoutException | Retornado em caso de upload de um arquivo e o Amazon Glacier expire enquanto recebe o upload. | 408 Request Timeout | Cliente |
| SerializationException | Retornado se o corpo da solicitação for inválido. Em caso de inclusão de uma carga útil JSON, verifique se ela está bem formada. | 400 Bad Request | Cliente |
| ServiceUnavailableException | Retornado se o serviço não puder concluir a solicitação. | 500 Internal Server Error | Servidor |
| ThrottlingException | Retornado se você precisar reduzir a taxa de solicitações para o Amazon Glacier. | 400 Bad Request | Cliente |
| UnrecognizedClientException | Retornado se o ID de chave de acesso ou o token de segurança for inválido. | 400 Bad Request | Cliente |
Vários Amazon Glacier APIs retornam a mesma exceção, mas com mensagens de exceção diferentes para ajudá-lo a solucionar o erro específico encontrado.
O Amazon Glacier retorna informações do erro no corpo da resposta. Os exemplos a seguir mostram algumas das respostas de erro.
## Exemplo 1: descrever solicitação de trabalho com um ID de trabalho não existente
Suponhamos que você envie uma solicitação [Trabalho de descrição (GET JobID)](api-describe-job-get.md) para um trabalho não existente. Ou seja, você especifica um ID de trabalho não existente.
```
1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. 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
```
Em resposta, o Amazon Glacier retorna a resposta de erro a seguir.
```
HTTP/1.1 404 Not Found
x-amzn-RequestId: AAABaZ9N92Iiyv4N7sru3ABEpSQkuFtmH3NP6aAC51ixfjg
Content-Type: application/json
Content-Length: 185
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
"code": "ResourceNotFoundException",
"message": "The job ID was not found: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID",
"type": "Client"
}
```
Em que:
**Código**
Uma das exceções em geral.
*Tipo:* string
**Message**
Uma descrição genérica da condição do erro específica da API que retorna o erro.
*Tipo:* string
**Tipo**
A origem do erro. O campo pode ter um dos seguintes valores: `Client`, `Server` ou `Unknown`.
*Tipo*: string
Observe o seguinte na resposta anterior:
+ Para a resposta de erro, o Amazon Glacier retorna valores de código de status `4xx` e `5xx`. Neste exemplo, o código de status é `404 Not Found`.
+ O `Content-Type` do valor de cabeçalho `application/json` indica JSON no corpo
+ O JSON no corpo fornece as informações de erro.
Na solicitação anterior, em vez de um ID de trabalho inválido, suponhamos que você especifique um cofre não existente. A resposta retorna uma mensagem diferente.
```
HTTP/1.1 404 Not Found
x-amzn-RequestId: AAABBeC9Zw0rp_5D0L8VfB3FA_WlTupqTKAUehMcPhdgni0
Content-Type: application/json
Content-Length: 154
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
"code": "ResourceNotFoundException",
"message": "Vault not found for ARN: arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
"type": "Client"
}
```
## Exemplo 2: solicitação List Jobs com um valor inválido para o parâmetro da solicitação
Neste exemplo, você envia uma solicitação [List Jobs (GET jobs)](api-jobs-get.md) para recuperar trabalhos de cofre com um `statuscode` específico e fornece um valor `statuscode` `finished`, em vez dos valores aceitáveis `InProgress`, `Succeeded` ou `Failed`.
```
GET /-/vaults/examplevault/jobs?statuscode=finished HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
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
```
O Amazon Glacier retorna a `InvalidParameterValueException` com uma mensagem apropriada.
```
HTTP/1.1 400 Bad Request
x-amzn-RequestId: AAABaZ9N92Iiyv4N7sru3ABEpSQkuFtmH3NP6aAC51ixfjg
Content-Type: application/json
Content-Length: 141
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
"code": "InvalidParameterValueException",
"message": "The job status code is not valid: finished",
"type: "Client"
}
```