列表指示器 API

项目
05/03/2024

适用于：

希望体验 Microsoft Defender for Endpoint？注册免费试用版。

注意

如果你是美国政府客户，请使用美国政府客户Microsoft Defender for Endpoint中列出的 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

API 说明

检索所有活动指示器的集合。

支持 OData V4 查询。

OData 的$filter查询在以下属性上受支持：application、、expirationTimecreatedByDisplayName、generateAlertindicatorValuerbacGroupIdsrbacGroupNamestitlecreationTimeDateTimeUtccreatedByindicatorType、action、和 severity 属性。
$stop 最大值为 10,000。
$skip.

请参阅使用 Microsoft Defender for Endpoint 的 OData 查询中的示例。

限制

此 API 的速率限制是每分钟 100 个调用和每小时 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

响应

如果成功，此方法将返回 200，“确定”响应代码，其中包含一组指标实体。

注意

如果应用程序具有 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 响应