列出指標 API

發行項
05/03/2024

適用於：

想要體驗適用於端點的 Microsoft Defender 嗎？注册免費試用版。

注意事項

如果您是美國政府客戶，請使用美國政府客戶適用於端點的 Microsoft Defender 中所列的 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、、createdByDisplayName、expirationTime、generateAlert、、title、rbacGroupNames、rbacGroupIds、indicatorTypeindicatorValue、creationTimeDateTimeUtccreatedBy、 action和 severity 屬性。
$stop 最大值為 10,000。
$skip.

請參閱 OData 查詢與適用於端點的 Microsoft Defender 的範例。

限制

此 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

要求標頭

名稱	類型	描述
授權	字串	持有人 {token}。必要。

要求內文

Empty

回應

如果成功，這個方法會傳回 200 Ok 回應碼，其中包含 Indicator 實體的集合。

注意事項

如果應用程式具有 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 回應