Respuestas de error - Amazon S3 Glacier
Ejemplo 1: Solicitud de descripción del trabajo con un ID que no existeEjemplo 2: Solicitud de enumeración de trabajos con un valor no válido para el parámetro de solicitud

Esta página es solo para los clientes actuales del servicio S3 Glacier que utilizan Vaults y el original de 2012. REST API

Si busca soluciones de almacenamiento de archivos, le sugerimos que utilice las clases de almacenamiento S3 Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información sobre estas opciones de almacenamiento, consulte Clases de almacenamiento de S3 Glacier y Almacenamiento de datos a largo plazo con clases de almacenamiento de S3 Glacier en la Guía del usuario de Amazon S3. Estas clases de almacenamiento utilizan Amazon S3API, están disponibles en todas las regiones y se pueden gestionar en la consola de Amazon S3. Ofrecen funciones como el análisis de costos de almacenamiento, Storage Lens, funciones avanzadas de cifrado opcionales y más.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Respuestas de error

En el caso de que se produzca un error, la API devuelve una de las siguientes excepciones:

Code Descripción Código de estado HTTP Tipo
AccessDeniedException Se devuelve si ha habido un intento de acceder a un recurso no permitido por una política de AWS Identity and Access Management (IAM) o se ha usado un ID de Cuenta de AWS incorrecto en el URI de la solicitud. Para obtener más información, consulte Administración de identidades y accesos para Amazon S3 Glacier. 403 Forbidden Cliente
BadRequest Se devuelve si la solicitud no se puede procesar. 400 Bad Request Cliente
ExpiredTokenException Se devuelve si ha caducado el token de seguridad utilizado en la solicitud. 403 Forbidden Cliente
InsufficientCapacityException Se devuelve si no hay capacidad suficiente para procesar la solicitud rápida. Este error solo se aplica a las recuperaciones Expedited; no se aplica a las recuperaciones estándar ni de tipo Bulk. 503 Service Unavailable Servidor
InvalidParameterValueException Se devuelve si un parámetro de la solicitud se especifica de forma incorrecta. 400 Bad Request Cliente
InvalidSignatureException Se devuelve si la firma de la solicitud no es válida. 403 Forbidden Cliente
LimitExceededException Se devuelve si la solicitud provoca que se supere uno de los siguientes límites: un límite de almacén, un límite de etiquetas o el límite de capacidad aprovisionada. 400 Bad Request Cliente
MissingAuthenticationTokenException Se devuelve si no se encuentran datos de autenticación para la solicitud. 400 Bad Request Cliente
MissingParameterValueException Se devuelve si falta un encabezado o un parámetro obligatorio en la solicitud. 400 Bad Request Cliente
PolicyEnforcedException Se devuelve si un trabajo de recuperación supera el límite de tasa de recuperación de la política de datos actual. Para obtener más información sobre las políticas de recuperación de datos, consulte Políticas de recuperación de datos de S3 Glacier. 400 Bad Request Cliente
ResourceNotFoundException Se devuelve si no existe el recurso especificado, como un almacén, un ID de carga o un ID de trabajo. 404 Not Found Cliente
RequestTimeoutException Se devuelve si se agota el tiempo de espera de Amazon S3 Glacier (S3 Glacier) durante la carga de un archivo. 408 Request Timeout Cliente
SerializationException Se devuelve si el cuerpo de la solicitud no es válido. Si se incluye una carga de JSON, compruebe que el formato sea correcto. 400 Bad Request Cliente
ServiceUnavailableException Se devuelve si el servicio no puede completar la solicitud. 500 Internal Server Error Servidor
ThrottlingException Se devuelve si necesita reducir la tasa de solicitudes a S3 Glacier. 400 Bad Request Cliente
UnrecognizedClientException Se devuelve si el ID de clave de acceso o el token de seguridad no es válido. 400 Bad Request Cliente

Varias API de S3 Glacier devuelven la misma excepción, pero con distintos mensajes para ayudarle a solucionar el error específico que se ha detectado.

S3 Glacier devuelve la información de error en el cuerpo de la respuesta. Los siguientes ejemplos muestran algunas de las respuestas de error.

Ejemplo 1: Solicitud de descripción del trabajo con un ID que no existe

Supongamos que envía una solicitud Descripción del trabajo (GET JobID) de un trabajo que no existe. Es decir, especifica un ID de trabajo que no existe. 

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

A su vez, S3 Glacier devuelve la siguiente respuesta de error. 

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

Donde:

Code

Una de las excepciones generales.

Tipo: cadena

Message

Una descripción genérica de la condición de error específica de la API que devuelve el error.

Tipo: cadena

Tipo

La fuente del error. El campo puede ser uno de los siguientes valores: Client, Server o Unknown.

Tipo: cadena.

Tenga en cuenta lo siguiente en la respuesta anterior:

  • Para la respuesta de error, S3 Glacier devuelve valores de código de estado de 4xx y 5xx. En este ejemplo, el código de estado es 404 Not Found.

  • El valor Content-Type del encabezado application/json indica JSON en el cuerpo

  • El código JSON en el cuerpo proporciona la información de error.

En la solicitud anterior, en lugar de un ID de trabajo incorrecto, suponga que especifica un almacén que no existe. La respuesta devuelve un mensaje distinto.

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

Ejemplo 2: Solicitud de enumeración de trabajos con un valor no válido para el parámetro de solicitud

En este ejemplo se envía una solicitud Mostrar trabajos (GET trabajos) para recuperar los trabajos del almacén con statuscode específico y proporciona un valor statuscode de finished incorrecto, en lugar de los valores aceptables InProgress, Succeeded y 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

S3 Glacier devuelve InvalidParameterValueException con un mensaje adecuado.

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