Partager via

Statut et codes d’erreur

Les opérations d’API REST pour le stockage Azure renvoient 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 renvoyer des informations d’erreur détaillées que le service définit. Ces informations d’erreur sont renvoyées dans le corps de la réponse.

Le corps de la réponse d’erreur suit le format de base illustré ici. 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 la version 2017-07-29 et les versions 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 Descriptif
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 détaillées pour fournir plus d’informations au développeur. Par exemple, la réponse d’erreur suivante indique un paramètre de requête non valide spécifié dans l’URI de la demande et fournit des informations supplémentaires sur le nom et la valeur du paramètre non valide, ainsi que 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 la version 2024-08-04 et les versions ultérieures, la réponse d’erreur inclut des informations d’erreur détaillées lorsque le type de ressource signé de Account SAS ne correspond pas à la ressource consultée. 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>

La liste d’articles suivante fournit des collections de codes d’erreur qui pourraient vous être utiles :

Copie de la réponse d’erreur de l’API

La réponse d’erreur pour les API de copie suit le même format que celui mentionné précédemment. Le corps de la réponse d’erreur contient l’élément code de la chaîne de code d’erreur et l’élément message indiquant la chaîne de message d’erreur.

Pour les versions 2024-02-04 et ultérieures, la réponse d’erreur peut inclure une erreur détaillée si l’opération de copie échoue en raison d’un problème avec la source de copie, à condition que l’échec de la source renvoie ces informations. La réponse peut inclure CopySourceStatusCode l’indication du code d’état de l’opération de copie source, CopySourceErrorCode la spécification du x-ms-error-code renvoyé dans la réponse d’erreur de la source de copie et CopySourceErrorMessage l’indication du message d’erreur correspondant.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>CannotVerifyCopySource</Code>  
  <Message> The specified blob doesn’t exist.
      RequestId:de1e2279-b01e-0000-5f26-5c4741000000
      Time:2023-03-21T18:52:10.1018932Z</Message>
  <CopySourceStatusCode> 404 </CopySourceStatusCode>
  <CopySourceErrorCode> BlobNotFound </CopySourceErrorCode>
  <CopySourceErrorMessage> The specified blob doesn’t exist </CopySourceErrorMessage> 
</Error>

Pour les versions 2024-02-04 et ultérieures, Stockage Azure retourne le code d’état de la copie source et le code d’erreur dans l’en-tête de la réponse, s’ils sont reçus lors de l’échec de la copie de la source.

En-tête de réponse Descriptif
x-ms-copy-source-status-code Valeur qui indique le code d’état de l’échec de la copie de la source.
x-ms-copy-source-error-code Valeur qui indique la chaîne de code d’erreur renvoyée par l’échec de la copie de la source.

Les API de copie suivantes renvoient ces détails :

Réponses d’erreur pour le stockage de table

Les réponses d’erreur pour le stockage de tables sont conformes au format d’erreur décrit à la section 19 de la spécification OData. Des informations détaillées sur l’erreur peuvent être incluses, mais la réponse d’erreur est toujours conforme aux OData spécifications.

Les réponses d’erreur par lots sont similaires aux réponses d’erreur standard de Table Storage. Pour plus d’informations, consultez Exécution de transactions de groupe d’entités.

Remarque

JSON est le format de charge utile recommandé pour le stockage de tables. C’est le seul format pris en charge pour la version 2015-12-11 et les versions ultérieures.

L’exemple suivant montre le corps de l’erreur de base au format JSON (version 2013-08-15 et versions ultérieures) :

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

L’exemple suivant montre le corps de l’erreur de base au format Atom (versions 2015-12-11 et antérieures) :

<?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

Dépannage des opérations d’API
HttpStatusCode, énumération
Services de stockage REST

  • Last updated on