Cette page s'adresse uniquement aux clients existants du service S3 Glacier utilisant Vaults et l'API REST d'origine datant de 2012.
Si vous recherchez des solutions de stockage d'archives, nous vous conseillons d'utiliser les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour en savoir plus sur ces options de stockage, consultez les sections Classes de stockage S3 Glacier
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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 non autorisée par une politique AWS Identity and Access Management (IAM) ou si un Compte AWS identifiant incorrect a été utilisé dans l'URI de la demande. 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 |
Serveur |
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 |
Serveur |
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 S3 Glacier APIs renvoient la même exception, mais avec des messages d'exception différents pour vous aider à résoudre l'erreur spécifique 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,ServerouUnknown.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
4xxet5xx. Dans cet exemple, le code de statut est404 Not Found. -
La valeur d'en-tête
Content-Typeapplication/jsonindique 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"
}