Admin - Apps GetAppUsersAsAdmin

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

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

アクセス許可

  • ユーザーは管理者権限 (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/apps/{appId}/users

URI パラメーター

名前 / 必須 型 説明
appId
 path True

string

uuid

アプリ ID

応答

名前 型 説明
200 OK

AppUsers

OK

例

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/apps/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Sample Response

Status code:
200 
{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "appUserAccessRight": "ReadExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

定義

名前 説明
AppUser

アプリの Power BI ユーザー アクセス権エントリ
AppUserAccessRight

ユーザーがアプリに対して持っているアクセス権
AppUsers

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

プリンシパルの種類

AppUser

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

名前 型 説明
appUserAccessRight

AppUserAccessRight

ユーザーがアプリに対して持っているアクセス権
displayName

string

プリンシパルの表示名
emailAddress

string

ユーザーの電子メール アドレス
graphId

string

Microsoft Graph のプリンシパルの識別子。 管理者 API でのみ使用できます。
identifier

string

プリンシパルの識別子
principalType

PrincipalType

プリンシパルの種類

AppUserAccessRight

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

名前 型 説明
All

string

アプリ内のコンテンツへの読み取り、書き込み、探索、再共有、コピーアクセスを許可します
None

string

アプリ内のコンテンツに対するアクセス許可なし
Read

string

アプリ内のコンテンツへの読み取りアクセス権を付与します
ReadCopy

string

アプリ内のコンテンツへの読み取りとコピーのアクセス権を付与します
ReadExplore

string

アプリ内のコンテンツへの読み取りと探索のアクセス権を付与します
ReadExploreCopy

string

アプリ内のコンテンツへの読み取り、探索、コピーのアクセス権を付与します
ReadReshare

string

アプリ内のコンテンツへの読み取りと再共有のアクセスを許可します
ReadReshareCopy

string

アプリ内のコンテンツへの読み取り、再共有、コピーアクセスを許可します
ReadReshareExplore

string

アプリ内のコンテンツへの読み取り、再共有、探索アクセスを許可します
ReadReshareExploreCopy

string

アプリ内のコンテンツへの読み取り、再共有、探索、コピーアクセスを許可します
ReadWrite

string

アプリ内のコンテンツへの読み取りと書き込みのアクセス権を付与します
ReadWriteExplore

string

アプリ内のコンテンツへの読み取り、書き込み、探索アクセスを許可する
ReadWriteExploreCopy

string

アプリ内のコンテンツへの読み取り、書き込み、探索、コピーアクセスを許可します
ReadWriteReshare

string

アプリ内のコンテンツへの読み取り、書き込み、再共有アクセスを許可します
ReadWriteReshareExplore

string

アプリ内のコンテンツへの読み取り、書き込み、再共有、探索アクセスを許可します

AppUsers

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

名前 型 説明
odata.context

string

value

AppUser[]

アプリにアクセスできるユーザーの一覧

PrincipalType

プリンシパルの種類

名前 型 説明
App

string

サービス プリンシパルの種類
Group

string

グループ プリンシパルの種類
None

string

プリンシパルの種類はありません。 組織全体レベルのアクセスに使用します。
User

string

ユーザー プリンシパルの種類