共用方式為

Admin - Groups DeleteUserAsAdmin

  • 參考
Service:
Power BI REST APIs
API Version:
v1.0

從指定的工作區移除使用者權限。

此 API 呼叫支援移除使用者、安全性群組、M365 群組和服務主體。請針對使用者使用電子郵件地址或 UPN、群組物件識別碼，以及服務主體要刪除的應用程式物件識別碼。

權限

使用者必須具有系統管理員許可權 (，例如Office 365全域管理員或 Power BI 服務管理員) 。

必要範圍

Tenant.ReadWrite.All

限制

每小時最多 200 個要求。 

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}
With optional parameters: 
DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}?profileId={profileId}&isGroup={isGroup}

URI 參數

名稱 位於 必要 類型 Description
groupId
 path True

string

uuid

工作區識別碼。
user
 path True

string

要刪除之服務主體之群組或應用程式物件識別碼的使用者或群組物件識別碼的使用者主體名稱 (UPN) 。
isGroup
 query

boolean

指定的使用者是否為群組。 當使用者刪除為群組時，需要此參數。
profileId
 query

string

uuid

要刪除的服務主體設定檔識別碼。

回應

名稱 類型 Description
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

Status code:
200

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

Status code:
200

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

Status code:
200

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

Status code:
200