API задания значения устройства
Область применения:
- Microsoft Defender для конечной точки (план 1)
- Microsoft Defender для конечной точки (план 2)
- Microsoft Defender XDR
Хотите попробовать Microsoft Defender для конечной точки? Зарегистрироваться для бесплатной пробной версии.
Примечание.
Если вы являетесь клиентом для государственных организаций США, используйте URI, перечисленные в Microsoft Defender для конечной точки для клиентов государственных организаций США.
Совет
Для повышения производительности можно использовать сервер ближе к географическому расположению:
- 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
Описание API
Задайте значение устройства для определенного компьютера.
Дополнительные сведения см. в разделе Назначение значений устройств .
Ограничения
- Вы можете опубликовать публикацию на устройствах, которые последний раз видели в соответствии с настроенным периодом хранения.
- Ограничения скорости для этого API : 100 вызовов в минуту и 1500 вызовов в час.
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая выбор разрешений, см. в статье Использование API Microsoft Defender для конечных точек.
| Тип разрешения | Разрешение | Отображаемое имя разрешения |
|---|---|---|
| Приложение | Machine.ReadWrite.All | "Чтение и запись всех сведений о компьютере" |
| Делегированные (рабочая или учебная учетная запись) | Machine.ReadWrite | "Чтение и запись сведений о компьютере" |
Примечание.
При получении маркера с использованием учетных данных пользователя:
- Пользователь должен иметь по крайней мере следующее разрешение роли: "Управление параметрами безопасности". Дополнительные сведения (дополнительные сведения см. в статье Создание ролей и управление ими ).
- Пользователь должен иметь доступ к компьютеру на основе параметров группы компьютеров (дополнительные сведения см. в разделе Создание групп компьютеров и управление ими ).
HTTP-запрос
POST https://api.security.microsoft.com/api/machines/{machineId}/setDeviceValue
Заголовки запросов
| Имя | Тип | Описание |
|---|---|---|
| Авторизация | String | Bearer {token}. Обязательное поле. |
| Content-Type | string | application/json. Обязательное поле. |
Текст запроса
В тексте запроса укажите объект JSON со следующими параметрами:
| Параметр | Тип | Описание |
|---|---|---|
| DeviceValue | Перечисление | Значение устройства. Допустимые значения: "Обычный", "Низкий" и "Высокий". Обязательное поле. |
Отклик
В случае успешного выполнения этот метод возвращает код ответа 200 — ОК и обновленный компьютер в тексте ответа.
Пример
Запрос
Ниже приведен пример запроса, который добавляет тег компьютера.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/setDeviceValue
{
"DeviceValue" : "High"
}
Совет
Хотите узнать больше? Обратитесь к сообществу Майкрософт по безопасности в техническом сообществе Microsoft Defender для конечной точки Tech Community.