失败向 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 状态代码。
| Code | 名字 | 描述 |
|---|---|---|
| 429 | 请求过多 | 指示用户在给定时间内发送了过多请求(“速率限制”)。 此响应可能包含 重试后 标头,指示在发出新请求之前等待多长时间。 |
| 500 | 内部服务器错误 | 指示服务器遇到阻止其满足请求的意外条件。 此错误响应是一般“catch-all”响应。 通常,这表示服务器找不到更好的 5xx 错误代码来响应。 |
| 502 | 网关错误 | 指示服务器在充当网关或代理时收到来自上游服务器的无效响应。 |
| 503 | 服务不可用 | 指示服务器尚未准备好处理请求。 常见原因是服务器因维护或过载而关闭。 此响应应用于临时条件,重试后 HTTP 标头(如果可能)包含服务恢复的估计时间。 |
| 504 | 网关超时 | 指示服务器在充当网关或代理时未及时从上游服务器获取响应,以便完成请求。 |
| 507 | 存储不足 | 可以在 Web 分布式创作和版本控制(WebDAV)协议的上下文中给出(请参阅 RFC 4918)。 它指示无法执行方法,因为服务器无法存储成功完成请求所需的表示形式。 |
备注
开发代理将它模拟的每个 HTTP 方法的错误限制为Microsoft Graph为该方法返回的错误。
GET 和 PATCH 请求使用 429、 500、 502、 503和 504。
POST和PUTDELETE请求也使用507。 设置 allowedErrors时,开发代理仅使用应用于每个方法的允许错误。 例如,如果设置为allowedErrors[ 507 ]“开发代理”,则失败POSTPUT,以及DELETE请求,而不是GET请求或PATCH请求。
如果不允许的错误都不适用于请求的方法,则开发代理会将请求传递到Microsoft Graph。 开发代理还会传递使用其他 HTTP 方法的请求,例如 HEAD 或 OPTIONS。 对于批处理请求,如果批处理中的任何请求没有允许的错误,则开发人员代理会通过整个批处理,因为批处理响应必须包含批处理中每个请求的响应。