Получить оценку безопасности устройстваGet device secure score

Область применения:Applies to:

Применяется к: Microsoft Defender для конечной точкиApplies to: Microsoft Defender for Endpoint

Примечание

Если вы клиент правительства США, используйте URL-адреса, указанные в Microsoft Defender для конечных точек для государственных клиентов США.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 Secure Score для устройств.Retrieves your Microsoft Secure Score for Devices. Более высокий показатель microsoft Secure Score для устройств означает, что конечные точки более устойчивы к атакам угроз кибербезопасности.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. Дополнительные сведения, в том числе о выборе разрешений, см. в материале 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 Score.Read.AlllScore.Read.Alll 'Read Threat and Vulnerability Management score''Read Threat and Vulnerability Management score'
Делегированные (рабочая или учебная учетная запись)Delegated (work or school account) Score.ReadScore.Read 'Read Threat and Vulnerability Management score''Read Threat and Vulnerability Management score'

HTTP-запросHTTP request

GET /api/configurationScore

Заголовки запросовRequest headers

ИмяName ТипType ОписаниеDescription
АвторизацияAuthorization StringString Bearer {token}.Bearer {token}. Обязательное поле.Required.

Текст запросаRequest body

переменная EmptyEmpty

ОткликResponse

В случае успешной работы этот метод возвращает 200 ОК с защищенными данными о оценках устройства в теле отклика.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
}

См. такжеSee also