Partager via

Simuler des erreurs à partir des API Microsoft Graph

  • Article

Microsoft Graph est une collection d’API qui vous donnent accès aux données et insights sur Microsoft 365. Lorsque vous utilisez Microsoft Graph dans votre application, vous devez tester la façon dont votre application gère les erreurs d’API. Le proxy de développement vous permet de simuler des erreurs sur n’importe quelle API Microsoft Graph à l’aide du GraphRandomErrorPlugin.

Il GraphRandomErrorPlugin est optimisé pour fonctionner avec Microsoft Graph et simule les erreurs spécifiques que Microsoft Graph peut retourner.

Pour commencer, activez le GraphRandomErrorPlugin fichier de configuration.

{
  "$schema": "https://raw.githubusercontent.com/microsoft/dev-proxy/main/schemas/v0.14.1/rc.schema.json",
  "plugins": [
    {
      "name": "GraphRandomErrorPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
      "configSection": "graphRandomErrorPlugin",
      "urlsToWatch": [
        "https://graph.microsoft.com/v1.0/*",
        "https://graph.microsoft.com/beta/*",
        "https://graph.microsoft.us/v1.0/*",
        "https://graph.microsoft.us/beta/*",
        "https://dod-graph.microsoft.us/v1.0/*",
        "https://dod-graph.microsoft.us/beta/*",
        "https://microsoftgraph.chinacloudapi.cn/v1.0/*",
        "https://microsoftgraph.chinacloudapi.cn/beta/*"
      ]
    }
  ]
}

Conseil

L’extrait de code ci-dessus écoute les demandes adressées à Microsoft Graph dans tous les clouds Microsoft. Si vous souhaitez uniquement simuler des erreurs dans un cloud Microsoft spécifique, supprimez les URL dont vous n’avez pas besoin.

Démarrez le proxy de développement avec votre fichier de configuration et utilisez votre application pour voir comment elle gère les erreurs. Pour chaque demande correspondante, le proxy de développement détermine s’il faut simuler une erreur ou transmettre la requête à Microsoft Graph à l’aide du taux d’échec configuré. Lorsque le proxy de développement simule une erreur, il sélectionne aléatoirement l’une des erreurs que Microsoft Graph utilise et retourne une réponse d’erreur à votre application.

Configurer des erreurs pour simuler

Par défaut, les GraphRandomErrorPlugin erreurs suivantes sont simulées.

Méthode HTTP Erreurs possibles
GET 429 Too Many Requests, , 500 Internal Server Error502 Bad Gateway, , 503 Service Unavailable504 Gateway Timeout
POST 429 Too Many Requests, , 500 Internal Server Error, 503 Service Unavailable502 Bad Gateway, , 504 Gateway Timeout507 Insufficient Storage
PUT 429 Too Many Requests, , 500 Internal Server Error, 503 Service Unavailable502 Bad Gateway, , 504 Gateway Timeout507 Insufficient Storage
PATCH 429 Too Many Requests, , 500 Internal Server Error502 Bad Gateway, , 503 Service Unavailable504 Gateway Timeout
DELETE 429 Too Many Requests, , 500 Internal Server Error, 503 Service Unavailable502 Bad Gateway, , 504 Gateway Timeout507 Insufficient Storage

Si vous souhaitez tester des comportements spécifiques, tels que la limitation, configurez le plug-in pour qu’il utilise uniquement les erreurs pertinentes à l’aide de l’option --allowed-errors .

devproxy --allowed-errors 429

Vous pouvez également configurer la allowedErrors propriété dans l’objet graphRandomErrorPlugin dans votre fichier de configuration.

{
  "graphRandomErrorPlugin": {
    "allowedErrors": [ 429 ]
  }
}

Simuler des erreurs dans les requêtes par lots Microsoft Graph

Le proxy de développement simule les erreurs dans les requêtes par lots vers Microsoft Graph de la même façon que pour les requêtes régulières. Lorsque le proxy de développement échoue une ou plusieurs requêtes dans une demande de traitement par lots, elle retourne une 424 Failed Dependency réponse pour l’ensemble de la demande de traitement par lots, comme Microsoft Graph.