次の方法で共有

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 Active Directory (Azure AD) アプリケーションを Azure に登録する必要があります。 Azure AD アプリは、Power BI REST リソースのアクセス許可を確立し、Power BI REST API へのアクセスを許可します。 アプリを登録する方法については、「Power BIで使用する Azure AD アプリケーションを登録する」を参照してください。

Azure AD アプリを登録した後、Azure AD (v1.0;ADAL) または Microsoft ID プラットフォーム (v2.0;MSAL) エンドポイント。 これらの認証方法のしくみの詳細については、「Microsoft ID プラットフォーム (v2.0) に更新する理由」を参照してください。

Power BI アクセス許可の詳細については、Microsoft ID プラットフォーム エンドポイント のアクセス許可と同意に関するページを参照してください。

サービス プリンシパルの使用

サービス プリンシパルを使用している場合、スコープは必要ありません。 Power BI でサービス プリンシパルを使用できるようにすると、アプリケーションの AD アクセス許可は有効になりません。 サービス プリンシパルを使用する場合、アプリケーションのアクセス許可は Power BI 管理ポータルを使用して管理されます。 詳細については、「Power BI サービスの管理者設定を有効にする」を参照してください。

スコープの追加

Azure AD アプリにアクセス許可を追加するには、次の手順に従います。

  1. Azure でアプリを開きます。

  2. 左側の [管理] で、[API アクセス許可 を選択します。

  3. [アクセス許可 追加] を選択します。

  4. [API のアクセス許可の要求] ウィンドウで、Power BI サービス 選択します。

  5. [委任されたアクセス許可 選択します。 API の一覧が表示されます。

  6. アクセス許可を追加する API を展開し、追加するアクセス許可を選択します。

  7. [アクセス許可 追加] を選択します。

スコープの削除

Azure AD アプリからアクセス許可を削除するには、次の手順に従います。

  1. Azure でアプリを開きます。

  2. 左側の [管理] で、[API アクセス許可 を選択します。

  3. [コンテキスト メニュー] (アクセス許可省略記号) を選択します。

  4. [アクセス許可 削除] を選択します。

調整

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 Resource Manager REST APIを使用します。

操作グループ 形容
管理者 管理タスクを操作するための操作。
Apps アプリを操作するための操作。
使用可能な機能 を する 使用可能な機能を返す操作。
容量の 容量を操作するための操作。
ダッシュボードの ダッシュボードを操作するための操作。
データフロー ストレージ アカウントの の データフロー ストレージ アカウントを操作するための操作。
データフロー データフローを操作するための操作。
データセット データセットを操作するための操作。
埋め込みトークン の 埋め込みトークンを操作するための操作。
ゲートウェイ ゲートウェイを操作するための操作。
グループの グループを操作するための操作。
インポート インポートを操作するための操作。
Pipelines デプロイ パイプラインを操作するための操作。
プッシュ データセット プッシュ データセットを操作するための操作。
レポートの レポートを操作するための操作。
Template Apps Template Apps を操作するための操作。
ユーザー ユーザーを操作するための操作。

次の手順

プレイグラウンド

Power BI 埋め込み分析ドキュメント する

.NET SDK の