ソフトウェアによる推奨事項の取得Get recommendation by software

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

Defender for Endpoint を体験してみませんか?Want to experience Defender for Endpoint? 無料試用版にサインアップします。Sign up for a free trial.

注意

米国政府機関のお客様の場合は、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

重要

一部の情報は、市販される前に大幅に変更される可能性があるプレリリース製品に関するものです。Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft は、ここに記載された情報に関して、明示または黙示を問わず、いかなる保証も行いません。Microsoft makes no warranties, express or implied, with respect to the information provided here.

特定のソフトウェアに関連するセキュリティ推奨事項を取得します。Retrieves a security recommendation related to a specific software.

アクセス許可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 SecurityRecommendation.Read.AllSecurityRecommendation.Read.All '脅威と脆弱性管理のセキュリティに関する推奨事項情報の読み取り''Read Threat and Vulnerability Management security recommendation information'
委任 (職場または学校のアカウント)Delegated (work or school account) SecurityRecommendation.ReadSecurityRecommendation.Read '脅威と脆弱性管理のセキュリティに関する推奨事項情報の読み取り''Read Threat and Vulnerability Management security recommendation information'

HTTP 要求HTTP request

GET /api/recommendations/{id}/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 associated with the security recommendations in the body.

例Example

要求Request

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

GET https://api.securitycenter.microsoft.com/api/recommendations/va-_-google-_-chrome/software

応答Response

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

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Analytics.Contracts.PublicAPI.PublicProductDto",
    "id": "google-_-chrome",
    "name": "chrome",
    "vendor": "google",
    "weaknesses": 38,
    "publicExploit": false,
    "activeAlert": false,
    "exposedMachines": 5,
    "impactScore": 3.94418621
}