一般的な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 が問題の根本原因を見つけるのに役立ちます。
関連記事
- Microsoft Graph セキュリティ API を使用する - Microsoft Graph |Microsoft Learn
- Microsoft Defender XDR API の概要
- サポートされている Microsoft Defender XDR API
- Microsoft Defender XDR API にアクセスする
- API の制限とライセンスについて説明します
ヒント
さらに多くの情報を得るには、 Tech Community: Microsoft Defender XDR Tech Community の Microsoft Security コミュニティとEngageします。