一般的な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) 最大バッチ サイズを超えました。 受信済み: <受信した>バッチ サイズ、許可: {batch size allowed}。
MissingRequiredParameter BadRequest (400) パラメーター <不足しているパラメーター> がありません。
OsPlatformNotSupported BadRequest (400) OS プラットフォーム <クライアント OS プラットフォーム> は、このアクションではサポートされていません。
ClientVersionNotSupported BadRequest (400) <要求されたアクション>は、クライアント バージョンでサポートされているクライアント バージョン<>以降でサポートされています。
権限がありません (Unauthorized) 未承認 (401) 権限がありません (Unauthorized)

このエラーは通常、無効な承認ヘッダーまたは期限切れの承認ヘッダーが原因で発生します。
禁止されています 禁止 (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 ドキュメントを確認し、送信されたパラメーターが関連する例と一致することをチェックします。

追跡 ID

各エラー応答には、追跡用の一意の ID パラメーターが含まれています。 このパラメーターのプロパティ名は target です。 エラーについて Microsoft に問い合わせる場合は、追跡 ID を添付すると、Microsoft が問題の根本原因を見つけるのに役立ちます。

ヒント

さらに多くの情報を得るには、 Tech Community: Microsoft Defender XDR Tech Community の Microsoft Security コミュニティとEngageします。