調査 API の一覧表示

[アーティクル]
08/14/2024

適用対象:

Microsoft Defender ATP を試してみたいですか? 無料試用版にサインアップしてください。

注:

米国政府機関のお客様は、 Microsoft Defender for Endpoint for US Government のお客様に記載されている URI を使用してください。

ヒント

パフォーマンスを向上させるために、地理的な場所に近いサーバーを使用できます。

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com
ina.api.security.microsoft.com

API の説明

調査のコレクションを取得します。

OData V4 クエリをサポートします。

OData の $filter クエリは、 startTime、 id、 state、 machineId、 triggeringAlertId の各プロパティでサポートされています。
$stop 最大値が 10,000 の場合
$skip

Microsoft Defender for Endpoint を使用した OData クエリの例を参照してください

制限事項

最大ページサイズは 10,000 です。
この API のレート制限は、1 分あたり 100 呼び出しと 1 時間あたり 1,500 呼び出しです。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法など、詳細については、「 Microsoft Defender for Endpoint API を使用する」を参照してください。

アクセス許可の種類	アクセス許可	アクセス許可の表示名
アプリケーション	Alert.Read.All	`Read all alerts`
アプリケーション	Alert.ReadWrite.All	`Read and write all alerts`
委任 (職場または学校のアカウント)	Alert.Read	`Read alerts`
委任 (職場または学校のアカウント)	Alert.ReadWrite	`Read and write alerts`

注:

ユーザー資格情報を使用してトークンを取得する場合:

ユーザーは、少なくとも次のロールアクセス許可を持っている必要があります: View Data。詳細については、「ロールの作成と管理」を参照してください。

HTTP 要求

GET https://api.securitycenter.microsoft.com/api/investigations

要求ヘッダー

名前	型	説明
Authorization	String	ベアラー {token}。必須。

要求本文

Empty

応答

成功した場合、このメソッドは、Investigations エンティティのコレクションを含む 200 OK 応答コードを返します。

例

要求の例

すべての調査を取得する要求の例を次に示します。

GET https://api.securitycenter.microsoft.com/api/investigations

応答の例

応答の例を次に示します。

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Investigations",
    "value": [
        {
            "id": "63017",
            "startTime": "2020-01-06T14:11:34Z",
            "endTime": null,
            "state": "Running",
            "cancelledBy": null,
            "statusDetails": null,
            "machineId": "a69a22debe5f274d8765ea3c368d00762e057b30",
            "computerDnsName": "desktop-gtrcon0",
            "triggeringAlertId": "da637139166940871892_-598649278"
        }
        ...
    ]
}

ヒント

さらに多くの情報を得るには、 Tech Community 内の Microsoft Security コミュニティ (Microsoft Defender for Endpoint Tech Community) にご参加ください。

次の方法で共有