Admin - Groups DeleteUserAsAdmin

  • リファレンス
Service:
Power BI REST APIs
API Version:
v1.0

指定したワークスペースからユーザーのアクセス許可を削除します。

この API 呼び出しでは、ユーザー、セキュリティ グループ、M365 グループ、サービス プリンシパルの削除がサポートされています。削除するサービス プリンシパルの場合は、ユーザーにはメール アドレスまたは UPN、グループ オブジェクト ID はグループ、アプリ オブジェクト ID は使用してください。

アクセス許可

ユーザーには管理者権限 (Office 365グローバル管理者や Power BI サービス管理者など) が必要です。

必要なスコープ

Tenant.ReadWrite.All

制限事項

1 時間あたり最大 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 パラメーター

名前 / 必須 型 説明
groupId
 path True

string

uuid

ワークスペース ID。
user
 path True

string

削除するサービス プリンシパルのグループまたはアプリ オブジェクト ID のユーザーまたはグループ オブジェクト ID のユーザー プリンシパル名 (UPN)。
isGroup
 query

boolean

特定のユーザーがグループであるかどうか。 このパラメーターは、削除するユーザーがグループである場合に必要です。
profileId
 query

string

uuid

削除するサービス プリンシパル プロファイル ID。

応答

名前 型 説明
200 OK

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