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

Admin - Groups DeleteUserAsAdmin

  • Ссылка
Служба:
Power BI REST APIs
Версия API:
v1.0

Удаляет разрешения пользователя из указанной рабочей области.

Этот вызов API поддерживает удаление пользователя, группы безопасности, группы M365 и субъекта-службы. Используйте адрес электронной почты или имя участника-пользователя для пользователя, идентификатор объекта группы для группы и идентификатор объекта приложения для удаляемого субъекта-службы.

Разрешения

Пользователь должен иметь права администратора (например, Office 365 глобального администратора или администратора службы Power BI).

Требуемая область

Tenant.ReadWrite.All

Ограничения

Максимум 200 запросов в час. 

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}
С использованием необязательных параметров: 
DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}?profileId={profileId}&isGroup={isGroup}

Параметры URI

Имя В Обязательно Тип Описание
groupId
 path True

string

uuid

Идентификатор рабочей области.
user
 path True

string

Имя участника-пользователя (UPN) пользователя или идентификатор объекта группы или объекта приложения удаляемого субъекта-службы.
isGroup
 query

boolean

Является ли данный пользователь группой или нет. Этот параметр является обязательным, если пользователь, который требуется удалить, является group.
profileId
 query

string

uuid

Идентификатор удаляемого профиля субъекта-службы.

Ответы

Имя Тип Описание
200 OK

ОК

Примеры

Delete group example
Delete guest user example
Delete service principal example
Delete user example

Delete group example

Образец запроса

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/23476f5a-7190-43c6-bf12-7a135c6c2d23?isGroup=True

Пример ответа

Код состояния:
200

Delete guest user example

Образец запроса

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/john_contoso.com%23EXT%23@test.com

Пример ответа

Код состояния:
200

Delete service principal example

Образец запроса

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/23476f5a-7190-43c6-bf12-7a135c6c2d23

Пример ответа

Код состояния:
200

Delete user example

Образец запроса

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d69/users/john@contoso.com

Пример ответа

Код состояния:
200