次の方法で共有

REST API のトラブルシューティング

  • [アーティクル]

API の呼び出しで 401 が返される

さらに調査するには、Fiddler キャプチャが必要になる場合があります。 Microsoft Entra ID 内の登録済みアプリケーションに対して必要なアクセス許可スコープが不足している可能性があります。 Azure portal 内で Microsoft Entra ID のアプリ登録内に必要なスコープが存在することを確認します。

API の呼び出しで 403 が返される

403 エラーは、次のいずれかの理由で発生することがあります。 さらに調査するには、Fiddler キャプチャが必要になる場合があります。

  • ユーザーが共有容量で生成できる埋め込みトークンの量を超えました。 埋め込みトークンを生成するための Azure 容量を購入し、ワークスペースをその容量に割り当てます。 「Azure Portal での 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 要求を送信すると、テナントのデータが含まれていないクラスターに到着する場合があります。 そのような場合に、タイムアウトによって要求のリダイレクトが失敗することがあります。

タイムアウト例外を修正するには、preferClientRouting URL クエリパラメーターを true に設定して要求を再送信します。 要求が間違ったクラスターに到着すると、Power BI サービスによって 307 Temporary Redirect HTTP 応答が返されます。 このような場合は、応答 "HTTPS Location ヘッダー" で指定された新しいアドレスに要求をリダイレクトする必要があります。

パラメーターの更新またはデータ ソースの更新 API が数分後に失敗する

応答ヘッダーで、次の一般的なエラーが返される場合があります。

HTTP/1.1 500 Internal Server Error

An error has occurred

「データセット - グループ内のパラメーターの更新」または「データセット - グループ内のデータソースの更新」の API を使用する場合、このエラーは、大規模なデータセット形式を使用していない大規模なデータセットを更新していることを示している可能性があります。 このエラーを回避するには、大規模なデータセット形式を使用します。

関連するコンテンツ

Power BI Embedded に関してよく寄せられる質問

他にわからないことがある場合は、 Power BI コミュニティに質問する