使用 Power BI REST API

Power BI REST API 提供用于嵌入、管理、治理和用户资源的服务终结点。

使用 Power BI REST API 可以执行以下操作:

  • 管理 Power BI 内容

  • 执行管理员操作

  • 嵌入 Power BI 内容

备注

  • 某些 Power BI API 将工作区称为组。 对组的任何引用都意味着你正在使用工作区。

  • 访问 Power BI REST API 时,你的请求和响应内容和数据可能会被 Power BI 租户主区域以外的区域中的数据中心处理。

作用域

若要使用 Power BI REST API,需要在 Azure 中注册 Azure Active Directory (Azure AD) 应用程序。 Azure AD 应用程序为 Power BI REST 资源建立权限,并允许访问 Power BI REST API。 若要了解如何注册应用,请参阅 注册要用于 Power BI 的 Azure AD 应用程序

注册 Azure AD 应用后,可以使用 Azure AD (v1.0 对其进行身份验证;ADAL) 或 Microsoft 标识平台 (v2.0;MSAL) 终结点。 若要详细了解这些身份验证方法的工作原理,请参阅为什么更新到 Microsoft 标识平台 (v2.0) ?

有关 Power BI 访问权限的详细信息,请参阅 Microsoft 标识平台终结点中的权限和许可

使用服务主体

如果使用 服务主体,则不需要范围。 启用与 Power BI 一起使用的服务主体后,应用程序的 AD 权限将不再生效。 使用服务主体时,应用程序的权限通过 Power BI 管理门户进行管理。 有关详细信息,请参阅“启用Power BI 服务管理员设置”。

添加范围

若要向 Azure AD 应用添加权限,请执行以下步骤:

  1. 在 Azure 中打开应用。

  2. 在左侧的 “管理”下,选择 API 权限

  3. 选择“添加权限”。

  4. “请求 API 权限 ”窗口中,选择 “Power BI 服务”。

  5. 选择“委托的权限”。 将显示 API 列表。

  6. 展开要向其添加权限的 API,然后选择要向其添加的权限。

  7. 选择“添加权限”。

删除范围

若要从 Azure AD 应用中删除权限,请执行以下步骤:

  1. 在 Azure 中打开应用。

  2. 在左侧的 “管理”下,选择 API 权限

  3. 选择 上下文菜单 (权限省略号) 。

  4. 选择“删除权限”。

REST 操作组

下表列出了 Power BI REST API 操作组。

操作组 说明
管理员 用于处理管理任务的操作。
应用 用于与应用一起使用的操作。
可用功能 返回可用功能的操作。
容量 用于处理容量的操作。
仪表板 用于处理仪表板的操作。
数据流存储帐户 用于处理数据流存储帐户的操作。
数据流 用于处理数据流的操作。
数据集 用于处理数据集的操作。
嵌入令牌 用于处理嵌入令牌的操作。
网关 用于处理网关的操作。
用于处理组的操作。
导入 用于处理导入的操作。
管道 用于处理部署管道的操作。
推送数据集 用于处理推送数据集的操作。
报表 用于处理报表的操作。
模板应用 用于处理模板应用的操作。
用户 用于处理用户的操作。

后续步骤