Admin - Groups GetGroupUsersAsAdmin
指定したワークスペースにアクセスできるユーザーの一覧を返します。
アクセス許可
- ユーザーは管理者権限 (Office 365グローバル管理者や Power BI サービス管理者など) を持っているか、サービス プリンシパルを使用して認証する必要があります。
- 委任されたアクセス許可がサポートされています。
サービス の prinicipal 認証で実行する場合、アプリには、Azure portalで Power BI に対して管理者の同意が必要な事前使用許可が設定されていない必要があります。
必要なスコープ
Tenant.Read.All または Tenant.ReadWrite.All
標準の委任された管理者アクセス トークンを使用して認証する場合にのみ関連します。 サービス プリンシパル経由の認証を使用する場合は、存在しないようにする必要があります。
制限事項
1 時間あたり最大 200 要求。
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
group
|
path | True |
string uuid |
ワークスペース ID |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK |
例
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Sample Response
{
"value": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"groupUserAccessRight": "Admin",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
},
{
"displayName": "Adam Wood",
"emailAddress": "Adam@contoso.com",
"groupUserAccessRight": "Member",
"identifier": "Adam@contoso.com",
"graphId": "785e192c-0f1f-41ca-ae7a-a85da28e565a",
"principalType": "User"
},
{
"displayName": "ContosoTestApp",
"groupUserAccessRight": "Admin",
"identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
"graphId": "3d9b93c6-7b6d-4801-a491-1738910904fd",
"principalType": "App"
}
]
}
定義
名前 | 説明 |
---|---|
Group |
ワークスペースにアクセスできる Power BI ユーザー |
Group |
ユーザーがワークスペースに対して持っているアクセス権 (アクセス許可レベル) |
Group |
ワークスペースにアクセスできる Power BI ユーザーの一覧の OData 応答ラッパー |
Principal |
プリンシパルの種類 |
Service |
Power BI サービス プリンシパル プロファイル。 マルチテナント ソリューションPower BI Embeddedにのみ関連します。 |
GroupUser
ワークスペースにアクセスできる Power BI ユーザー
名前 | 型 | 説明 |
---|---|---|
displayName |
string |
プリンシパルの表示名 |
emailAddress |
string |
ユーザーの電子メール アドレス |
graphId |
string |
Microsoft Graph のプリンシパルの識別子。 管理者 API でのみ使用できます。 |
groupUserAccessRight |
ユーザーがワークスペースに対して持っているアクセス権 (アクセス許可レベル) |
|
identifier |
string |
プリンシパルの識別子 |
principalType |
プリンシパルの種類 |
|
profile |
Power BI サービス プリンシパル プロファイル。 マルチテナント ソリューションPower BI Embeddedにのみ関連します。 |
|
userType |
string |
ユーザーの種類。 |
GroupUserAccessRight
ユーザーがワークスペースに対して持っているアクセス権 (アクセス許可レベル)
名前 | 型 | 説明 |
---|---|---|
Admin |
string |
ワークスペース コンテンツに対する管理者権限 |
Contributor |
string |
ワークスペース コンテンツへの読み取りと探索 (ReadExplore) アクセス |
Member |
string |
ワークスペース コンテンツに対する読み取り、再共有、探索 (ReadReshareExplore) アクセス権 |
None |
string |
ワークスペース コンテンツにアクセスできない |
Viewer |
string |
ワークスペース コンテンツへの読み取り専用 (読み取り) アクセス |
GroupUsers
ワークスペースにアクセスできる Power BI ユーザーの一覧の OData 応答ラッパー
名前 | 型 | 説明 |
---|---|---|
odata.context |
string |
|
value |
ワークスペースにアクセスできるユーザーの一覧 |
PrincipalType
プリンシパルの種類
名前 | 型 | 説明 |
---|---|---|
App |
string |
サービス プリンシパルの種類 |
Group |
string |
グループ プリンシパルの種類 |
None |
string |
プリンシパルの種類はありません。 組織全体レベルのアクセスに使用します。 |
User |
string |
ユーザー プリンシパルの種類 |
ServicePrincipalProfile
Power BI サービス プリンシパル プロファイル。 マルチテナント ソリューションPower BI Embeddedにのみ関連します。
名前 | 型 | 説明 |
---|---|---|
displayName |
string |
サービス プリンシパル プロファイル名 |
id |
string |
サービス プリンシパル プロファイル ID |