Groups - Add Group User

指定したユーザーに、指定したワークスペースに対するアクセス許可を付与します。

権限

この API 呼び出しは、サービス プリンシパル プロファイルによって呼び出すことができます。 詳細については、「Power BI Embeddedでのサービス プリンシパル プロファイルの 」を参照してください。

必要なスコープ

Workspace.ReadWrite.All

制限事項

• ワークスペースのユーザーアクセス許可は更新に時間がかかるため、API 呼び出しを使用するときにすぐに使用できない場合があります。 ユーザーのアクセス許可を更新するには、api 呼び出し ユーザーのアクセス許可の更新 を使用します。
• 各ワークスペースは、ワークスペース ロール内の最大 1,000 ユーザーまたはグループ (管理者、メンバー、共同作成者、ビューアー) に制限されます。 グループ内のユーザーの数に制限はありません。 この制限は外部ゲストにも適用されます。
  
  

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users

URI パラメーター

要求本文

応答

例

Assign administrator user access rights to a service principal example

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

Example

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

定義

GroupUser

ワークスペースにアクセスできる Power BI ユーザー

GroupUserAccessRight

ユーザーがワークスペースに対して持っているアクセス権 (アクセス許可レベル)

PrincipalType

プリンシパルの種類

ServicePrincipalProfile

Power BI サービス プリンシパル プロファイル。 Power BI Embedded マルチテナント ソリューションにのみ関連します。