GraphRandomErrorPlugin (그래프 랜덤 오류 플러그인)

임의 오류로 인해 Microsoft Graph에 대한 요청이 실패합니다.

구성 예제

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.0.0/rc.schema.json",
  "plugins": [
    {
      "name": "GraphRandomErrorPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
      "configSection": "graphRandomErrorPlugin"
    }
  ],
  "graphRandomErrorPlugin": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.0.0/graphrandomerrorplugin.schema.json",
    "allowedErrors": [ 429, 500, 502, 503, 504, 507 ]
  }
}

구성 속성

재산	묘사	기본값
allowedErrors	개발자 프록시에서 생성할 수 있는 HTTP 상태 코드 목록입니다.	429 500 502 503 504 507
rate	임의 오류로 실패할 요청의 비율입니다. 0에서 100 사이의 값입니다.	50
retryAfterInSeconds	Retry-After 헤더의 값(초)입니다.	5

명령줄 옵션

이름	묘사	기본값
-a, --allowed-errors	개발자 프록시에서 생성할 수 있는 HTTP 상태 코드 목록입니다.	429 500 502 503 504 507
-f, --failure-rate <failure rate>	임의 오류로 실패할 요청의 비율입니다. 0에서 100 사이의 값입니다.	50

Microsoft Graph에서 사용하는 HTTP 오류 상태 코드

Microsoft Graph는 다음 HTTP 상태 코드를 사용합니다.

팁

HTTP 응답 상태 코드 설명

코드	이름	묘사
429	요청이 너무 많음	사용자가 지정된 시간("속도 제한")에 너무 많은 요청을 전송했음을 나타냅니다. Retry-After 헤더는 새 요청을 만들기 전에 대기하는 시간을 나타내는 이 응답에 포함될 수 있습니다.
500	내부 서버 오류	서버에서 요청을 처리하지 못하는 예기치 않은 조건이 발생했음을 나타냅니다. 이 오류 응답은 일반적인 "catch-all" 응답입니다. 일반적으로 이는 서버가 응답에 대한 더 나은 5xx 오류 코드를 찾을 수 없다는 것을 나타냅니다.
502	잘못된 게이트웨이	서버가 게이트웨이 또는 프록시 역할을 하는 동안 업스트림 서버에서 잘못된 응답을 수신했음을 나타냅니다.
503	서비스를 사용할 수 없음	서버가 요청을 처리할 준비가 되지 않음을 나타냅니다. 일반적인 원인은 유지 관리를 위해 다운되었거나 오버로드된 서버입니다. 이 응답은 임시 조건에 사용해야 하며 Retry-After HTTP 헤더는 가능한 경우 서비스 복구에 대한 예상 시간을 포함해야 합니다.
504	게이트웨이 시간 제한	게이트웨이 또는 프록시 역할을 하는 동안 서버가 요청을 완료하는 데 필요한 업스트림 서버로부터 시간에 응답을 받지 못했음을 나타냅니다.
507	스토리지 부족	WebDAV(Web Distributed Authoring and Versioning) 프로토콜의 컨텍스트에서 제공될 수 있습니다(RFC 4918 참조). 서버가 요청을 성공적으로 완료하는 데 필요한 표현을 저장할 수 없기 때문에 메서드를 수행할 수 없다는 것을 나타냅니다.

설명

개발자 프록시는 각 HTTP 메서드에 대해 시뮬레이션하는 오류를 해당 메서드에 대해 Microsoft Graph 반환하는 오류로 제한합니다. GET및 PATCH 요청은 , 500, 502503및 504.를 사용합니다429. POST, PUT및 DELETE 요청도 사용합니다 507. 설정할 allowedErrors때 개발자 프록시는 각 메서드에 적용되는 허용된 오류만 사용합니다. 예를 들어, 설정 allowedErrors[ 507 ]하면 개발자 프록시가 실패POSTPUT하고 DELETE 요청은 실패하지만 요청은 실패하거나 PATCH 요청하지 않습니다GET.

허용된 오류가 요청의 메서드에 적용되지 않는 경우 Dev Proxy는 요청을 Microsoft Graph 전달합니다. 개발자 프록시는 다른 HTTP 메서드(예 HEAD : 또는 )를 사용하는 요청을 통과합니다 OPTIONS. 일괄 처리 요청의 경우 일괄 처리의 요청에 허용되는 오류가 없는 경우 일괄 처리 응답에는 일괄 처리의 모든 요청에 대한 응답이 포함되어야 하므로 전체 일괄 처리가 전달됩니다.

다음 단계

Microsoft Graph API에서 오류 시뮬레이션