获取设备安全分数Get device secure score
适用于：Applies to:
- Microsoft Defender for EndpointMicrosoft Defender for Endpoint
- Microsoft 365 DefenderMicrosoft 365 Defender
适用于：Microsoft Defender for EndpointApplies to: Microsoft Defender for Endpoint
- 想要体验 Microsoft Defender for Endpoint？Want to experience Microsoft Defender for Endpoint? 注册免费试用版。Sign up for a free trial.
备注
如果你是美国政府客户，请使用 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
检索你的 Microsoft 设备安全分数。Retrieves your Microsoft Secure Score for Devices. 设备的 Microsoft 安全分数越高，你的终结点就更能够抵御网络安全威胁攻击。A higher Microsoft Secure Score for Devices means your endpoints are more resilient from cybersecurity threat attacks.
权限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 | Score.Read.AlllScore.Read.Alll | "读取威胁和漏洞管理分数"'Read Threat and Vulnerability Management score' |
| 委派（工作或学校帐户）Delegated (work or school account) | Score.ReadScore.Read | "读取威胁和漏洞管理分数"'Read Threat and Vulnerability Management score' |
HTTP 请求HTTP request
GET /api/configurationScore
请求标头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 device secure score data in the response body.
示例Example
请求Request
下面是一个请求示例。Here is an example of the request.
GET https://api.securitycenter.microsoft.com/api/configurationScore
响应Response
下面是一个响应示例。Here is an example of the response.
备注
为简洁起见，可能会截断此处显示的响应列表。The response list shown here may be truncated for brevity.
{
"@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ConfigurationScore/$entity",
"time": "2019-12-03T09:15:58.1665846Z",
"score": 340
}