Codes d’état et d’erreur

Les opérations d’API REST pour stockage Azure retournent des codes status HTTP standard, tels que définis dans les définitions de code d’état HTTP/1.1.

Les opérations d’API peuvent également retourner des informations d’erreur supplémentaires définies par le service. Ces informations d'erreur supplémentaires sont renvoyées dans le corps de la réponse.

Le corps de la réponse d'erreur présente le format élémentaire suivant : L’élément code indique la chaîne de code d’erreur, tandis que l’élément message indique la chaîne de message d’erreur.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>string-value</Code>  
  <Message>string-value</Message>  
</Error>  

Pour les versions 2017-07-29 et ultérieures, les opérations d’API ayant échoué retournent également la chaîne de code d’erreur Stockage Azure dans un en-tête de réponse.

En-tête de réponse Description
x-ms-error-code Valeur qui indique la chaîne de code d’erreur.

Une réponse d’erreur particulière peut également inclure des informations d’erreur supplémentaires pour fournir plus d’informations au développeur. Par exemple, la réponse d’erreur suivante indique qu’un paramètre de requête spécifié sur l’URI de requête n’est pas valide et fournit des informations supplémentaires sur le nom et la valeur du paramètre non valide, ainsi que sur la raison de l’erreur.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>InvalidQueryParameterValue</Code>  
  <Message>Value for one of the query parameters specified in the request URI is invalid.</Message>  
  <QueryParameterName>popreceipt</QueryParameterName>  
  <QueryParameterValue>33537277-6a52-4a2b-b4eb-0f905051827b</QueryParameterValue>  
  <Reason>invalid receipt format</Reason>  
</Error>  

Les rubriques suivantes fournissent des listes de codes d’erreur qui peuvent vous être utiles :

Réponses d’erreur pour le stockage table

Les réponses d’erreur pour le stockage table sont conformes au format d’erreur décrit dans la section 19 de la spécification OData. Des informations d’erreur supplémentaires peuvent être incluses, mais la réponse d’erreur est toujours conforme aux OData spécifications.

Les réponses d’erreur par lot sont similaires aux réponses d’erreur de stockage Table standard. Pour plus d’informations, consultez Effectuer des transactions de groupe d’entités.

Notes

JSON est le format de charge utile recommandé pour le stockage Table. Il s’agit du seul format pris en charge pour les versions 2015-12-11 et ultérieures.

Voici le corps de l’erreur de base au format JSON (version 2013-08-15 et ultérieure) :

{"odata.error":{"code":"ResourceNotFound","message":{"lang":"en-US","value":"The specified resource does not exist.\nRequestId:102a2b55-eb35-4254-9daf-854db78a47bd\nTime:2014-06-04T16:18:20.4307735Z"}}}  
  

Voici le corps d’erreur de base au format Atom (versions antérieures à 2015-12-11) :

<?xml version="1.0" encoding="utf-8"?>  
<error xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata">  
  <code>ResourceNotFound</code>  
  <message xml:lang="en-US">The specified resource does not exist.  
RequestId:e288ba1e-f5dd-4014-9e09-f1263d223dec  
Time:2014-06-04T16:18:20.7088013Z</message>  
</error>  
  

Voir aussi

Résolution des problèmes liés aux opérations d’API
Énumération HttpStatusCode
REST des services de stockage