Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Описание API
Изолирует устройство от доступа к внешней сети.
При изоляции устройства допускаются только определенные процессы и назначения. Поэтому устройства, которые находятся за полным VPN-туннелем, не смогут связаться с Microsoft Defender для конечной точки облачной службой после изоляции устройства. Мы рекомендуем использовать vpn с разделением туннелирования для Microsoft Defender для конечной точки и Microsoft Defender трафика, связанного с облачной защитой антивирусной программы.
Вызов этого API на неуправляемых устройствах активирует устройство contain из действия сети . Для параметра IsolationType должно быть задано значение UnManagedDevice.
Ограничения
Ограничения скорости для этого API — 100 вызовов в минуту и 1500 вызовов в час.
Предварительные условия
Поддерживаемые операционные системы
- Полная изоляция доступна для устройств на Windows 10 версии 1703 и на Windows 11.
- Полная изоляция доступна для всех поддерживаемых устройств Linux. См. Microsoft Defender для конечной точки в Linux.
- Выборочная изоляция доступна для устройств на Windows 10 версии 1709 или более поздней, а также на Windows 11.
Разрешения
При получении маркера с использованием учетных данных пользователя:
- Пользователь должен иметь по крайней мере следующее разрешение роли: "Активные действия по исправлению". Дополнительные сведения см. в разделе Создание ролей и управление ими.
- Пользователь должен иметь доступ к устройству на основе параметров группы устройств. Дополнительные сведения см. в статье Создание групп устройств и управление ими.
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая выбор разрешений, см. в статье Использование API Microsoft Defender для конечной точки.
| Тип разрешения | Разрешение | Отображаемое имя разрешения |
|---|---|---|
| Приложение | Machine.Isolate | "Изоляция компьютера" |
| Делегированные (рабочая или учебная учетная запись) | Machine.Isolate | "Изоляция компьютера" |
HTTP-запрос
POST https://api.security.microsoft.com/api/machines/{id}/isolate
Заголовки запросов
| Имя | Тип | Описание |
|---|---|---|
| Авторизация | String | Bearer {token}. Обязательное поле. |
| Content-Type | string | application/json. Обязательное поле. |
Текст запроса
В тексте запроса укажите объект JSON со следующими параметрами:
| Параметр | Тип | Описание |
|---|---|---|
| Comment | String | Комментарий для связывания с действием. Обязательное поле. |
| IsolationType | String | Тип изоляции. Допустимые значения: Full, Селективный или UnManagedDevice. |
IsolationType управляет типом изоляции для выполнения и может быть одним из следующих:
- Full: полная изоляция. Работает с управляемыми устройствами.
- Выборочный. Ограничьте доступ к сети только ограниченному набору приложений на управляемых устройствах. Дополнительные сведения см. в разделе Изоляция устройств от сети.
- UnManagedDevice: изоляция предназначена только для неуправляемых устройств.
Отклик
В случае успешного выполнения этот метод возвращает 201 — созданный код ответа и действие компьютера в тексте ответа.
Пример
Запрос
Ниже приведен пример запроса.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/isolate
{
"Comment": "Isolate machine due to alert 1234",
"IsolationType": "Full"
}