Respuestas de error - Amazon 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 Amazon Glacier que utilizan Vaults y la API de REST original de 2012.

Si busca soluciones de almacenamiento de archivos, se recomienda que utilice las clases de almacenamiento de Amazon 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 las clases de almacenamiento de Amazon Glacier.

Amazon Glacier (servicio original independiente basado en almacenes) ya no aceptará nuevos clientes a partir del 15 de diciembre de 2025, sin que ello afecte a los clientes actuales. Amazon Glacier es un servicio independiente con sus propias API que almacena datos en almacenes y es distinto de las clases de almacenamiento Amazon S3 y Amazon S3 Glacier. Sus datos actuales permanecerán seguros y accesibles en Amazon Glacier de forma indefinida. No hay que hacer migraciones. Para un almacenamiento de archivos a largo plazo y de bajo costo, AWS recomienda las clases de almacenamiento Amazon S3 Glacier, que ofrecen una experiencia del cliente superior con las API basadas en buckets de S3, Región de AWS disponibilidad total, costos más bajos e AWS integración de servicios. Si desea mejorar las capacidades, considere la posibilidad de migrar a las clases de almacenamiento de Amazon S3 Glacier mediante nuestra AWSGuía de soluciones para la transferencia de datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier.

Respuestas de error

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

Código 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 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 Server
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 Amazon 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 Glacier (Amazon 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 Server
ThrottlingException Se devuelve si necesita reducir la tasa de solicitudes a Amazon 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 Amazon Glacier devuelven la misma excepción, pero con distintos mensajes para ayudarle a solucionar el error específico que se ha detectado.

Amazon 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, Amazon 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:

Código de

Una de las excepciones generales.

Tipo: cadena

Mensaje

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, Amazon 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

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