Поделиться через

Удалить спонсора

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Удаление спонсора пользователя.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

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

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) User.ReadWrite.All AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, Directory.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений User.ReadWrite.All AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, Directory.ReadWrite.All

Важно!

В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю должна быть назначена поддерживаемая роль Microsoft Entra или настраиваемая роль с разрешением ролиmicrosoft.directory/users/sponsors/update. Для этой операции поддерживаются следующие наименее привилегированные роли:

  • Запись каталогов
  • Администратор пользователей
  • Администратор идентификатора агента — для пользователей агента

HTTP-запрос

DELETE /users/{id}/sponsors/{id}/$ref

Предостережение

Если /$ref не добавляется к запросу и вызывающее приложение имеет разрешения на управление типом объекта спонсора, объект спонсора также удаляется из Microsoft Entra ID; в противном случае 403 Forbidden возвращается ошибка. Например, приложение с User.ReadWrite.All разрешениями удаляет пользователя, который является спонсором. Определенные объекты можно восстановить с помощью API восстановления удаленных элементов.

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

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

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 204 No Content. Он не возвращает ничего в теле ответа.

Примеры

Запрос

Ниже показан пример запроса.

DELETE https://graph.microsoft.com/beta/users/{user-id}/sponsors/{directory-object-id}/$ref

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content
  • Last updated on