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 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
group
|
path | True |
string uuid |
工作区 ID。 |
user
|
path | True |
string |
用户主体名称 (UPN) 要删除的服务主体的组或应用对象 ID 的用户或组对象 ID。 |
is
|
query |
boolean |
给定用户是否为组。 当用户要删除为组时,此参数是必需的。 |
|
profile
|
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