Respostas de erro - Amazon S3 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 existentes do serviço S3 Glacier que usam o Vaults e o original de 2012. REST API

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 o Amazon S3API, 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 avançados de criptografia opcional 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á.

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 Tipo
AccessDeniedException Retornado se tiver ocorrido uma tentativa de acessar um recurso não permitido por uma política do (IAM) do AWS Identity and Access Management, ou se o ID incorreto da Conta da AWS tiver sido usado no URI da solicitação. Para obter mais informações, consulte Gerenciamento de identidade e acesso para o Amazon S3 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 de aplicativos
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 S3 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 em caso de upload de um arquivo e o Amazon S3 Glacier (S3 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 de aplicativos
ThrottlingException Retornado se você precisar reduzir a taxa de solicitações para o S3 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

Diversas APIs do S3 Glacier retornam a mesma exceção, mas com mensagens de exceção diferentes, para ajudar você a solucionar o erro específico encontrado.

O S3 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) 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 S3 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"
  }

Onde:

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

Type

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 S3 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) 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 S3 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"
}