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服务(例如Azure Functions、Azure 逻辑应用或Azure 自动化)按计划查询 Power Platform 清单 API,并将结果写入Azure Blob 存储, Azure Data Lake Storage或其他受支持的目标。
支持的资源类型
Power Platform 清单 API 包含以下资源类型:
| Resource | Power Platform 清单 API 类型 |
|---|---|
| 画布应用 | 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.powerplatformconnector/connectors |
| Environments | microsoft.powerplatform/environments |
| 环境组 | microsoft.powerplatform/environmentgroups |
可用清单数据
以下部分按资源类型和数据类别介绍可用字段。
共享资源信息
以下字段可用于受支持的资源类型。 连接器是目录实体,仅支持 inventory 架构参考中标识的共享字段。
| 数据类别 | 可用信息 | Power Platform 清单 API 字段 |
|---|---|---|
| 资源标识符 (ID) | 唯一库存资源标识符 | name |
| 资源名称 | 资源显示名称 | properties.displayName |
| 资源类型 | 标准化 Power Platform 资源类型 | type |
| 租户 | 租户标识符 | 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 |
| Code-app 子类型 |
byocApp 或 vibeApp |
properties.subType |
| 托管应用子类型 | microsoftApp |
properties.subType |
| 应用生成器子类型 | 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 | 标准或高级分类 | 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 指示器不可用 |
| 高级连接器的使用情况 | 显式高级 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 不等效。
要在两个架构之间关联模型驱动应用,请同时使用 properties.environmentId 和 properties.appModuleId。
连接器库存限制
连接器清单具有以下记录的限制:
- 表格连接器可以带有空的操作数组出现。
- 内置的 Power Automate 操作(包括 HTTP、控制和数据操作)不会以连接器的形式呈现。
- 代码应用、vibe 应用、托管应用和 App Builder 应用不会发出连接器使用情况数据。
- 模型驱动应用很少直接报告连接器。
- 嵌入画布页面的连接器使用情况与画布页面记录相关联,而不是与包含它的模型驱动应用相关联。
- 每个资源连接器数据包括连接器和操作标识符,但不包括连接器显示名称、发布者信息或层。
- 连接器清单记录上提供了连接器显示名称、发布者信息和层级。
- 连接器的存在并不表示是否使用了本地网关。