按 ID 获取建议Get recommendation by ID

适用于:Microsoft Defender for EndpointApplies to: Microsoft Defender for Endpoint

备注

如果你是美国政府客户,请使用 Microsoft Defender for Endpoint 中针对美国政府客户的 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.

按 ID 检索安全建议。Retrieves a security recommendation by its ID.

权限Permissions

若要调用此 API,需要以下权限之一。One of the following permissions is required to call this API. 若要了解详细信息(包括如何选择权限),请参阅使用 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}

请求标头Request headers

名称Name 类型Type 说明Description
AuthorizationAuthorization 字符串String Bearer {token}。Bearer {token}. 必需Required.

请求正文Request body

EmptyEmpty

响应Response

如果成功,此方法在正文中返回 200 OK 以及安全建议。If successful, this method returns 200 OK 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

响应Response

下面是一个响应示例。Here is an example of the response.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Recommendations/$entity",
    "id": "va-_-google-_-chrome",
    "productName": "chrome",
    "recommendationName": "Update Chrome",
    "weaknesses": 38,
    "vendor": "google",
    "recommendedVersion": "",
    "recommendationCategory": "Application",
    "subCategory": "",
    "severityScore": 0,
    "publicExploit": false,
    "activeAlert": false,
    "associatedThreats": [],
    "remediationType": "Update",
    "status": "Active",
    "configScoreImpact": 0,
    "exposureImpact": 3.9441860465116285,
    "totalMachineCount": 6,
    "exposedMachinesCount": 5,
    "nonProductivityImpactedAssets": 0,
    "relatedComponent": "Chrome"
}