获取安全建议

适用于：

• Microsoft Defender for Endpoint 计划 1
• Microsoft Defender for Endpoint
• Microsoft Defender 漏洞管理

希望体验 Defender for Endpoint？ 注册免费试用版。

想要体验Microsoft Defender 漏洞管理？ 详细了解如何注册Microsoft Defender 漏洞管理公共预览版试用版。

注意

如果你是美国政府客户，请使用美国政府客户Microsoft Defender for Endpoint中列出的 URI。

提示

为了提高性能，可以使用离地理位置更近的服务器：

• us.api.security.microsoft.com
• eu.api.security.microsoft.com
• uk.api.security.microsoft.com
• au.api.security.microsoft.com
• swa.api.security.microsoft.com

重要

本文中的某些信息与预发行的产品有关，该产品在商业发布之前可能有重大修改。 Microsoft 对此处所提供的信息不作任何明示或默示的保证。

检索与给定设备 ID 相关的安全建议集合。

权限

要调用此 API，需要以下权限之一。 若要了解详细信息（包括如何选择权限），请参阅使用Microsoft Defender for Endpoint API

权限类型	权限	权限显示名称
应用程序	SecurityRecommendation.Read.All	“读取威胁和漏洞管理安全建议信息”
委派（工作或学校帐户）	SecurityRecommendation.Read	“读取威胁和漏洞管理安全建议信息”

HTTP 请求

GET /api/machines/{machineId}/recommendations

请求标头

名称	类型	说明
Authorization	String	持有者 {token}。 必需。

请求正文

Empty

响应

如果成功，此方法在正文中返回 200 OK 以及安全建议。

示例

请求示例

下面是一个请求示例。

GET https://api.securitycenter.microsoft.com/api/machines/ac233fa6208e1579620bf44207c4006ed7cc4501/recommendations

响应示例

下面是一个响应示例。

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Recommendations",
    "value": [
        {
            "id": "va-_-git-scm-_-git",
            "productName": "git",
            "recommendationName": "Update Git to version 2.24.1.2",
            "weaknesses": 3,
            "vendor": "git-scm",
            "recommendedVersion": "2.24.1.2",
            "recommendationCategory": "Application",
            "subCategory": "",
            "severityScore": 0,
            "publicExploit": false,
            "activeAlert": false,
            "associatedThreats": [],
            "remediationType": "Update",
            "status": "Active",
            "configScoreImpact": 0,
            "exposureImpact": 0,
            "totalMachineCount": 0,
            "exposedMachinesCount": 1,
            "nonProductivityImpactedAssets": 0,
            "relatedComponent": "Git"
        },
...
}

相关主题

• Microsoft Defender 漏洞管理
• Defender 漏洞管理安全建议

提示

想要了解更多信息？ Engage技术社区中的 Microsoft 安全社区：Microsoft Defender for Endpoint技术社区。