Удаление параметра группы
Пространство имен: microsoft.graph
Удаление объекта groupSetting на уровне клиента или группы.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Для всех параметров, кроме объекта "Параметры политики согласия"
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | Directory.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
Для приложений | Directory.ReadWrite.All |
Объект параметров политики согласия
Для обновления объекта каталога "Параметры политики согласия" требуются следующие разрешения.
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | Policy.ReadWrite.Authorization |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
Приложение | Policy.ReadWrite.Authorization |
В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю должна быть назначена поддерживаемая роль Microsoft Entra или настраиваемая роль с разрешением поддерживаемой роли. Для этой операции поддерживаются следующие роли с наименьшими привилегиями.
Роль Microsoft Entra | Разрешенные привилегии |
---|---|
Локальный администратор устройства, присоединенный к Microsoft Entra Читатели каталогов Глобальный читатель |
Чтение основных свойств для шаблонов и параметров параметров |
Администратор групп Запись каталогов |
Управление всеми параметрами группы |
Администратор политики проверки подлинности | Обновлять Password Rule Settings |
Администратор пользователей | Чтение основных свойств для шаблонов и параметров параметров Обновление параметров |
HTTP-запрос
Удаление параметра на уровне клиента.
DELETE /groupSettings/{groupSettingId}
Удалите параметр, относяющийся к группе.
DELETE /groups/{groupId}/settings/{groupSettingId}
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Content-Type | application/json |
Текст запроса
Не указывайте текст запроса для этого метода.
Отклик
В случае успешного выполнения этот метод возвращает код отклика 204 No Content
. Он не возвращает ничего в теле ответа.
Пример
Запрос
В этом примере удаляется объект параметра группы уровня клиента.
DELETE https://graph.microsoft.com/v1.0/groupSettings/{id}
Отклик
HTTP/1.1 204 No Content