Admin - Users GetUserArtifactAccessAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

傳回 Power BI 專案清單， (例如指定的使用者可存取的報表或儀表板) 。

權限

• 使用者必須具有系統管理員許可權 (，例如Office 365全域管理員或 Power BI 服務管理員) 或使用服務主體進行驗證。
• 支援委派的許可權。

必要範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

限制

每小時最多 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 參數

名稱	位於	必要	類型	Description
userId	path	True	string	使用者之 UPN (圖形識別碼或使用者主體名稱)
artifactTypes	query		string	以逗號分隔的成品類型清單。
continuationToken	query		string	取得結果集下一個區塊所需的權杖

回應

名稱	類型	Description
200 OK	ArtifactAccessResponse	確定

範例

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"
}

定義

名稱	Description
ArtifactAccessEntry	Power BI 專案的使用者存取專案
ArtifactAccessResponse	Power BI 專案清單的 OData 回應包裝函式 (，例如使用者可以存取的報表或儀表板)
ArtifactType	成品類型
PrincipalType	主體類型
ServicePrincipalProfile	Power BI 服務主體設定檔。 僅適用于Power BI Embedded多租使用者解決方案。
User	Power BI 使用者

ArtifactAccessEntry

Power BI 專案的使用者存取專案

名稱	類型	Description
accessRight	string	使用者針對 Power BI 專案擁有的存取權
artifactId	string	Power BI 專案識別碼
artifactType	ArtifactType	Power BI 專案的類型
displayName	string	Power BI 專案的顯示名稱
shareType	string	授與 Power BI 專案存取方式的類型。 僅適用于廣泛共用的成品 API。
sharer	User	共用 Power BI 專案的使用者。 僅適用于廣泛共用的成品 API。

ArtifactAccessResponse

Power BI 專案清單的 OData 回應包裝函式 (，例如使用者可以存取的報表或儀表板)

名稱	類型	Description
artifactAccessEntities	ArtifactAccessEntry[]	使用者可以存取的 Power BI 專案清單
continuationToken	string	結果集中下一個區塊的權杖
continuationUri	string	結果集中下一個區塊的 URI
odata.context	string

ArtifactType

成品類型

名稱	類型	Description
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

主體類型

名稱	類型	Description
App	string	服務主體類型
Group	string	群組主體類型
None	string	沒有主體類型。 用於整個組織層級存取。
User	string	使用者主體類型

ServicePrincipalProfile

Power BI 服務主體設定檔。 僅適用于Power BI Embedded多租使用者解決方案。

名稱	類型	Description
displayName	string	服務主體設定檔名稱
id	string	服務主體設定檔識別碼

User

Power BI 使用者

名稱	類型	Description
displayName	string	主體的顯示名稱
emailAddress	string	使用者的電子郵件地址
graphId	string	Microsoft Graph 中主體的識別碼。 僅適用于系統管理員 API。
identifier	string	主體的識別碼
principalType	PrincipalType	主體類型
profile	ServicePrincipalProfile	Power BI 服務主體設定檔。 僅適用于Power BI Embedded多租使用者解決方案。
userType	string	使用者的類型。