将数据导出清单与 Power Platform 清单 API 进行比较

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 应用不会发出连接器使用情况数据。
  • 模型驱动应用很少直接报告连接器。
  • 嵌入画布页面的连接器使用情况与画布页面记录相关联,而不是与包含它的模型驱动应用相关联。
  • 每个资源连接器数据包括连接器和操作标识符,但不包括连接器显示名称、发布者信息或层。
  • 连接器清单记录上提供了连接器显示名称、发布者信息和层级。
  • 连接器的存在并不表示是否使用了本地网关。