常见Microsoft Defender XDR REST API 错误代码
适用于:
- Microsoft Defender XDR
备注
使用 MS Graph 安全 API 试用我们的新 API。 有关详细信息,请查看: 使用 Microsoft Graph 安全 API - Microsoft Graph |Microsoft Learn。
重要
某些信息与预发布的产品有关,在商业发布之前可能有重大修改。 Microsoft 对此处所提供的信息不作任何明示或默示的保证。
任何Microsoft Defender XDR API 上的操作都可以返回错误代码。 每个错误响应都包含一条错误消息,可帮助解决问题。 表部分中的错误消息列提供了一些示例消息。 实际消息的内容因触发响应的因素而异。 下表中的) 由尖括号 (< >
指示变量内容:
错误代码 | HTTP 状态代码 | 邮件 |
---|---|---|
BadRequest | BadRequest (400) | 常规错误请求错误消息。 |
ODataError | BadRequest (400) | 指定的>特定错误的 OData URI 查询<无效。 |
InvalidInput | BadRequest (400) | 输入 <无效,输入>无效。 |
InvalidRequestBody | BadRequest (400) | 请求正文无效。 |
InvalidHashValue | BadRequest (400) | 无效哈希的哈希>值<无效。 |
InvalidDomainName | BadRequest (400) | <域名 无效域>无效。 |
InvalidIpAddress | BadRequest (400) | 无效 IP> 地址<无效。 |
InvalidUrl | BadRequest (400) | 无效 URL 无效的 URL<>。 |
MaximumBatchSizeExceeded | BadRequest (400) | 超出最大批大小。 Received: <batch size received>, allowed: {batch size allowed}。 |
MissingRequiredParameter | BadRequest (400) | 缺少 <参数> 的参数。 |
OsPlatformNotSupported | BadRequest (400) | OS 平台 <客户端 OS 平台> 不支持此操作。 |
ClientVersionNotSupported | BadRequest (400) | <客户端版本支持的客户端版本<及更高版本>支持请求的操作>。 |
未经授权 (Unauthorized) | 未经授权的 (401) | 未经授权 (Unauthorized) 此错误通常是由授权标头无效或过期导致的。 |
禁止访问 (Forbidden) | 禁止 (403) | 禁止访问 (Forbidden) 如果令牌有效,但操作权限不足,则会发生此错误。 |
DisabledFeature | 禁止 (403) | 未启用租户功能。 |
DisallowedOperation | 禁止 (403) | <不允许的操作和原因>。 |
NotFound | 找不到 (404) | “常规未找到”错误消息。 |
ResourceNotFound | 找不到 (404) | <找不到请求的资源>。 |
InternalServerError | 内部服务器错误 (500) | 如果没有错误消息,请重试该操作。 如果问题未得到解决,请联系 Microsoft。 |
{
"error": {
"code": "ResourceNotFound",
"message": "Machine 123123123 was not found",
"target": "43f4cb08-8fac-4b65-9db1-745c2ae65f3a"
}
}
{
"error": {
"code": "InvalidRequestBody",
"message": "Request body is incorrect",
"target": "1fa66c0f-18bd-4133-b378-36d76f3a2ba0"
}
}
重要
正文参数区分大小写。
如果遇到 InvalidRequestBody 或 MissingRequiredParameter 错误,则可能是由拼写错误引起的。 查看 API 文档,检查提交的参数与相关示例匹配。
每个错误响应都包含用于跟踪的唯一 ID 参数。 此参数的属性名称是 target。 如果因错误而联系 Microsoft,则附加跟踪 ID 可帮助 Microsoft 找到问题的根本原因。
- 使用 Microsoft Graph 安全 API - Microsoft Graph |Microsoft Learn
- Microsoft Defender XDR API 概述
- 支持的 Microsoft Defender XDR API
- 访问Microsoft Defender XDR API
- 了解 API 限制和许可
提示
想要了解更多信息? Engage技术社区中的 Microsoft 安全社区:Microsoft Defender XDR技术社区。