Power Platform 清单通过 Azure Resource Graph 中的 PowerPlatformResources 表公开资源数据。 本文介绍该表中可用的资源类型和字段,以便可以生成目标查询并了解 Power Platform 清单 体验背后的数据模型。
有关以编程方式查询表的信息,请参阅 Power Platform 清单 API。 有关完整的 REST API 参考,请参阅 Power Platform REST API 文档。
资源类型
表中的每条记录 PowerPlatformResources 都有一个 标识 资源类型的类型字段。 下表列出了所有受支持的类型。
| 显示名称 |
type 值 |
|---|---|
| 画布应用 | microsoft.powerapps/canvasapps |
| 模型驱动应用 | microsoft.powerapps/modeldrivenapps |
| 编程应用 | microsoft.powerapps/codeapps |
| 应用构建器应用程序 | microsoft.powerapps/apps |
| 云端流 | microsoft.powerautomate/cloudflows |
| 代理流 | microsoft.powerautomate/agentflows |
| 工作流智能体流 | microsoft.powerautomate/m365agentflows |
| Copilot Studio代理 | microsoft.copilotstudio/agents |
| 环境 | microsoft.powerplatform/environments |
| 环境组 | microsoft.powerplatform/environmentgroups |
共享资源字段
PowerPlatformResources 表中的所有资源类型包含以下字段。
| 用户体验名称 | API 字段路径 | 数据类型 | 说明 | Example | 地位 |
|---|---|---|---|---|---|
| 物料名称 | properties.displayName |
字符串 | 资源的显示名称。 | 费用报告应用 | 正式发布 |
| 项目类型 | type |
字符串 | 资源类型标识符(请参阅 资源类型)。 | microsoft.powerapps/canvasapps |
正式发布 |
| 物料 ID | name |
字符串 | 资源的唯一标识符。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
| 位置 | location |
字符串 | 资源的地理区域。 | unitedstates |
正式发布 |
| 创建时间 | properties.createdAt |
日期/时间 | 资源的创建日期和时间。 | 2025-06-01T08:00:00Z |
正式发布 |
| 创建者 | properties.createdBy |
字符串 | 创建资源的用户的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
注释
该 tenantId 字段还可用作每个资源记录的顶级 ARM 字段。
连接器清单(预览版)
Power Platform 清单记录了每个资源使用的连接器及其操作。 此数据在 Power Platform 管理中心清单网格中显示为 连接器 列。 统一的 管理>清单 页面、Copilot Studio、Power Apps 和 Power Automate 下特定于资源的视图,以及在编程查询中作为 properties.powerPlatformConnectors 数组。
以下资源类型发出连接器数据:画布应用、模型驱动应用、云流、代理流、工作流代理流和Copilot Studio代理(包括智能 Microsoft 365 Copilot 副驾驶®代理生成器)。
对于流(云流、代理流和工作流代理流),清单还会记录启动该流的连接器和操作,分别为 properties.trigger 和 properties.triggerOperation。 这些字段补充 powerPlatformConnectors,用于捕获在流执行期间调用的连接器。
Schema
| API 字段路径 | 数据类型 | 说明 | 地位 |
|---|---|---|---|
properties.powerPlatformConnectors |
数组 | 资源所使用的连接器。 | Preview |
properties.powerPlatformConnectors[].connectorId |
字符串 | 连接器的标识符(例如 shared_sharepointonline)。 |
Preview |
properties.powerPlatformConnectors[].operations |
数组 | 资源在连接器上调用的操作。 | Preview |
properties.powerPlatformConnectors[].operations[].operationId |
字符串 | 操作的标识符(例如 GetItems, )。 |
Preview |
Example
{
"type": "microsoft.powerapps/canvasapps",
"properties": {
"displayName": "Learning Resources App",
"powerPlatformConnectors": [
{
"connectorId": "shared_sharepointonline",
"operations": [
{ "operationId": "GetItems" },
{ "operationId": "PostItem" }
]
},
{
"connectorId": "shared_office365users",
"operations": [
{ "operationId": "MyProfile_V2" }
]
}
]
}
}
注释
Copilot Studio代理发出其他每操作元数据,该元数据反映代理如何将连接器用作工具或知识源。 有关详细信息,请参阅 Microsoft Copilot Studio 代理清单架构。
已知的限制
- 表格连接器不会报告相关操作。 绑定为数据源的连接器(如 SharePoint、Dataverse、SQL Server 和 Excel Online)显示在
powerPlatformConnectors中,但发出空的operations数组。 - 内置操作不会被捕获。 来自Power Automate的内置操作(例如 HTTP 内置操作、控制操作和数据操作)不是连接器,也不会出现在中
powerPlatformConnectors。 这种差异通常会导致混淆:通过 HTTP 内置操作调用外部服务的流不显示该调用的连接器。 - 未涵盖代码应用、vibe 应用和 App Builder 应用。 只有本节中列出的资源类型才会发出连接器数据。
- 模型驱动应用很少报告连接器。 模型驱动应用很少直接调用连接器。 仅当画布页面嵌入在模型驱动应用中时,才会显示连接器数据,并且该页面的连接器使用情况会记录在画布页面记录本身中。
- 不包含连接器的显示名称或层级数据。 此版本仅公开连接器 ID 和操作 ID。 不包括显示名称、层级(Standard/Premium)和发布者信息。
画布应用
| API 字段路径 | 数据类型 | 说明 | Example | 地位 |
|---|---|---|---|---|
properties.ownerId |
字符串 | 资源所有者的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.environmentId |
字符串 | 包含资源的环境的标识符。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.lastModifiedAt |
日期/时间 | 上次修改应用的日期和时间。 | 2026-01-15T10:30:00Z |
正式发布 |
properties.lastModifiedBy |
字符串 | 上次修改应用的用户的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.isQuarantined |
布尔 | 应用是否处于隔离状态。 | false |
正式发布 |
properties.powerPlatformConnectors |
数组 | 应用使用的连接器和操作。 请参阅连接器清单(预览版)。 | 请参阅相关章节。 | Preview |
注释
该 properties.isQuarantined 字段可通过 API 提供,但尚未显示在 Power Platform 管理中心清单体验中。
模型驱动应用
| API 字段路径 | 数据类型 | 说明 | Example | 地位 |
|---|---|---|---|---|
properties.ownerId |
字符串 | 资源所有者的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.environmentId |
字符串 | 包含资源的环境的标识符。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.lastModifiedAt |
日期/时间 | 上次修改应用的日期和时间。 | 2026-01-15T10:30:00Z |
正式发布 |
properties.lastModifiedBy |
字符串 | 上次修改应用的用户的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.isQuarantined |
布尔 | 应用是否处于隔离状态。 | false |
正式发布 |
properties.appModuleId |
字符串 | Dataverse 应用模块 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.logicalName |
字符串 | 应用的 Dataverse 逻辑名称。 | contoso_expensereport |
正式发布 |
properties.powerPlatformConnectors |
数组 | 应用使用的连接器和操作。 请参阅连接器清单(预览版)。 | 请参阅相关章节。 | Preview |
注释
该 properties.isQuarantined 字段可通过 API 提供,但尚未显示在 Power Platform 管理中心清单体验中。
注释
该 properties.powerPlatformConnectors 字段很少返回模型驱动应用的数据,因为模型驱动应用不会直接使用连接器。 嵌入式画布页面使用的连接器信息会记录在画布页面记录中。
编程应用
| API 字段路径 | 数据类型 | 说明 | Example | 地位 |
|---|---|---|---|---|
properties.ownerId |
字符串 | 资源所有者的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.environmentId |
字符串 | 包含资源的环境的标识符。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.lastModifiedAt |
日期/时间 | 上次修改应用的日期和时间。 | 2026-01-15T10:30:00Z |
正式发布 |
properties.lastModifiedBy |
字符串 | 上次修改应用的用户的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.isQuarantined |
布尔 | 应用是否处于隔离状态。 | false |
正式发布 |
properties.subType |
字符串 | 代码应用的子类型: byocApp 或 vibeApp。 |
byocApp |
正式发布 |
注释
该 properties.isQuarantined 字段可通过 API 提供,但尚未显示在 Power Platform 管理中心清单体验中。
应用构建器应用程序
有关详细信息,请参阅 App Builder。
| API 字段路径 | 数据类型 | 说明 | Example | 地位 |
|---|---|---|---|---|
properties.ownerId |
字符串 | 资源所有者的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.environmentId |
字符串 | 包含资源的环境的标识符。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.lastModifiedAt |
日期/时间 | 上次修改应用的日期和时间。 | 2026-01-15T10:30:00Z |
正式发布 |
properties.lastModifiedBy |
字符串 | 上次修改应用的用户的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.isQuarantined |
布尔 | 应用是否处于隔离状态。 | false |
正式发布 |
properties.subType |
字符串 | 应用的子类型。 目前 appBuilderApp。 |
appBuilderApp |
正式发布 |
注释
该 properties.isQuarantined 字段可通过 API 提供,但尚未显示在 Power Platform 管理中心清单体验中。
云端流
| API 字段路径 | 数据类型 | 说明 | Example | 地位 |
|---|---|---|---|---|
properties.ownerId |
字符串 | 资源所有者的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.environmentId |
字符串 | 包含资源的环境的标识符。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.lastModifiedAt |
日期/时间 | 流最后一次修改的日期和时间。 | 2026-01-15T10:30:00Z |
正式发布 |
properties.lastModifiedBy |
字符串 | 上次修改流的用户的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.workflowEntityId |
字符串 | Dataverse 工作流实体 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.powerPlatformConnectors |
数组 | 流中使用的连接器和操作。 请参阅连接器清单(预览版)。 | 请参阅相关章节。 | Preview |
properties.trigger |
字符串 | 启动流的连接器。 当触发器非基于连接器时(例如,周期性或手动触发),此字段为空。 | sharepointonline |
Preview |
properties.triggerOperation |
字符串 | 启动流的操作。 | GetOnNewItems |
Preview |
代理流
| API 字段路径 | 数据类型 | 说明 | Example | 地位 |
|---|---|---|---|---|
properties.ownerId |
字符串 | 资源所有者的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.environmentId |
字符串 | 包含资源的环境的标识符。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.lastModifiedAt |
日期/时间 | 流最后一次修改的日期和时间。 | 2026-01-15T10:30:00Z |
正式发布 |
properties.lastModifiedBy |
字符串 | 上次修改流的用户的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.workflowEntityId |
字符串 | Dataverse 工作流实体 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.powerPlatformConnectors |
数组 | 流中使用的连接器和操作。 请参阅连接器清单(预览版)。 | 请参阅相关章节。 | Preview |
properties.trigger |
字符串 | 启动流的连接器。 当触发器非基于连接器时(例如,周期性或手动触发),此字段为空。 | sharepointonline |
Preview |
properties.triggerOperation |
字符串 | 启动流的操作。 | GetOnNewItems |
Preview |
工作流智能体流
| API 字段路径 | 数据类型 | 说明 | Example | 地位 |
|---|---|---|---|---|
properties.ownerId |
字符串 | 资源所有者的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.environmentId |
字符串 | 包含资源的环境的标识符。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.lastModifiedAt |
日期/时间 | 流最后一次修改的日期和时间。 | 2026-01-15T10:30:00Z |
正式发布 |
properties.lastModifiedBy |
字符串 | 上次修改流的用户的对象 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.workflowEntityId |
字符串 | Dataverse 工作流实体 ID。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.powerPlatformConnectors |
数组 | 流中使用的连接器和操作。 请参阅连接器清单(预览版)。 | 请参阅相关章节。 | Preview |
properties.trigger |
字符串 | 启动流的连接器。 当触发器非基于连接器时(例如,周期性或手动触发),此字段为空。 | sharepointonline |
Preview |
properties.triggerOperation |
字符串 | 启动流的操作。 | GetOnNewItems |
Preview |
Copilot Studio代理
Copilot Studio 代理除了共享字段之外,还有一组丰富的属性,包括核心、标识和配置属性。 有关完整架构,请参阅 Microsoft Copilot Studio 代理清单架构。
环境
有关环境的详细信息,请参阅 环境概述。
| API 字段路径 | 数据类型 | 说明 | Example | 地位 |
|---|---|---|---|---|
properties.environmentType |
字符串 | 环境类型:生产、默认、沙盒、试用、开发人员或 Dataverse for Teams。 | Production |
正式发布 |
properties.isManaged |
布尔 | 环境是否为 托管环境。 | true |
正式发布 |
properties.environmentGroup |
字符串 | 环境组的名称(如果已分配)。 | Finance |
正式发布 |
properties.environmentGroupId |
字符串 | 如果已分配,则为环境组的标识符。 | aaaa0000-bb11-2222-33cc-444444dddddd |
正式发布 |
properties.lastModifiedAt |
日期/时间 | 上次修改环境的日期和时间。 | 2026-01-15T10:30:00Z |
正式发布 |
环境组
有关详细信息,请参阅 环境组。
| API 字段路径 | 数据类型 | 说明 | Example | 地位 |
|---|---|---|---|---|
properties.description |
字符串 | 环境组的描述。 | All finance team environments |
正式发布 |
properties.lastModifiedAt |
日期/时间 | 该组最后一次修改的日期和时间。 | 2026-01-15T10:30:00Z |
正式发布 |