通过

Admin - Users GetUserArtifactAccessAsAdmin

服务:
Power BI REST APIs
API 版本:
v1.0

返回指定用户有权访问的 Power BI 项列表（如报表或仪表板）。

Permissions

  • 用户必须是 Fabric 管理员或使用服务主体进行身份验证。
  • 支持委派的权限。

所需范围

Tenant.Read.All 或 Tenant.ReadWrite.All

局限性

每小时最多 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

用户的类型。