インジケーター 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 クエリは、 application、 createdByDisplayName、 expirationTime、 generateAlert、 title、 rbacGroupNames、 rbacGroupIds、 indicatorValue、 indicatorType、 creationTimeDateTimeUtc、 createdBy、 action、 severity の各プロパティでサポートされます。
$stop 最大値が 10,000 です。
$skip.

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

制限事項

この API のレート制限は、1 分あたり 100 呼び出しと 1 時間あたり 1,500 呼び出しです。

アクセス許可

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

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

HTTP 要求

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

要求ヘッダー

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

要求本文

Empty

応答

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

注:

アプリケーションに Ti.ReadWrite.All アクセス許可がある場合は、すべてのインジケーターに公開されます。それ以外の場合は、作成したインジケーターにのみ公開されます。

例 1

例 1 要求

すべてのインジケーターを取得する要求の例を次に示します。

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

例 1 の応答

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

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Indicators",
    "value": [
        {
            "id": "995",
            "indicatorValue": "12.13.14.15",
            "indicatorType": "IpAddress",
            "action": "Alert",
            "application": "demo-test",
            "source": "TestPrdApp",
            "sourceType": "AadApp",
            "title": "test",
            "creationTimeDateTimeUtc": "2018-10-24T11:15:35.3688259Z",
            "createdBy": "45097602-1234-5678-1234-9f453233e62c",
            "expirationTime": "2020-12-12T00:00:00Z",
            "lastUpdateTime": "2019-10-24T10:54:23.2009016Z",
            "lastUpdatedBy": TestPrdApp,
            "severity": "Informational",
            "description": "test",
            "recommendedActions": "test",
            "rbacGroupNames": []
        },
        {
            "id": "996",
            "indicatorValue": "220e7d15b0b3d7fac48f2bd61114db1022197f7f",
            "indicatorType": "FileSha1",
            "action": "AlertAndBlock",
            "application": null,
            "source": "TestPrdApp",
            "sourceType": "AadApp",
            "title": "test",
            "creationTimeDateTimeUtc": "2018-10-24T10:54:23.2009016Z",
            "createdBy": "45097602-1234-5678-1234-9f453233e62c",
            "expirationTime": "2020-12-12T00:00:00Z",
            "lastUpdateTime": "2019-10-24T10:54:23.2009016Z",
            "lastUpdatedBy": TestPrdApp,
            "severity": "Informational",
            "description": "test",
            "recommendedActions": "TEST",
            "rbacGroupNames": [ "Group1", "Group2" ]
        }
        ...
    ]
}

例 2

例 2 要求

AlertAndBlockアクションを持つすべてのインジケーターを取得する要求の例を次に示します。

GET https://api.securitycenter.microsoft.com/api/indicators?$filter=action+eq+'AlertAndBlock'

例 2 応答