Admin - Users GetUserArtifactAccessAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

指定したユーザーがアクセスできる Power BI アイテム (レポートやダッシュボードなど) の一覧を返します。

アクセス許可

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

必要なスコープ

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

制限事項

1 時間あたり最大 200 要求。

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess?continuationToken={continuationToken}&artifactTypes={artifactTypes}

URI パラメーター

名前	/	必須	型	説明
userId	path	True	string	ユーザーのグラフ ID またはユーザー プリンシパル名 (UPN)
artifactTypes	query		string	成果物の種類のコンマ区切りの一覧。
continuationToken	query		string	結果セットの次のチャンクを取得するために必要なトークン

応答

名前	型	説明
200 OK	ArtifactAccessResponse	OK

例

Example

Example with artifactTypes

Example with Guest User

Example with UPN

Example

Sample Request

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

Sample Response

Status code:

200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with artifactTypes

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess?artifactTypes=Dataflow,Dashboard

Sample Response

Status code:

200

{
  "artifactAccessEntities": [
    {
      "artifactId": "09ce06d1-e81b-fea0-1c6d-8fe3dd2f8e87",
      "displayName": "Test Dataflow",
      "artifactType": "Dataflow",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with Guest User

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23@contoso.com/artifactAccess

Sample Response

Status code:

200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23%40contoso.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with UPN

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess

Sample Response

Status code:

200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

定義

名前	説明
ArtifactAccessEntry	Power BI アイテムのユーザー アクセス エントリ
ArtifactAccessResponse	ユーザーがアクセスできる Power BI アイテム (レポートやダッシュボードなど) の一覧の OData 応答ラッパー
ArtifactType	成果物の種類
PrincipalType	プリンシパルの種類
ServicePrincipalProfile	Power BI サービス プリンシパル プロファイル。 マルチテナント ソリューションPower BI Embeddedにのみ関連します。
User	Power BI ユーザー

ArtifactAccessEntry

Power BI アイテムのユーザー アクセス エントリ

名前	型	説明
accessRight	string	ユーザーが Power BI 項目に対して持っているアクセス権
artifactId	string	Power BI 項目 ID
artifactType	ArtifactType	Power BI 項目の種類
displayName	string	Power BI 項目の表示名
shareType	string	Power BI 項目へのアクセス方法の種類。 広く共有されている成果物 API でのみ使用できます。
sharer	User	Power BI アイテムを共有したユーザー。 広く共有されている成果物 API でのみ使用できます。

ArtifactAccessResponse

ユーザーがアクセスできる Power BI アイテム (レポートやダッシュボードなど) の一覧の OData 応答ラッパー

名前	型	説明
artifactAccessEntities	ArtifactAccessEntry[]	ユーザーがアクセスできる Power BI 項目の一覧
continuationToken	string	結果セット内の次のチャンクのトークン
continuationUri	string	結果セット内の次のチャンクの URI
odata.context	string

ArtifactType

成果物の種類

名前	型	説明
App	string	Power BI アプリ
Capacity	string	Capacity オブジェクト
Dashboard	string	Power BI ダッシュボード
Dataflow	string	Power BI データフロー
Dataset	string	Power BI データセット
Group	string	V1 共有ワークスペース オブジェクト
PaginatedReport	string	Power BI のページ分割されたレポート
PersonalGroup	string	自分のワークスペース オブジェクト
Report	string	Power BI レポート
Workspace	string	共有ワークスペース オブジェクト

PrincipalType

プリンシパルの種類

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

ServicePrincipalProfile

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

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

User

Power BI ユーザー

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