次の方法で共有


管理 API テナント設定

これらの設定は、管理ポータルの [テナント設定] セクションで構成されます。 テナント設定にアクセスして使用する方法については、「テナント設定について」を参照してください。

サービス プリンシパルは読み取り専用の管理 API にアクセスできます

Microsoft Entra ID に登録されている Web アプリは、ユーザーがサインインしていなくても、割り当て済みサービス プリンシパルを使用して、読み取り専用管理 API にアクセスします。 アプリによるサービス プリンシパル認証の使用を許可するには、許可されているセキュリティ グループにそのサービス プリンシパルを含める必要があります。 許可されたセキュリティ グループにサービス プリンシパルを含めることで、管理 API (現在および将来) を通じて利用可能なすべての情報に対する読み取り専用アクセス権をサービス プリンシパルに付与します。 たとえば、ユーザー名とメール、セマンティック モデル、レポートの詳細なメタデータなどです。

サービス プリンシパルのテナント設定を許可するスクリーンショット。

詳細については、「読み取り専用管理 API の使用をサービス プリンシパルに許可する」を参照してください

詳細なメタデータを使用した管理 API 応答の強化

Power BI 管理 API の呼び出しを許可されているユーザーとサービス プリンシパルは、Power BI 項目に関する詳細なメタデータを取得できます。 たとえば、GetScanResult API からの応答には、セマンティック モデルのテーブルと列の名前が含まれます。

詳細なメタデータ テナント設定を使用した管理者 API 応答の強化のスクリーンショット。

詳細については、「メタデータ スキャン」を参照してください。

Note

この設定をサービス プリンシパルに適用するには、[読み取り専用の管理 API の使用をサービス プリンシパルに許可する] テナント設定が有効になっていることを確認してください。 詳細については、「メタデータ スキャンを設定する」を参照してください。

DAX およびマッシュアップ式を使用した管理 API 応答の強化

Power BI 管理 API を呼び出す資格のあるユーザーとサービス プリンシパルは、Power BI 項目を構成するクエリと式に関する詳細なメタデータを取得できます。 たとえば、GetScanResult API からの応答には、DAX 式とマッシュアップ式が含まれます。

DAX およびマッシュアップ式テナント設定を使用した管理者 API 応答の強化のスクリーンショット。

詳細については、「メタデータ スキャン」を参照してください。

Note

この設定をサービス プリンシパルに適用するには、[読み取り専用の管理 API の使用をサービス プリンシパルに許可する] テナント設定が有効になっていることを確認してください。 詳細については、「メタデータ スキャンを設定する」を参照してください。