ソフトウェア インベントリ API の一覧表示

  • 適用対象: Microsoft Defender for Endpoint, Microsoft Defender for Endpoint Plan 1

API の説明

organization ソフトウェア インベントリを取得します。

OData V4 クエリをサポートします。 OData でサポートされている演算子:

  • $filter 次のプロパティを使用します。
    • id
    • name
    • vendor
  • $top 最大値が 10,000 です。
  • $skip

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

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法など、詳細については、「エンドポイント API に Microsoft Defender を使用する」を参照してください。

アクセス許可の種類 アクセス許可 アクセス許可の表示名
アプリケーション Software.Read.All '脅威と脆弱性管理ソフトウェア情報の読み取り'
委任 (職場または学校のアカウント) Software.Read '脅威と脆弱性管理ソフトウェア情報の読み取り'

HTTP 要求

GET /api/Software

要求ヘッダー

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

要求本文

Empty

応答

成功した場合、このメソッドは本文のソフトウェア インベントリで 200 OK を返します。

例

要求の例

以下は、要求の例です。

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