Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Описание API
Добавляет или удаляет тег для определенного устройства.
Ограничения
Вы можете опубликовать публикацию на компьютерах, которые видели в последний раз в соответствии с настроенным периодом хранения.
Ограничения скорости для этого API : 100 вызовов в минуту и 1500 вызовов в час.
Разрешения
При получении маркера с использованием учетных данных пользователя:
- Пользователь должен иметь по крайней мере следующее разрешение роли: "Управление параметрами безопасности". Дополнительные сведения см. в статье Создание ролей и управление ими.
- Пользователь должен иметь доступ к компьютеру на основе параметров группы компьютеров. Дополнительные сведения см. в статье Создание групп компьютеров и управление ими.
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая выбор разрешений, см. в статье Использование API Defender для конечных точек.
| Тип разрешения | Разрешение | Отображаемое имя разрешения |
|---|---|---|
| Приложение | Machine.ReadWrite.All | "Чтение и запись всех сведений о компьютере" |
| Делегированные (рабочая или учебная учетная запись) | Machine.ReadWrite | "Чтение и запись сведений о компьютере" |
HTTP-запрос
POST https://api.security.microsoft.com/api/machines/{id}/tags
Заголовки запросов
| Имя | Тип | Описание |
|---|---|---|
| Авторизация | String | Носитель {token}. Обязательное поле. |
| Content-Type | string | application/json. Обязательное поле. |
Текст запроса
Чтобы удалить тег компьютера, задайте для действия значение "Удалить", а не "Добавить" в тексте запроса.
В тексте запроса укажите объект JSON со следующими параметрами:
| Параметр | Тип | Описание |
|---|---|---|
| Значение | String | Имя тега. Обязательное поле. |
| Действие | Перечисление | Добавление или удаление. Допустимые значения: "Добавить" или "Удалить". Обязательное поле. |
Отклик
В случае успешного выполнения этот метод возвращает код ответа 200 — ОК и обновленный компьютер в тексте ответа.
Пример запроса
Ниже приведен пример запроса, который добавляет тег компьютера.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags
{
"Value" : "test Tag 2",
"Action": "Add"
}