Fouten van Microsoft Graph-API's simuleren

Microsoft Graph is een verzameling API's waarmee u toegang krijgt tot gegevens en inzichten in Microsoft 365. Wanneer u Microsoft Graph in uw app gebruikt, moet u testen hoe uw app API-fouten verwerkt. Met dev Proxy kunt u fouten simuleren in elke Microsoft Graph API met behulp van de GraphRandomErrorPlugin.

Het GraphRandomErrorPlugin is geoptimaliseerd voor gebruik met Microsoft Graph en simuleert de specifieke fouten die Microsoft Graph kan retourneren.

Als u wilt beginnen, schakelt u het GraphRandomErrorPlugin in uw configuratiebestand in.

{
  "$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/*"
      ]
    }
  ]
}

Tip

Het bovenstaande codefragment luistert naar aanvragen voor Microsoft Graph in alle Microsoft-clouds. Als u alleen fouten in een specifieke Microsoft-cloud wilt simuleren, verwijdert u de URL's die u niet nodig hebt.

Start Dev Proxy met uw configuratiebestand en gebruik uw app om te zien hoe de fouten worden verwerkt. Voor elke overeenkomende aanvraag bepaalt Dev Proxy of een fout moet worden gesimuleerd of de aanvraag moet worden doorgegeven aan Microsoft Graph met behulp van het geconfigureerde foutpercentage. Wanneer Dev Proxy een fout simuleert, selecteert deze willekeurig een van de fouten die Microsoft Graph gebruikt en retourneert een foutreactie op uw app.

Fouten configureren om te simuleren

GraphRandomErrorPlugin Standaard worden de volgende fouten gesimuleerd.

HTTP-methode	Mogelijke fouten
GET	429 Too Many Requests502 Bad Gateway, 500 Internal Server Error, 503 Service Unavailable504 Gateway Timeout
POST	429 Too Many Requests, , 500 Internal Server Error502 Bad Gateway, 503 Service Unavailable, , , 504 Gateway Timeout507 Insufficient Storage
PUT	429 Too Many Requests, , 500 Internal Server Error502 Bad Gateway, 503 Service Unavailable, , , 504 Gateway Timeout507 Insufficient Storage
PATCH	429 Too Many Requests502 Bad Gateway, 500 Internal Server Error, 503 Service Unavailable504 Gateway Timeout
DELETE	429 Too Many Requests, , 500 Internal Server Error502 Bad Gateway, 503 Service Unavailable, , , 504 Gateway Timeout507 Insufficient Storage

Als u specifieke gedragingen wilt testen, zoals beperking, configureert u de invoegtoepassing zodanig dat alleen de relevante fouten worden gebruikt met behulp van de --allowed-errors optie.

devproxy --allowed-errors 429

U kunt de allowedErrors eigenschap ook configureren in het object in uw graphRandomErrorPlugin configuratiebestand.

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

Fouten simuleren in Microsoft Graph-batchaanvragen

Dev Proxy simuleert fouten in batchaanvragen naar Microsoft Graph op dezelfde manier als voor reguliere aanvragen. Wanneer dev proxy een of meer aanvragen in een batchaanvraag mislukt, retourneert deze een 424 Failed Dependency antwoord voor de hele batchaanvraag, net zoals Microsoft Graph dat zou doen.