Admin - Capacities GetCapacityUsersAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

指定したワークスペースにアクセスできるユーザーの一覧を返します。

アクセス許可

• ユーザーは管理者権限 (Office 365グローバル管理者や Power BI サービス管理者など) を持っている必要があります。
• 委任されたアクセス許可がサポートされています。

サービス の prinicipal 認証で実行する場合、アプリには、Azure portalで Power BI に対して管理者の同意が必要な事前使用許可が設定されていない必要があります。

必要なスコープ

Tenant.Read.All または Tenant.ReadWrite.All

標準の委任された管理者アクセス トークンを使用して認証する場合にのみ関連します。 サービス プリンシパル経由の認証を使用する場合は、存在しないようにする必要があります。

GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/users

URI パラメーター

名前	/	必須	型	説明
capacityId	path	True	string uuid	容量 ID

応答

名前	型	説明
200 OK	CapacityUsers	OK

定義

名前	説明
CapacityUser	容量の Power BI ユーザー アクセス権エントリ
capacityUserAccessRight	ユーザーが容量に対して持っているアクセス権
CapacityUsers	容量にアクセスできる Power BI ユーザーの一覧の OData 応答ラッパー
PrincipalType	プリンシパルの種類
ServicePrincipalProfile	Power BI サービス プリンシパル プロファイル。 マルチテナント ソリューションPower BI Embeddedにのみ関連します。

CapacityUser

容量の Power BI ユーザー アクセス権エントリ

名前	型	説明
capacityUserAccessRight	capacityUserAccessRight	ユーザーが容量に対して持っているアクセス権
displayName	string	プリンシパルの表示名
emailAddress	string	ユーザーの電子メール アドレス
graphId	string	Microsoft Graph のプリンシパルの識別子。 管理者 API でのみ使用できます。
identifier	string	プリンシパルの識別子
principalType	PrincipalType	プリンシパルの種類
profile	ServicePrincipalProfile	Power BI サービス プリンシパル プロファイル。 マルチテナント ソリューションPower BI Embeddedにのみ関連します。
userType	string	ユーザーの種類。

capacityUserAccessRight

ユーザーが容量に対して持っているアクセス権

名前	型	説明
Admin	string	ユーザーが容量に対する管理者権限を持っている
Assign	string	ユーザーは共同作成者の権限を持ち、ワークスペースを容量に割り当てることができます
None	string	ユーザーが容量にアクセスできない

CapacityUsers

容量にアクセスできる Power BI ユーザーの一覧の OData 応答ラッパー

名前	型	説明
odata.context	string
value	CapacityUser[]	容量にアクセスできるユーザーの一覧

PrincipalType

プリンシパルの種類

名前	型	説明
App	string	サービス プリンシパルの種類
Group	string	グループ プリンシパルの種類
None	string	プリンシパルの種類はありません。 組織全体レベルのアクセスに使用します。
User	string	ユーザー プリンシパルの種類

ServicePrincipalProfile

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

名前	型	説明
displayName	string	サービス プリンシパル プロファイル名
id	string	サービス プリンシパル プロファイル ID