Добавление или удаление тега для компьютера

  • Статья

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

Хотите попробовать 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

Добавляет или удаляет тег для определенного устройства.

Примечание.

Если вы ищете, как помечать компьютеры массово с помощью API, см. статью Добавление или удаление нескольких тегов компьютеров.

Ограничения

  1. Вы можете опубликовать публикацию на компьютерах, которые видели в последний раз в соответствии с настроенным периодом хранения.

  2. Ограничения скорости для этого API : 100 вызовов в минуту и 1500 вызовов в час.

Разрешения

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

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

Примечание.

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

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

HTTP-запрос

POST https://api.securitycenter.microsoft.com/api/machines/{id}/tags

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

Имя Тип Описание
Авторизация String Bearer {token}. Обязательное поле.
Content-Type string application/json. Обязательное поле.

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

В тексте запроса укажите объект JSON со следующими параметрами:

Параметр Тип Описание
Значение String Имя тега. Обязательное поле.
Действие Перечисление Добавление или удаление. Допустимые значения: "Добавить" или "Удалить". Обязательное поле.

Отклик

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

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

Ниже приведен пример запроса, который добавляет тег компьютера.

POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags

{
  "Value" : "test Tag 2",
  "Action": "Add"
}

Чтобы удалить тег компьютера, задайте для действия значение "Удалить", а не "Добавить" в тексте запроса.

Совет

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