Réponses d'erreur

En cas d'erreur, l'API retourne l'une des exceptions suivantes :

Code	Description	HTTP Status Code	Type
AccessDeniedException	Renvoyé en cas de tentative d'accès à une ressource interdite par une politique AWS Identity and Access Management (IAM) ou si l'ID de Compte AWS utilisé dans l'URI de la demande était incorrect. Pour de plus amples informations, veuillez consulter Gestion des identités et des accès pour Amazon S3 Glacier.	403 Forbidden	Client
BadRequest	Retourné si la demande ne peut pas être traitée.	400 Bad Request	Client
ExpiredTokenException	Retourné si le jeton de sécurité utilisé dans la demande a expiré.	403 Forbidden	Client
InsufficientCapacityException	Renvoyé si la capacité est insuffisante pour traiter la demande rapide. Cette erreur s'applique uniquement aux récupérations rapides et non aux récupérations standard ou en bloc.	503 Service Unavailable	de bases de données
InvalidParameterValueException	Retourné si un paramètre de la demande n'a pas été spécifié correctement.	400 Bad Request	Client
InvalidSignatureException	Retourné si la signature de la demande n'est pas valide.	403 Forbidden	Client
LimitExceededException	Renvoyé si la demande dépasse l'une des limites suivantes : une limite de coffre, une limite de balise ou une limite de capacité allouée.	400 Bad Request	Client
MissingAuthenticationTokenException	Retourné si les données d'authentification ne sont pas trouvées pour la demande.	400 Bad Request	Client
MissingParameterValueException	Retourné si un en-tête ou un paramètre obligatoire n'apparaît pas dans la demande.	400 Bad Request	Client
PolicyEnforcedException	Retourné si une tâche d'extraction va dépasser la limite actuelle définie pour le taux d'extraction de la stratégie de données. Pour plus d'informations sur les stratégies d'extraction de données, consultez la section Politiques d'extraction de données S3 Glacier.	400 Bad Request	Client
ResourceNotFoundException	Retourné si la ressource spécifiée, par exemple un coffre, un ID de chargement ou un ID de tâche n'existe pas.	404 Not Found	Client
RequestTimeoutException	Renvoyé si, à l'occasion d'un chargement d'archive, Amazon S3 Glacier (S3 Glacier) dépasse le délai d'attente lors de la réception du chargement.	408 Request Timeout	Client
SerializationException	Retourné si le corps de la demande n'est pas valide. Si une charge utile JSON est incluse, vérifiez qu'elle est bien formée.	400 Bad Request	Client
ServiceUnavailableException	Retourné si le service ne peut pas terminer la demande.	500 Internal Server Error	de bases de données
ThrottlingException	Renvoyé si vous devez réduire le rythme des demandes que vous adressez à S3 Glacier.	400 Bad Request	Client
UnrecognizedClientException	Retourné si l'ID de clé d'accès ou le jeton de sécurité n'est pas valide.	400 Bad Request	Client

Plusieurs API S3 Glacier renvoient la même exception, mais avec des messages d'exception différents, pour vous aider à résoudre l'erreur rencontrée.

S3 Glacier renvoie les informations d'erreur dans le corps de la réponse. Les exemples suivants illustrent quelques réponses envoyées en cas d'erreur.

Exemple 1 : Description d'une demande de tâche avec un ID de tâche qui n'existe pas

Supposons que vous envoyiez une demande Description de la tâche (GET JobID) correspondant à une tâche qui n'existe pas. Cela signifie que vous spécifiez un ID de tâche qui n'existe pas.

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

En réponse, S3 Glacier renvoie la réponse d'erreur suivante.

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

Où :

Code

L'une des exceptions générales.

Type : chaîne

Message

Description générique de la condition d'erreur propre à l'API qui retourne l'erreur.

Type : chaîne

Type

Source de l'erreur. Ce champ peut comporter l'une des valeurs suivantes : Client, Server ou Unknown.

Type : chaîne.

Notez le point suivant dans la réponse précédente :

• En guise de réponse à une erreur, S3 Glacier renvoie les valeurs de code de statut 4xx et 5xx. Dans cet exemple, le code de statut est 404 Not Found.

• La valeur d'en-tête Content-Type application/json indique JSON dans le corps

• Le JSON dans le corps fournit les informations relatives à l'erreur.

Dans la demande précédente, au lieu d'un ID de tâche erroné, supposons que vous ayez spécifié un coffre qui n'existe pas. La réponse retourne un message différent.

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

Exemple 2 : Demande d'établissement d'une liste des tâches avec une valeur non valide pour le paramètre de demande

Dans cet exemple, vous envoyez une demande Affichage des tâches (GET jobs) pour extraire les tâches de coffre avec un statuscode spécifique et vous fournissez une valeur statuscode finished incorrecte au lieu des valeurs acceptables InProgress, Succeeded ouFailed.

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 renvoie InvalidParameterValueException avec un message approprié.

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