常見 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"
    }
}

本文參數

重要

本文參數會區分大小寫。

如果您遇到 InvalidRequestBodyMissingRequiredParameter 錯誤,可能是因為錯字所造成。 檢閱 API 檔,並檢查提交的參數是否符合相關範例。

追蹤標識碼

每個錯誤回應都包含用於追蹤的唯一標識元參數。 此參數的屬性名稱是 目標。 如果您連絡 Microsoft 時發生錯誤,附加追蹤標識碼可協助 Microsoft 找出問題的根本原因。

提示

想要深入了解? Engage 技術社群中的 Microsoft 安全性社群:Microsoft Defender 全面偵測回應 技術社群。