Admin - Users GetUserArtifactAccessAsAdmin

サービス:: Power BI REST APIs

API バージョン:: v1.0

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

権限

ユーザーは、ファブリック管理者であるか、サービスプリンシパルを使用して認証されている必要があります。
委任されたアクセス許可がサポートされています。

必要なスコープ

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

制限

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

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

省略可能なパラメーターを含む:

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	わかりました

例

Example

Example with artifactTypes

Example with Guest User

Example with UPN

Example

要求のサンプル

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

応答のサンプル

状態コード:: 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

要求のサンプル

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

応答のサンプル

状態コード:: 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

要求のサンプル

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

応答のサンプル

状態コード:: 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

要求のサンプル

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

応答のサンプル

状態コード:: 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

Object

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

Object

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

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

ArtifactType

列挙

成果物の種類

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

PrincipalType

列挙

プリンシパルの種類

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

ServicePrincipalProfile

Object

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

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

User

Object

Power BI ユーザー

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

次の方法で共有

Admin - Users GetUserArtifactAccessAsAdmin

権限

必要なスコープ

制限

URI パラメーター

応答

例

Example

要求のサンプル

応答のサンプル

Example with artifactTypes

要求のサンプル

応答のサンプル

Example with Guest User

要求のサンプル

応答のサンプル

Example with UPN

要求のサンプル

応答のサンプル

定義

ArtifactAccessEntry

ArtifactAccessResponse

ArtifactType

PrincipalType

ServicePrincipalProfile

User