使用 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。 若要了解如何注册应用，请参阅 注册 Azure AD 应用程序以用于 Power BI。
注册 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 应用添加权限，请执行以下步骤：
在 Azure 中打开应用。
在左侧的 “管理”下，选择“ API 权限”。
选择“添加权限”。
在 “请求 API 权限 ”窗口中，选择“ Power BI 服务”。
选择“委托的权限”。 将显示 API 列表。
展开要向其添加权限的 API，然后选择要向其添加的权限。
选择“添加权限”。
删除范围
若要从 Azure AD 应用中删除权限，请执行以下步骤：
在 Azure 中打开应用。
在左侧的 “管理”下，选择“ API 权限”。
选择“ 上下文”菜单 ， (权限省略号) 。
选择“删除权限”。
限制
Power BI 使用限制来保持最佳性能和可靠性。 为了防止单个用户过度使用资源，Power BI 限制每个用户在一个时间范围内调用 API 的次数。
当用户在某个时间范围内发送超过预定限制的请求数时，Power BI 会限制该用户发出的任何进一步请求。
当应用程序遇到限制时，Power BI 将返回 HTTP 状态代码 429 (响应中具有 Retry-After HTTP 标头) 请求过多，指示调用应用程序在发出新请求之前需要等待多少秒。
REST 操作组
下表列出了 Power BI REST API 操作组。
注意
若要管理Power BI Embedded容量，请使用 Power BI Embedded Azure 资源管理器 REST API。
| 操作组 | 说明 |
|---|---|
| 管理员 | 用于处理管理任务的操作。 |
| 应用 | 用于与应用一起使用的操作。 |
| 可用功能 | 返回可用功能的操作。 |
| 容量 | 用于处理容量的操作。 |
| 仪表板 | 用于处理仪表板的操作。 |
| 数据流存储帐户 | 用于处理数据流存储帐户的操作。 |
| 数据流 | 用于处理数据流的操作。 |
| 数据集 | 用于处理数据集的操作。 |
| 嵌入令牌 | 用于处理嵌入令牌的操作。 |
| 网关 | 用于处理网关的操作。 |
| 组 | 用于处理组的操作。 |
| 导入 | 用于处理导入的操作。 |
| 管道 | 使用部署管道的操作。 |
| 推送数据集 | 用于处理推送数据集的操作。 |
| 报表 | 用于处理报表的操作。 |
| 模板应用 | 用于处理模板应用的操作。 |
| 用户 | 用于处理用户的操作。 |