通过

Admin - Users GetUserSubscriptionsAsAdmin

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

返回指定用户的订阅列表。 这是预览 API 调用。

权限

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

所需范围

Tenant.Read.All 或 Tenant.ReadWrite.All

局限性

每小时最多 200 个请求。 

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions
具有可选参数: 
GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions?continuationToken={continuationToken}

URI 参数

名称 在 必需 类型 说明
userId
 path True

string

用户的图形 ID 或用户主体名称 （UPN）
continuationToken
 query

string

获取结果集的下一个区块所需的令牌

响应

名称 类型 说明
200 OK

SubscriptionsByUserResponse

还行

示例

Example

示例请求

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

示例响应

状态代码:
200 
{
  "subscriptionEntities": [
    {
      "id": "9225d0bc-9f5e-4819-a637-799c0c4fh3f1",
      "title": "Team Scorecard-test",
      "artifactId": "0b50f0bf-b22b-4685-83b9-b6d17f7f4e46",
      "artifactDisplayName": "Customer Profitability Sample",
      "subArtifactDisplayName": "Team Scorecard",
      "artifactType": "Report",
      "isEnabled": false,
      "frequency": "Daily",
      "startDate": "8/10/2021 12:00:00 AM",
      "endDate": "8/10/2022 12:00:00 AM",
      "linkToContent": false,
      "previewImage": true,
      "attachmentFormat": "PNG",
      "users": []
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/subscriptions?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

定义

名称 说明
PrincipalType

主体类型
ServicePrincipalProfile

Power BI 服务主体配置文件。 仅适用于 Power BI Embedded 多租户解决方案。
Subscription

Power BI 项的电子邮件订阅（例如报表或仪表板）
SubscriptionsByUserResponse

用户的 Power BI 订阅的 OData 响应包装器
SubscriptionUser

Power BI 电子邮件订阅用户

PrincipalType

枚举

主体类型

值 说明
None

无主体类型。 用于整个组织级别的访问。
User

用户主体类型
Group

组主体类型
App

服务主体类型

ServicePrincipalProfile

Object

Power BI 服务主体配置文件。 仅适用于 Power BI Embedded 多租户解决方案。

名称 类型 说明
displayName

string

服务主体配置文件名称
id

string (uuid)

服务主体配置文件 ID

Subscription

Object

Power BI 项的电子邮件订阅（例如报表或仪表板）

名称 类型 说明
artifactDisplayName

string

订阅的 Power BI 项的名称（例如报表或仪表板）
artifactId

string (uuid)

订阅的 Power BI 项的 ID（例如报表或仪表板）
artifactType

string

Power BI 项的类型（例如 Report、Dashboard或 Dataset）
attachmentFormat

string

电子邮件订阅中附加的报表的格式
endDate

string (date-time)

电子邮件订阅的结束日期和时间
frequency

string

电子邮件订阅的频率
id

string (uuid)

订阅 ID
isEnabled

boolean

是否启用电子邮件订阅
linkToContent

boolean

电子邮件订阅中是否存在订阅链接
previewImage

boolean

电子邮件订阅中是否存在报表的屏幕截图
startDate

string (date-time)

电子邮件订阅的开始日期和时间
subArtifactDisplayName

string

订阅的 Power BI 项的页面名称（如果是报表）。
title

string

应用名称
users

SubscriptionUser[]

每个电子邮件订阅者的详细信息。 使用 获取用户订阅作为管理员 API 调用时，返回的值是空数组（null）。 将在即将发布的版本中从有效负载响应中删除此属性。 可以使用 以 管理员身份获取报表订阅或 获取仪表板订阅作为管理员 API 调用来检索 Power BI 报表或仪表板上的订阅信息。

SubscriptionsByUserResponse

Object

用户的 Power BI 订阅的 OData 响应包装器

名称 类型 说明
@odata.context

string

continuationToken

string

用于获取结果集的下一个区块的令牌
continuationUri

string

结果集中下一个区块的 URI
subscriptionEntities

Subscription[]

用户的订阅

SubscriptionUser

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

用户的类型。