次の方法で共有

一般的な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 アドレス <無効な 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 Security コミュニティにご参加ください: 「Microsoft Defender XDR Tech Community」。