通过

REST API 疑难解答

  • 项目

API 调用返回 401

可能需要进一步调查 Fiddler 捕获。 Microsoft Entra ID 中注册的应用程序可能缺少所需的权限范围。 验证 Azure 门户内 Microsoft Entra ID 的应用注册中是否存在所需的范围。

API 调用返回 403

403 错误可能由于以下任何原因而发生。 可能需要进一步调查 Fiddler 捕获。

  • 用户已超过可在共享容量上生成的嵌入令牌的数量。 购买 Azure 容量以生成嵌入令牌，并将工作区分配给该容量。 请参阅在 Azure 门户创建 Power BI Embedded 容量。
  • Microsoft Entra 授权令牌已过期。
  • 经过身份验证的用户不是组（工作区）的成员。
  • 经过身份验证的用户不是组（工作区）的管理员。
  • 经过身份验证的用户没有权限。 可以使用 refreshUserPermissions API 更新权限。
  • 可能不会正确列出授权标头。 请确保没有拼写错误。

在调用 GenerateToken 前，应用程序的后端可能需要刷新授权令牌。 有关详细信息，请参阅刷新访问令牌。

GET https://wabi-us-north-central-redirect.analysis.windows.net/metadata/cluster HTTP/1.1
Host: wabi-us-north-central-redirect.analysis.windows.net
...
Authorization: Bearer eyJ0eXAiOi...
...

HTTP/1.1 403 Forbidden
...

{"error":{"code":"TokenExpired","message":"Access token has expired, resubmit with a new access token"}}

修复使用导入和导出 API 时出现的超时异常

发送 Power BI REST API 请求时，该请求可能会到达不包含租户数据的群集。 在这种情况下，重定向请求可能因超时而失败。

若要修复超时异常，请重新发送 preferClientRoutingURL 查询参数设置为 true 的请求。 如果请求到达错误的群集，则 Power BI 服务返回“307 临时重定向”HTTP 响应。 在此类情况下，需要请求重定向到响应“HTTPS 位置标头”中指定的新地址。

更新参数或更新数据源 API 在几分钟后失败

响应头中有时会返回以下泛型错误：

HTTP/1.1 500 Internal Server Error

An error has occurred

使用数据集 - 更新组中的参数或数据集 - 更新组中的数据源 API 时，此错误可能表明你正在更新未使用大型数据集格式的大型数据集。 使用大型数据集格式可避免出现错误。

相关内容

Power BI Embedded 常见问题

更多问题？ 在 Power BI 社区提问