Respostas de erro - Amazon Glacier
Exemplo 1: descrever solicitação de trabalho com um ID de trabalho não existenteExemplo 2: solicitação List Jobs com um valor inválido para o parâmetro da solicitação

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, 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 AWS nossa orientação de soluções para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do 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á.

Respostas de erro

No caso de um erro, a API retorna uma das seguintes exceções:

Código Descrição Código de status HTTP Type
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 Identity and Access Management para Amazon Glacier. 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. 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 se estiver fazendo o upload de um arquivo e o Amazon Glacier (Amazon Glacier) expirar ao receber 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 Devolvido se você precisar reduzir sua 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 de 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) para um trabalho não existente. Ou seja, você especifica um ID de trabalho não existente. 

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

Em resposta, o Amazon Glacier retorna a seguinte resposta de erro. 

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 de e. 4xx 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) 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 o 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"
}