List 軟體庫存 API

  • 適用於: Microsoft Defender for Endpoint, Microsoft Defender for Endpoint Plan 1

API 描述

取得組織軟體清單。

支援 OData V4 查詢。 OData 支援的操作員：

  • $filter 關於以下性質：
    • id
    • name
    • vendor
  • $top 最高點數為10,000。
  • $skip

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

權限

呼叫此 API 需要以下其中一項權限。 欲了解更多，包括如何選擇權限，請參閱「Use 適用於端點的 Microsoft Defender APIS」詳情。

權限類型 權限 權限顯示名稱
應用程式 軟體。全部閱讀 「閱讀威脅與漏洞管理軟體資訊」
委託 (工作或學校帳戶) 軟體。閱讀 「閱讀威脅與漏洞管理軟體資訊」

HTTP 要求

GET /api/Software

要求標頭

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

要求內文

Empty

回應

若成功，此方法會回傳 200 可正常，並附上軟體庫存。

範例

請求範例

以下是該請求的範例。

GET https://api.security.microsoft.com/api/Software

回應範例

以下是回應的範例。

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Software",
    "value": [
            {
                "id": "microsoft-_-edge",
                "name": "edge",
                "vendor": "microsoft",
                "weaknesses": 467,
                "publicExploit": true,
                "activeAlert": false,
                "exposedMachines": 172,
                "impactScore": 2.39947438
            }
            ...
        ]
}
  • Last updated on