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

適用対象: Microsoft Defender for EndpointApplies to: Microsoft Defender for Endpoint

注意

米国政府機関のお客様の場合は、Microsoft Defender for Endpoint for US Government のお客様に記載されている URI を使用してくださいIf you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

ヒント

パフォーマンスを向上するために、地理的な場所に近いサーバーを使用できます。For better performance, you can use server closer to your geo location:

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

組織のソフトウェア インベントリを取得します。Retrieves the organization software inventory.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。One of the following permissions is required to call this API. アクセス許可の選択方法など、詳細については 、「Use Microsoft Defender for Endpoint API」 を参照してください。To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

アクセス許可の種類Permission type アクセス許可Permission アクセス許可の表示名Permission display name
アプリケーションApplication Software.Read.AllSoftware.Read.All '脅威と脆弱性管理ソフトウェア情報の読み取り''Read Threat and Vulnerability Management Software information'
委任 (職場または学校のアカウント)Delegated (work or school account) Software.ReadSoftware.Read '脅威と脆弱性管理ソフトウェア情報の読み取り''Read Threat and Vulnerability Management Software information'

HTTP 要求HTTP request

GET /api/Software

要求ヘッダーRequest headers

名前Name 種類Type 説明Description
AuthorizationAuthorization 文字列String ベアラー {token}。Bearer {token}. 必須Required.

要求本文Request body

EmptyEmpty

応答Response

成功した場合、このメソッドは、本文のソフトウェア インベントリで 200 OK を返します。If successful, this method returns 200 OK with the software inventory in the body.

Example

要求Request

以下は、要求の例です。Here is an example of the request.

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

応答Response

以下は、応答の例です。Here is an example of the response.

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