Types de ressources et réponses d’erreur Microsoft Graph

  • Article

Les erreurs dans Microsoft Graph sont retournées à l’aide de codes de status HTTP standard et d’un objet de réponse d’erreur JSON.

Codes d’état HTTP

Le tableau suivant répertorie et décrit les codes d’état HTTP pouvant être renvoyés.

Code d'état Message d’état Description
400 Demande incorrecte (Bad Request) Impossible de traiter la demande, car elle est incorrecte ou incorrecte.
401 Non autorisé (Unauthorized) Informations d’authentification nécessaires manquantes ou non valides pour la ressource.
402 Paiement requis Les exigences de paiement pour l’API n’ont pas été remplies.
403 Interdit L’accès à la ressource demandée est refusé. L’utilisateur n’a peut-être pas suffisamment d’autorisations ou n’a peut-être pas une licence requise.

Important: Si des stratégies d’accès conditionnel sont appliquées à une ressource, un HTTP 403; Forbidden error=insufficient_claims message peut être retourné. Pour plus d’informations sur Microsoft Graph et l’accès conditionnel, consultez Guide du développeur pour Microsoft Entra l’accès conditionnel.
404 Introuvable (Not Found) La ressource demandée n’existe pas.
405 Méthode non autorisée (Method Not Allowed) La méthode HTTP dans la requête n’est pas autorisée sur la ressource.
406 Non acceptable (Not Acceptable) Ce service ne prend pas en charge le format demandé dans l’en-tête Accept.
409 Conflit L’état actuel n’est pas compatible avec les attentes de la demande. Par exemple, le dossier parent spécifié n’existe peut-être pas.
410 Non disponible (Gone) La ressource demandée n’est plus disponible sur le serveur.
411 Longueur requise (Length Required) Un en-tête Content-Length est requise sur la demande.
412 Échec de la condition préalable (Precondition Failed) Une condition préalable fournie dans la demande (par exemple, un en-tête if-match) ne correspond pas à l’état actuel de la ressource.
413 Entité de demande trop grande (Request Entity Too Large) La taille de la demande dépasse la limite maximale.
415 Type de support non pris en charge (Unsupported Media Type) Le type de contenu de la demande est un format qui n’est pas pris en charge par le service.
416 La gamme demandée ne peut pas être satisfaite (Requested Range Not Satisfiable) La gamme d’octets spécifiée n’est pas valide ou n’est pas disponible.
422 Impossible de traiter l’entité (Unprocessable Entity) Impossible de traiter la demande, car elle est sémantiquement incorrecte.
423 Verrouillé La ressource à laquelle vous accédez est verrouillée.
429 Trop de demandes (Too Many Requests) L’application cliente a été limitée et ne doit pas tenter de répéter la demande tant qu’un certain temps ne s’est pas écoulé.
500 Erreur interne du serveur (Internal Server Error) Une erreur du serveur interne s’est produite lors du traitement de la demande.
501 Non implémenté (Not Implemented) La fonctionnalité demandée n’est pas implémentée.
503 Service non disponible Le service est temporairement indisponible pour maintenance ou est surchargé. Vous pouvez répéter la demande après un délai, dont la longueur peut être spécifiée dans un en-tête Retry-After.
504 Dépassement du délai de la passerelle (Gateway Timeout) Bien qu’agissant en tant que proxy, le serveur n’a pas reçu de réponse en temps voulu de la part du serveur amont auquel il devait accéder pour tenter de terminer la demande.
507 Stockage insuffisant (Insufficient Storage) Le quota de stockage maximum a été atteint.
509 Limite de bande passante dépassée Votre application a été limitée car elle a dépassé la capacité maximale de la bande passante. Votre application peut renouveler la demande une fois qu’un délai plus long s’est écoulé.

La réponse d’erreur est un seul objet JSON qui contient une propriété unique nommée error. Cet objet inclut tous les détails de l’erreur. Vous pouvez utiliser les informations renvoyées ici à la place, ou en plus du code d’état HTTP. Voici un exemple de corps d’erreur JSON complet.

{
  "error": {
    "code": "badRequest",
    "message": "Uploaded fragment overlaps with existing data.",
    "innerError": {
      "code": "invalidRange",
      "request-id": "request-id",
      "date": "date-time"
    }
  }
}

Type de ressource d’erreur

La ressource d’erreur est renvoyée chaque fois qu’une erreur se produit dans le traitement d’une demande.

Les réponses d’erreur suivent la définition dans les Instructions de l’API REST Microsoft.

Représentation JSON

La ressource d’erreur est composée d’une seule ressource :

{
  "error": {
    "code": "string",
    "message": "string",
    "innererror": { 
      "code": "string"
    },
    "details": []
  }
}
Nom de la propriété Valeur Description
code string Chaîne de code pour l’erreur qui s’est produite
message string Message prêt pour le développeur concernant l’erreur qui s’est produite. Il ne doit pas être affiché directement à l’utilisateur.
innererror objet d’erreur Optional. Objet d’erreur supplémentaire qui peut être plus spécifique que l’erreur de niveau supérieur.
détails error object Optional. Liste d’objets d’erreur supplémentaires qui peuvent fournir une répartition des erreurs multiples rencontrées lors du traitement de la requête.

Propriétés

La propriété code contient une valeur lisible par l’ordinateur sur laquelle vous pouvez utiliser une dépendance dans votre code.

L’objet innererror peut contenir de manière récursive davantage d’objets innererror avec des propriétés de codes d’erreur supplémentaires et plus spécifiques. Lors de la gestion d’une erreur, les applications doivent parcourir en boucle tous les codes d’erreur imbriqués qui sont disponibles et utiliser le plus détaillé qu’elles comprennent.

La propriété message est une valeur lisible par l’homme qui décrit la condition d’erreur. Ne dépendez pas du contenu de cette valeur dans votre code.

La propriété message à la racine contient un message d’erreur destiné au développeur à lire. Les messages d’erreur ne sont pas localisés et ne doivent pas être affichés directement à l’utilisateur. Lors de la gestion des erreurs, votre code ne doit pas dépendre des valeurs de propriété de message , car elles peuvent changer à tout moment et contiennent souvent des informations dynamiques spécifiques à la demande ayant échoué. Vous devez coder uniquement par rapport aux codes d’erreur retournés dans les propriétés du code .

La propriété details est un tableau facultatif d’objets d’erreur qui ont le même format JSON que l’objet d’erreur de niveau supérieur. Dans le cas d’une requête composée de plusieurs opérations, telles qu’une opération en bloc ou par lots, il peut être nécessaire de retourner une erreur indépendante pour chaque opération. Dans ce cas, la liste des détails est remplie avec ces erreurs individuelles.