共用方式為

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 要求時，它可能會抵達不包含您的租用戶資料的叢集。 在此情況下，重新導向要求可能會因逾時而失敗。

若要修正逾時例外狀況，請使用設定為 true 的 preferClientRouting URL 查詢參數來重新傳送要求。 如果您的要求抵達錯誤的叢集，則 Power BI 服務會傳回 307 暫時重新導向 HTTP 回應。 在這種情況下，您必須將要求重新導向到回應 HTTPS 位置標頭中指定的新位址。

更新參數或更新資料來源 API 會在幾分鐘後失敗

有時，在回應標頭中會傳回以下一般錯誤：

HTTP/1.1 500 Internal Server Error

An error has occurred

使用資料集 - 更新群組中的參數或資料集 - 更新群組中的資料來源 API 時，此錯誤可能表示您正在更新未使用大型資料集格式的大型資料集。 使用大型資料集格式以避免發生此錯誤。

相關內容

Power BI Embedded 常見問題

更多問題嗎？ 詢問 Power BI 社群