Power Platform インベントリ API は、Azure Resource Graph 内の PowerPlatformResources テーブルを通じて現在のインベントリ データを提供します。 API にはコア リソース、所有権、環境、コネクタの情報が含まれていますが、そのスキーマはデータ エクスポート インベントリ スキーマとは異なります。
この記事では、以下について説明します。
- Power Platform インベントリ API を介して利用可能なインベントリ データ。
- データ エクスポートで利用できないインベントリ プロパティ
- 部分的な、または異なる適用範囲を持つプロパティ。
インベントリのクエリの詳細については、「Power Platform インベントリ API」を参照してください。 完全な API スキーマについては、Power Platform インベントリ スキーマ リファレンスを参照してください。
Note
Microsoftは、データ エクスポートのプレビュー バージョンを廃止します。 インベントリ データのエクスポートは、2026 年 12 月 1 日の後に停止します。 使用状況と環境のデータのエクスポートは、既存および新規の構成でも継続され、既にエクスポートしたデータはデータ レイクに残ります。 インベントリ データのエクスポートが停止したときに、Microsoft から別の通知が届きます。
準備するには、 Power Platform インベントリ API を使用して、プログラムでインベントリ データをエクスポートします。 移行する前に、 フィールド マッピングと既知のギャップを確認します。 一部のデータ エクスポート インベントリ フィールドは、API を介して使用できないか、カバレッジが異なります。
Power Platform インベントリ API は、顧客所有のストレージにデータを自動的にエクスポートしません。 定期的なエクスポートを作成するには、Azure Functions、Azure Logic Apps、または Azure Automation などの Azure サービスを使用して、スケジュールに従って Power Platform インベントリ API にクエリを実行し、結果を Azure Blob Storage、Azure Data Lake Storage、またはその他のサポートされている宛先に書き込みます。
サポートされているリソースの種類
Power Platform インベントリ API には、次のリソースの種類が含まれています。
| Resource | Power Platform インベントリ API タイプ |
|---|---|
| キャンバス アプリ | microsoft.powerapps/canvasapps |
| モデル駆動型アプリ | microsoft.powerapps/modeldrivenapps |
| コーディング アプリ | microsoft.powerapps/codeapps |
| 管理対象アプリと App Builder アプリ | microsoft.powerapps/apps |
| クラウド フロー | microsoft.powerautomate/cloudflows |
| エージェントフロー | microsoft.powerautomate/agentflows |
| ワークフロー エージェントの流れ | microsoft.powerautomate/m365agentflows |
| Copilot Studio エージェント | microsoft.copilotstudio/agents |
| Connectors | microsoft.powerplatformconnector/connectors |
| Environments | microsoft.powerplatform/environments |
| 環境グループ | microsoft.powerplatform/environmentgroups |
利用可能なインベントリデータ
次のセクションでは、リソースの種類とデータ カテゴリごとに使用可能なフィールドについて説明します。
共有リソース情報
サポートされているリソースの種類には、次のフィールドを利用可能です。 コネクタはカタログ オブジェクトであり、インベントリ スキーマ リファレンスに記載されている共有フィールドのみをサポートします。
| データ カテゴリ | 利用可能な情報 | Power Platform インベントリ API フィールド |
|---|---|---|
| リソース ID | 一意のインベントリ リソース識別子 | name |
| リソース名 | リソースの表示名 | properties.displayName |
| リソースの種類 | 標準化された Power Platform リソースの種類 | type |
| Tenant | テナント識別子 | tenantId |
| Location | リソースの地理的な場所 | location |
| 作成日 | リソースが作成された日時 | properties.createdAt |
| 作成者 | リソースを作成したユーザーのオブジェクト ID | properties.createdBy |
アプリ情報
サポートされているアプリの種類については、次の情報を利用できます。
| データ カテゴリ | 利用可能な情報 | Power Platform インベントリ API フィールド |
|---|---|---|
| Owner | アプリ所有者のオブジェクト ID | properties.ownerId |
| Environment | アプリを含む環境の識別子 | properties.environmentId |
| 最終変更 | アプリが最後に変更された日時 | properties.lastModifiedAt |
| 最終更新者 | アプリを最後に変更したユーザーのオブジェクト ID | properties.lastModifiedBy |
| 検疫状態 | アプリが隔離されているかどうか | properties.isQuarantined |
| モデル駆動型アプリ ID | Dataverse アプリ モジュール識別子 | properties.appModuleId |
| モデル駆動型アプリの論理名 | Dataverse 論理名 | properties.logicalName |
| コードアプリのサブタイプ |
byocApp または vibeApp |
properties.subType |
| マネージド アプリのサブタイプ | microsoftApp |
properties.subType |
| App Builder サブタイプ | appBuilderApp |
properties.subType |
フロー情報
クラウド フロー、エージェント フロー、およびワークフロー エージェント フローでは、次の情報を利用できます。
| データ カテゴリ | 利用可能な情報 | Power Platform インベントリ API フィールド |
|---|---|---|
| Owner | フロー所有者のオブジェクト ID | properties.ownerId |
| Environment | フローを含む環境の識別子 | properties.environmentId |
| 最終変更 | フローが最後に変更された日時 | properties.lastModifiedAt |
| 最終更新者 | フローを最後に変更したユーザーのオブジェクト ID | properties.lastModifiedBy |
| ワークフロー エンティティ | Dataverse ワークフロー エンティティ識別子 | properties.workflowEntityId |
| トリガー コネクタ | フローを開始するコネクタ | properties.trigger |
| トリガー操作 | フローを開始するコネクタ操作 | properties.triggerOperation |
トリガー フィールドは、フローがコネクタ ベースではないトリガー (繰り返しや手動トリガーなど) を使用する場合は空です。
コネクタの使用状況
コネクタの使用は、サポートされているアプリ、フロー、エージェントで使用できます。
| データ カテゴリ | 利用可能な情報 | Power Platform インベントリ API フィールド |
|---|---|---|
| 使用されたコネクタ | リソースによって使用されるコネクタの識別子 | properties.powerPlatformConnectors[].connectorId |
| 使用した操作 | コネクタで呼び出される操作の識別子 | properties.powerPlatformConnectors[].operations[].operationId |
| フロートリガー | サポートされているフローを開始するコネクタ | properties.trigger |
| フロー トリガーの操作 | サポートされているフローを開始するコネクタ操作 | properties.triggerOperation |
コネクタと操作の利用欄は現在プレビュー段階です。
コネクタ カタログ情報
コネクタは、個々のインベントリ リソースとして見つけることもできます。
| データ カテゴリ | 利用可能な情報 | Power Platform インベントリ API フィールド |
|---|---|---|
| コネクタ ID | コネクタ識別子 | properties.connectorId |
| Description | コネクタの説明 | properties.description |
| Publisher | コネクタのパブリッシャー | properties.publisher |
| Tier | Standard または Premium の分類 | properties.tier |
| リリース段階 | リリース種別 (本番やプレビューなど) | properties.releaseTag |
| 非推奨の状態 | コネクタが非推奨かどうか | properties.isDeprecated |
| Operations | コネクタが公開する操作 | properties.operations |
| 操作ID | 一意の操作識別子 | properties.operations[].operationId |
| 操作名 | 操作の表示名 | properties.operations[].displayName |
| 操作の説明 | 操作の説明 | properties.operations[].description |
| HTTP メソッド | 操作で使用される HTTP メソッド | properties.operations[].method |
環境情報
環境インベントリ レコードに関する次の情報を確認できます。
| データ カテゴリ | 利用可能な情報 | Power Platform インベントリ API フィールド |
|---|---|---|
| 環境 ID | 一意の環境識別子 | name |
| 環境名 | 環境表示名 | properties.displayName |
| Location | 環境の地理的な場所 | location |
| 環境タイプ | 運用環境、既定、サンドボックス、試用版、開発者、または Teams 向け Dataverse | properties.environmentType |
| 管理状態 | 環境がマネージド環境かどうか | properties.isManaged |
| 環境グループ | 割り当てられた環境グループの名前 | properties.environmentGroup |
| 環境グループ ID | 割り当てられた環境グループの識別子 | properties.environmentGroupId |
| 最終変更 | 環境が最後に変更された日時 | properties.lastModifiedAt |
データは利用できません
次のデータ エクスポート インベントリ プロパティには、発行された Power Platform インベントリ API スキーマに直接相当するものはありません。
| データ カテゴリ | Power Platform インベントリ API ではデータ エクスポートのインベントリ情報は利用できません |
|---|---|
| アプリの説明 | キャンバスまたはモデル駆動型アプリの説明 |
| アプリケーション リンク | アプリ URI、ドキュメント URI、アイコン URI、SharePoint フォーム URL |
| 共有 | アプリが共有されているユーザーとグループの数 |
| 削除状態 | 明示的な削除済みリソース インジケータ |
| 有効化履歴 | アプリが最後に有効になった日付と、アプリを有効にしたプリンシパル |
| ソリューションと ALM の情報 | ソリューション関連付けと ALM モード |
| DLP の評価 | 評価状態、評価日、違反メッセージ、ポリシー別の違反 |
| アプリの構成 | 設定、作成の種類、クライアント デバイスの種類、埋め込みホスト、カスタム拡張機能、およびパフォーマンス最適化の設定 |
| アプリの紹介 | 背景画像、背景色、ヒーロー アプリの指定、おすすめアプリの指定、アプリプランの分類 |
| 同意とライセンス | バイパス同意設定とアプリ パスの対象 |
| ドキュメントのバージョン | アプリに関連付けられているドキュメントのバージョン |
| オンプレミス ゲートウェイの使用 | アプリがオンプレミス データ ゲートウェイを使用していることを示す明示的なインジケーター |
| Dataverse テーブルの使用状況 | アプリが Dataverse テーブルを使用していることを示す明示的なインジケーター |
| PCF 外部サービスの使用 | Power Apps コンポーネント フレームワーク コントロールが外部サービスを使用していることを示す明示的なインジケーター |
Important
properties.isQuarantined は、アプリが隔離されているかどうかを示します。 これは、データ エクスポート削除インジケーターと同等ではありません。
異なるカバレッジで利用可能なデータ
一部の Power Platform インベントリ API フィールドは関連情報を提供しますが、データ エクスポート プロパティと直接同等ではありません。
| データ カテゴリ | データエクスポート一覧 | Power Platform インベントリ API の対象範囲 |
|---|---|---|
| リソースの種類 |
type値とsubType値を分離する |
typeの標準化されたリソース識別子。 一部のリソースの種類では、properties.subType も提供しています。 |
| 状態とライフサイクル | リソースの状態とライフサイクルの状態 | 検疫状態は、サポートされているアプリの種類で使用できますが、すべての状態またはライフサイクルの値を表すわけではありません |
| Owner | 所有者値と所有者オブジェクト ID |
properties.ownerId は、使用可能な場合はオブジェクト ID を提供します。 所有者の表示名が含まれていない |
| カスタム API の使用 | 明示的なカスタム API インジケーター | サポートされているリソースではコネクタ識別子を利用できますが、同等のカスタム API インジケーターは利用できません |
| Premium コネクタの使用 | Premium API の明示的な表示 | コネクタ層はコネクタ インベントリ レコードで使用できますが、同等のリソース レベル インジケーターは使用できません |
| ワークフロー アクション | ワークフロー アクションとコネクタ関連のインジケーター | サポートされているリソースの種類に対して、構造化コネクタと操作識別子を利用可能です |
| 環境情報 | リソース上の環境識別子と個別の環境エクスポート データ | リソースには properties.environmentIdが含まれています。 環境の詳細は、環境インベントリ レコードを通じて利用できます |
識別子マッピング
リソース識別子は、データ エクスポートと Power Platform インベントリ API では同じように表されません。
モデル駆動型アプリ
モデル駆動型アプリでは、次のマッピングを使用します。
| 「データ エクスポート インベントリ」フィールド | Power Platform インベントリ API フィールド |
|---|---|
environmentId |
properties.environmentId |
resourceId |
properties.appModuleId |
name |
properties.displayName |
type と subType |
type |
Power Platform インベントリ API の最上位 name フィールドは、一意のインベントリ リソース識別子です。 これは、モデル駆動型アプリのデータ エクスポート resourceId と同等ではありません。
2 つのスキーマ間でモデル駆動型アプリを関連付けるには、 properties.environmentId と properties.appModuleIdの両方を使用します。
コネクタ在庫の制限
コネクタ インベントリには、次の制限事項が文書化されています。
- 表形式コネクタは、空の操作配列と共に存在できます。
- 組み込みのPower Automateアクション (HTTP、制御、データ操作など) はコネクタとして表されません。
- コード アプリ、Vibe アプリ、マネージド アプリ、および App Builder アプリは、コネクタ使用状況データを出力しません。
- モデル駆動型アプリでコネクタについて直接レポートすることはほとんどありません。
- 埋め込みキャンバス ページによるコネクタの使用状況は、含まれるモデル駆動型アプリではなく、キャンバス ページ レコードに関連付けられます。
- リソースごとのコネクタ データにはコネクタと操作の識別子が含まれますが、コネクタの表示名、発行元情報、または層は含まれません。
- コネクタの表示名、発行元情報、および層は、コネクタ インベントリ レコードで利用できます。
- コネクタのプレゼンスは、オンプレミス ゲートウェイが使用されているかどうかを示すわけではありません。