列出電腦和軟體的弱點

適用於:

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

注意

如果您是美國政府客戶,請使用 Microsoft Defender FOR Us 政府客戶的端點中所列的 URIs。

提示

為了提高效能,您可以使用伺服器以接近地理位置:

  • api-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.com

會檢索影響每個 機器軟體之組織的所有安全性漏洞清單。

  • 如果此弱點已修復 KB,它就會出現在回應中。
  • 支援 OData V4 查詢
  • 支援 OData 的查詢:、、、、、、 $filter id cveId machineId fixingKbId productName productVersion severityproductVendor 屬性。
    $stop 10000的最大值為
    $skip

提示

這是Power BI 整合的理想 API。

權限

需要有下列其中一個許可權才能呼叫此 API。 若要深入瞭解,包括如何選擇許可權,請參閱 使用 Microsoft Defender For Endpoint APIs 以取得詳細資訊。

許可權類型 權限 許可權顯示名稱
應用程式 弱點。 Read。 All 「讀取威脅及弱點管理弱點資訊」
委派 (工作或學校帳戶) 弱點。讀取 「讀取威脅及弱點管理弱點資訊」

HTTP 要求

GET /api/vulnerabilities/machinesVulnerabilities

要求標頭

名稱 類型 描述
授權 字串 載荷 {token}。 必要

要求內文

空白

回應

如果成功,這個方法會傳回200的 [確定] 清單中的漏洞。

範例

要求範例

以下是要求的範例。

GET https://api.securitycenter.microsoft.com/api/vulnerabilities/machinesVulnerabilities

回應範例

以下是回應的範例。

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Collection(microsoft.windowsDefenderATP.api.PublicAssetVulnerabilityDto)",
    "value": [
        {
            "id": "5afa3afc92a7c63d4b70129e0a6f33f63a427e21-_-CVE-2020-6494-_-microsoft-_-edge_chromium-based-_-81.0.416.77-_-",
            "cveId": "CVE-2020-6494",
            "machineId": "5afa3afc92a7c63d4b70129e0a6f33f63a427e21",
            "fixingKbId": null,
            "productName": "edge_chromium-based",
            "productVendor": "microsoft",
            "productVersion": "81.0.416.77",
            "severity": "Low"
        },
        {
            "id": "7a704e17d1c2977c0e7b665fb18ae6e1fe7f3283-_-CVE-2016-3348-_-microsoft-_-windows_server_2012_r2-_-6.3.9600.19728-_-3185911",
            "cveId": "CVE-2016-3348",
            "machineId": "7a704e17d1c2977c0e7b665fb18ae6e1fe7f3283",
            "fixingKbId": "3185911",
            "productName": "windows_server_2012_r2",
            "productVendor": "microsoft",
            "productVersion": "6.3.9600.19728",
            "severity": "Low"
        },
        ...
    ]

}

另請參閱