Admin - Groups DeleteUserAsAdmin

从指定的工作区中删除用户权限。

此 API 调用支持删除用户、安全组、M365 组和服务主体。请对用户使用电子邮件地址或 UPN,对组使用组对象 ID,对服务主体使用应用对象 ID 进行删除。

权限

用户必须具有管理员权限 (,例如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

工作区 ID。

user
path True

string

用户主体名称 (UPN) 要删除的服务主体的组或应用对象 ID 的用户或组对象 ID。

isGroup
query

boolean

给定用户是否为组。 当用户要删除为组时,此参数是必需的。

profileId
query

string

uuid

要删除的服务主体配置文件 ID。

响应

名称 类型 说明
200 OK

确定

示例

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

Delete group example

Sample Request

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

Sample Response

Delete guest user example

Sample Request

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

Sample Response

Delete service principal example

Sample Request

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

Sample Response

Delete user example

Sample Request

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

Sample Response