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

Описание API

Задайте значение устройства для определенного компьютера.
Дополнительные сведения см. в разделе Назначение значений устройств .

Ограничения

1. Вы можете опубликовать публикацию на устройствах, которые последний раз видели в соответствии с настроенным периодом хранения.
2. Ограничения скорости для этого API : 100 вызовов в минуту и 1500 вызовов в час.

Разрешения

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

Тип разрешения	Разрешение	Отображаемое имя разрешения
Приложение	Machine.ReadWrite.All	"Чтение и запись всех сведений о компьютере"
Делегированные (рабочая или учебная учетная запись)	Machine.ReadWrite	"Чтение и запись сведений о компьютере"

Примечание.

При получении маркера с использованием учетных данных пользователя:

• Пользователь должен иметь по крайней мере следующее разрешение роли: "Управление параметрами безопасности". Дополнительные сведения (дополнительные сведения см. в разделе Create и управление ролями).
• Пользователь должен иметь доступ к компьютеру на основе параметров группы компьютеров (дополнительные сведения см. в разделе Create и управление группами компьютеров).

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"
}

Совет

Хотите узнать больше? Engage с сообществом Microsoft Security в нашем техническом сообществе: Microsoft Defender для конечной точки Техническое сообщество.