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

Удаление агентаПользователь

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

Важно!

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

Удаление объекта agentUser .

Разрешения

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

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

Важно!

Вызывающему пользователю должна быть назначена по крайней мере одна из следующих Microsoft Entra ролей:

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

Чтобы удалить пользователей с привилегированными ролями администратора в делегированных сценариях, приложению должно быть назначено делегированное разрешение Directory.AccessAsUser.All , а вызывающему пользователю должна быть назначена более высокая привилегированная роль администратора, как указано в разделе Кто может выполнять конфиденциальные действия.

В сценариях, доступных только для приложений, разрешения user.ReadWrite.All недостаточно для удаления пользователей с привилегированными административными ролями. Агенту должна быть назначена более высокая привилегированная роль администратора, как указано в разделе Кто может выполнять конфиденциальные действия.

HTTP-запрос

DELETE /users/microsoft.graph.agentUser/{userId}

Примечание. Пользователь агента также можно удалить через конечную точку стандартных пользователей: DELETE /users/userId. В запросе не требуется указывать специальный тип odata.

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

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

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

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

Отклик

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

Примеры

Запрос

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

DELETE https://graph.microsoft.com/beta/users/microsoft.graph.agentUser/ba9a3254-9f18-4209-aeb3-9e42a35b5be4

Отклик

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

HTTP/1.1 204 No Content
  • Last updated on