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

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

Хотите попробовать Microsoft Defender для конечной точки? Зарегистрироваться для бесплатной пробной версии.

Примечание

Если вы клиент правительства США, используйте URL-адреса, указанные в Microsoft Defender для конечных точек для государственных клиентов США.

Совет

Для улучшения производительности можно использовать сервер ближе к географическому расположению:

  • api-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.com

Извлекает свой microsoft Secure Score для устройств. Более высокий показатель microsoft Secure Score для устройств означает, что конечные точки более устойчивы к атакам угроз кибербезопасности.

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, в том числе о выборе разрешений, см. в материале Use Microsoft Defender for Endpoint API.

Тип разрешения Разрешение Имя отображения разрешений
Для приложений Score.Read.All 'Read Threat and Vulnerability Management score'
Делегированные (рабочая или учебная учетная запись) Score.Read 'Read Threat and Vulnerability Management score'

HTTP-запрос

GET /api/configurationScore

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

Имя Тип Описание
Авторизация Строка Bearer {token}. Обязательное поле.

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

переменная Empty

Отклик

В случае успешной работы этот метод возвращает 200 ОК с защищенными данными о оценках устройства в теле отклика.

Пример

Пример запроса

Ниже приведен пример запроса.

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
}

См. также