Codes d’état et d’erreur
Les opérations d’API REST pour stockage Azure retournent des codes d’état 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>
Pour les versions 2024-08-04 et ultérieures, la réponse d’erreur inclut des informations d’erreur supplémentaires lorsque le type de ressource signé de La SAP de compte ne correspond pas à la ressource accessible. Par exemple, la réponse d’erreur suivante indique que le type de ressource signé « o » est requis pour effectuer l’opération.
<?xml version="1.0" encoding="utf-8"?>
<Error>
<Code>AuthorizationResourceTypeMismatch</Code>
<Message>This request is not authorized to perform this operation using this resource type. RequestId:42a48a49-201e-0092-3770-a7ea70000000 Time:2024-05-16T09:04:16.3226200Z</Message>
<ExtendedErrorDetail>SignedResourceTypes 'o' is required to perform this operation.</ExtendedErrorDetail>
</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