通过

Admin - Groups DeleteUserAsAdmin

服务:
Power BI REST APIs
API 版本:
v1.0

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

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

Permissions

用户必须是 Fabric 管理员。

所需范围

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

要删除的服务主体的用户或组对象 ID 的用户或组对象 ID 的用户主体名称（UPN）。
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

示例请求

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