REST API 疑难解答

API 调用返回 401

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

API 调用返回 403

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

• 用户已超过可在共享容量上生成的嵌入令牌的数量。 购买 Azure 容量以生成嵌入令牌，并将工作区分配给该容量。 请参阅在 Azure 门户创建 Power BI Embedded 容量。

• Azure AD 身份验证标记已过期。

• 经过身份验证的用户不是组（工作区）的成员。

• 经过身份验证的用户不是组（工作区）的管理员。

• 经过身份验证的用户没有权限。 可以使用 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 请求时，该请求可能会到达不包含租户数据的群集。 在这种情况下，重定向请求可能因超时而失败。

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

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

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

HTTP/1.1 500 Internal Server Error

JSON

An error has occurred

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