获取设备安全分数
适用于:
希望体验 Microsoft Defender for Endpoint? 注册免费试用版。
注意
如果你是美国政府客户,请使用美国政府客户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
- ina.api.security.microsoft.com
检索 设备的Microsoft安全功能分数。 更高的设备 Microsoft 安全功能分数意味着终结点在网络安全威胁攻击中具有更高的复原能力。
权限
要调用此 API,需要以下权限之一。 若要了解详细信息(包括如何选择权限),请参阅使用Microsoft Defender for Endpoint API 了解详细信息。
权限类型 | 权限 | 权限显示名称 |
---|---|---|
应用程序 | Score.Read.All | “读取威胁和漏洞管理分数” |
委派(工作或学校帐户) | Score.Read | “读取威胁和漏洞管理分数” |
HTTP 请求
GET /api/configurationScore
请求标头
名称 | 类型 | 说明 |
---|---|---|
Authorization | String | 持有者 {token}。 必需。 |
请求正文
Empty
响应
如果成功,此方法返回 200 OK,响应正文中包含设备安全功能分数数据。
示例
请求示例
下面是一个请求示例。
GET https://api.securitycenter.microsoft.com/api/configurationScore
响应示例
下面是一个响应示例。
注意
为简洁起见,可能会截断此处显示的响应列表。
{
"@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ConfigurationScore/$entity",
"time": "2019-12-03T09:15:58.1665846Z",
"score": 340
}
另请参阅
提示
想要了解更多信息? Engage技术社区中的Microsoft安全社区:Microsoft Defender for Endpoint技术社区。