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 アプリケーションを登録する」を参照してください。
Power BI アクセス許可の詳細については、Microsoft ID プラットフォーム エンドポイント のアクセス許可と同意に関するページを参照してください。
サービス プリンシパルの使用
サービス プリンシパルを使用している場合、スコープは必要ありません。 Power BI でサービス プリンシパルを使用できるようにすると、アプリケーションの AD アクセス許可は有効になりません。 サービス プリンシパルを使用する場合、アプリケーションのアクセス許可は Power BI 管理ポータルを使用して管理されます。 詳細については、「Power BI サービスの管理者設定を有効にする」を参照してください。
スコープの追加
Azure AD アプリにアクセス許可を追加するには、次の手順に従います。
Azure でアプリを開きます。
左側の [管理] で、[API アクセス許可 を選択します。
[アクセス許可 追加] を選択します。
[API のアクセス許可の要求] ウィンドウで、Power BI サービス 選択します。
[委任されたアクセス許可 選択します。 API の一覧が表示されます。
アクセス許可を追加する API を展開し、追加するアクセス許可を選択します。
[アクセス許可 追加] を選択します。
スコープの削除
Azure AD アプリからアクセス許可を削除するには、次の手順に従います。
Azure でアプリを開きます。
左側の [管理] で、[API アクセス許可 を選択します。
[コンテキスト メニュー] (アクセス許可省略記号) を選択します。
[アクセス許可 削除] を選択します。
調整
Power BI では、調整を使用して最適なパフォーマンスと信頼性を維持します。 Power BI では、単一ユーザーからのリソースの過剰使用を防ぐために、ユーザーごとの時間枠内の API 呼び出しの数を制限します。
ユーザーが時間枠内に事前に定義された制限を超える要求の数を送信すると、Power BI は、そのユーザーからのそれ以上の要求を短期間調整します。