常見 Microsoft Defender 全面偵測回應 REST API 錯誤碼
適用於:
- Microsoft Defender XDR
注意
使用 MS Graph 安全性 API 試用新的 API。 深入瞭解: 使用 Microsoft Graph 安全性 API - Microsoft Graph |Microsoft Learn。
重要
部分資訊與發行前版本產品有關,在正式發行之前可能會實質上進行修改。 Microsoft 對此處提供的資訊,不提供任何明確或隱含的瑕疵擔保。
任何 Microsoft Defender 全面偵測回應 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的IP>位址<無效。 |
InvalidUrl | BadRequest (400) | URL <無效的 URL> 。 |
MaximumBatchSizeExceeded | BadRequest (400) | 超過批次大小上限。 已接收: <已接收>批次大小,允許:{允許批次大小}。 |
MissingRequiredParameter | BadRequest (400) | 遺 <漏遺漏參數的參數> 。 |
OsPlatformNotSupported | BadRequest (400) | 此動作不支援 OS 平臺 <用戶端 OS 平臺> 。 |
ClientVersionNotSupported | BadRequest (400) | <用戶端版本支援的用戶端版本和更新版本<>支援要求的動作>。 |
未經授權 | 未經授權 (401) | 未經授權 此錯誤通常是由無效或過期的授權標頭所造成。 |
禁止 | 禁止 (403) | 禁止 此錯誤可能發生於有效的令牌,但動作的許可權不足。 |
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 檔,並檢查提交的參數是否符合相關範例。
每個錯誤回應都包含用於追蹤的唯一標識元參數。 此參數的屬性名稱是 目標。 如果您連絡 Microsoft 時發生錯誤,附加追蹤標識碼可協助 Microsoft 找出問題的根本原因。
- 使用 Microsoft Graph 安全性 API - Microsoft Graph |Microsoft Learn
- Microsoft Defender 全面偵測回應 API 概觀
- 支援的 Microsoft Defender XDR API
- 存取 Microsoft Defender 全面偵測回應 API
- 瞭解 API 限制和授權
提示
想要深入了解? Engage 技術社群中的 Microsoft 安全性社群:Microsoft Defender 全面偵測回應 技術社群。