Comparar inventário da exportação de dados com a API de inventário do Power Platform

A API de inventário da Power Platform fornece dados de inventário atuais através da tabela PowerPlatformResources no Azure Resource Graph. A interface API inclui informação de recurso principal, propriedade, ambiente e conector, mas o seu esquema difere do esquema de inventário de exportação de dados.

Este artigo descreve:

  • Dados de inventário disponíveis através da API de inventário da Power Platform.
  • Exportação de dados das propriedades do inventário que não estão disponíveis.
  • Propriedades que têm cobertura parcial ou diferente.

Para informações sobre como consultar inventário, consulte a API de inventário do Power Platform. Para o esquema completo da API, consulte a referência do esquema de inventário do Power Platform.

Note

A Microsoft está a retirar a versão de pré-visualização da exportação de dados. As exportações de dados de inventário param após 1 de dezembro de 2026. As exportações de dados de utilização e ambiente continuam através de configurações existentes e novas, e os dados que já exportou permanecem no seu data lake. Espere outra notificação da Microsoft quando as exportações de dados de inventário pararem.

Para preparar, utilize a API de inventário do Power Platform para exportar os dados de inventário de forma programática. Antes de migrar, revê os mapeamentos de campo e as lacunas conhecidas. Alguns campos de inventário de exportação de dados não estão disponíveis através da API ou têm cobertura diferente.

A API de inventário da Power Platform não exporta automaticamente dados para armazenamento pertencente ao cliente. Para criar uma exportação recorrente, utilize um serviço Azure, como Funções do Azure, Azure Logic Apps ou Automatização do Azure, para consultar a API de inventário do Power Platform de forma agendada e escrever os resultados no Armazenamento de Blobs do Azure, Azure Data Lake Storage, ou outro destino suportado.

Tipos de recursos suportados

A API de inventário do Power Platform inclui os seguintes tipos de recursos:

Resource Tipo de API de inventário Power Platform
Aplicações Canvas microsoft.powerapps/canvasapps
Aplicativos orientados por modelo microsoft.powerapps/modeldrivenapps
Aplicativos de código microsoft.powerapps/codeapps
Aplicações geridas e aplicações App Builder microsoft.powerapps/apps
Fluxos de Nuvem microsoft.powerautomate/cloudflows
Fluxos de agentes microsoft.powerautomate/agentflows
Fluxos de agentes de fluxo de trabalho microsoft.powerautomate/m365agentflows
Agentes da Copilot Studio microsoft.copilotstudio/agents
Connectors microsoft.powerplatformconnector/connectors
Environments microsoft.powerplatform/environments
Grupos de ambientes microsoft.powerplatform/environmentgroups

Dados de inventário disponíveis

As secções seguintes descrevem os campos disponíveis por tipo de recurso e categoria de dados.

Informação sobre recurso partilhado

Os seguintes campos estão disponíveis para tipos de recursos suportados. Os conectores são entidades de catálogo e suportam apenas os campos partilhados identificados na referência do esquema de inventário.

Categoria de dados Informação disponível Campo API de inventário Power Platform
ID do recurso Identificador único do recurso de inventário name
Nome do recurso Nome de exibição do recurso properties.displayName
Tipo de recurso Tipo de recurso do Power Platform padronizado type
Tenant Identificador do inquilino tenantId
Location Localização geográfica do recurso location
Data de criação Data e hora em que o recurso foi criado properties.createdAt
Criado por ID de objeto do utilizador que criou o recurso properties.createdBy

Informações da aplicação

A seguinte informação está disponível para os tipos de aplicações suportados.

Categoria de dados Informação disponível Campo API de inventário Power Platform
Proprietário ID de objeto do proprietário da aplicação properties.ownerId
Environment Identificador do ambiente que contém a aplicação properties.environmentId
Última modificação Data e hora em que a aplicação foi modificada pela última vez properties.lastModifiedAt
Última modificação efetuada por ID de objeto do utilizador que modificou a aplicação pela última vez properties.lastModifiedBy
Estado de quarentena Se a aplicação está em quarentena properties.isQuarantined
ID da aplicação condicionada por modelo Identificador de módulo de aplicação Dataverse properties.appModuleId
Nome lógico de aplicação condicionada por modelo Nome lógico do Dataverse properties.logicalName
Subtipo de aplicação de código byocApp ou vibeApp properties.subType
Subtipo de aplicação gerida microsoftApp properties.subType
Subtipo App Builder appBuilderApp properties.subType

Informação de fluxo

A informação seguinte está disponível para fluxos cloud, fluxos de agentes e fluxos de agentes de workflow.

Categoria de dados Informação disponível Campo API de inventário Power Platform
Proprietário ID de objeto do proprietário do fluxo properties.ownerId
Environment Identificador do ambiente que contém o fluxo properties.environmentId
Última modificação Data e hora em que o fluxo foi modificado pela última vez properties.lastModifiedAt
Última modificação efetuada por ID de objeto do utilizador que modificou o fluxo pela última vez properties.lastModifiedBy
Entidade de fluxo de trabalho Identificador de entidade do fluxo de trabalho Dataverse properties.workflowEntityId
Conetor de acionador Conector que inicia o fluxo properties.trigger
Operação do gatilho Operação do conector que inicia o fluxo properties.triggerOperation

Os campos de gatilho ficam vazios quando um fluxo usa um gatilho que não é baseado em conectores, como um gatilho de recorrência ou manual.

Uso do conector

A utilização de conectores está disponível para aplicações, fluxos e agentes suportados.

Categoria de dados Informação disponível Campo API de inventário Power Platform
Conectores usados Identificadores dos conectores usados pelo recurso properties.powerPlatformConnectors[].connectorId
Operações utilizadas Identificadores de operações invocadas num conector properties.powerPlatformConnectors[].operations[].operationId
Gatilho de fluxo Conetor que inicia um fluxo compatível properties.trigger
Operação do acionador de fluxo Operação do conector que inicia um fluxo suportado properties.triggerOperation

Os campos de utilização do conector e da operação estão atualmente em pré-visualização.

Informação do catálogo de conectores

Também podes encontrar conectores como recursos de inventário individuais.

Categoria de dados Informação disponível Campo API de inventário Power Platform
ID de Conector Identificador do conector properties.connectorId
Descrição Descrição do conector properties.description
Publisher Publicador de conectores properties.publisher
Tier Classificação Standard ou Premium properties.tier
Fase de lançamento Designação de lançamento, como Produção ou Pré-visualização properties.releaseTag
Estado de descontinuação Se o conector está obsoleto properties.isDeprecated
Operations Operações expostas pelo conector properties.operations
ID da operação Identificador único de operação properties.operations[].operationId
Nome da operação Nome de exibição da operação properties.operations[].displayName
Descrição da operação Descrição da operação properties.operations[].description
método HTTP Método HTTP utilizado pela operação properties.operations[].method

Informação sobre o ambiente

Pode encontrar a seguinte informação nos registos de inventário de ambientes.

Categoria de dados Informação disponível Campo API de inventário Power Platform
ID do Ambiente Identificador único do ambiente name
Nome do ambiente Nome de exibição do ambiente properties.displayName
Location Localização geográfica do ambiente location
Tipo de ambiente Produção, Predefinido, Sandbox, Avaliação, Desenvolvedor ou Dataverse para Equipas properties.environmentType
Estado gerido pelo sistema Se o ambiente é um ambiente gerido properties.isManaged
Grupo de ambientes Nome do grupo de ambiente atribuído properties.environmentGroup
ID do grupo de ambiente Identificador do grupo de ambiente atribuído properties.environmentGroupId
Última alteração Data e hora em que o ambiente foi modificado pela última vez properties.lastModifiedAt

Dados não disponíveis

As seguintes propriedades de inventário de exportação de dados não têm equivalentes diretos no esquema publicado da API de inventário do Power Platform.

Categoria de dados Informação de inventário para exportação de dados não disponível na API de inventário do Power Platform
Descrição do aplicativo Descrição de uma aplicação de estrutura livre ou orientada por modelos
Ligações de aplicação URI da aplicação, URI do documento, URI de ícone e URL do formulário do SharePoint
Partilhar Número de utilizadores e grupos com quem uma aplicação é partilhada
Estado de exclusão Indicador explícito de recurso eliminado
Histórico de ativação Data em que uma aplicação foi ativada pela última vez e o principal que a ativou
Informação sobre soluções e ALM Associação de solução e modo ALM
Avaliação DLP Estado da avaliação, data da avaliação, mensagem de violação e violações por política
Configuração do aplicativo Definições, tipo de criação, tipo de dispositivo cliente, host de embedding, extensões personalizadas e definição de otimização de desempenho
Apresentação da aplicação Imagem de fundo, cor de fundo, designação da app hero, designação da aplicação em destaque e classificação do plano da aplicação
Consentimento e licenças Definição de bypass-consent e elegibilidade para app-pass
Versão do documento Versão do documento associada à aplicação
Utilização de gateway no local Indicador explícito de que uma aplicação utiliza um gateway de dados no local
Utilização da tabela Dataverse Indicador explícito de que uma aplicação utiliza tabelas Dataverse
Utilização do serviço externo do PCF Indicador explícito de que o controlo de um framework de componentes do Power Apps utiliza um serviço externo

Importante

properties.isQuarantined indica se uma aplicação está em quarentena. Não é o equivalente ao indicador de eliminação de exportação de dados.

Dados disponíveis com diferentes coberturas

Alguns campos da API de inventário do Power Platform fornecem informação relacionada, mas não são equivalentes diretos das propriedades de exportação de dados.

Categoria de dados Inventário de exportação de dados Cobertura da API de inventário Power Platform
Tipo de recurso Separar valores de type e subType Um identificador de recurso padronizado em type. Alguns tipos de recursos também fornecem properties.subType
Estado e ciclo de vida Estado dos recursos e estado do ciclo de vida O estado de quarentena está disponível para tipos de aplicações suportados, mas não representa todos os valores de estado ou ciclo de vida
Proprietário Valor do proprietário e ID do objeto do proprietário properties.ownerId fornece um ID de objeto quando disponível. O nome de exibição do proprietário não está incluído
Utilização personalizada da API Indicador explícito de API personalizada Identificadores de conector estão disponíveis para recursos suportados, mas não existe um indicador de API personalizado equivalente
Utilização de conetores premium Indicador explícito de API premium O nível do conector está disponível nos registos de inventário dos conectores, mas não existe um indicador equivalente ao nível de recursos
Ações do fluxo de trabalho Ações de fluxo de trabalho e indicadores relacionados com conectores Conectores estruturados e identificadores de operação estão disponíveis para tipos de recursos suportados
Informação sobre o ambiente Identificador de ambiente no recurso e dados de exportação de ambiente separados O recurso inclui properties.environmentId. Os detalhes do ambiente estão disponíveis através dos registos de inventário do ambiente

Mapeamento de identificadores

Os identificadores de recursos não são representados de forma idêntica na exportação de dados e na API de inventário do Power Platform.

Aplicativos orientados por modelo

Utilize o seguinte mapeamento para aplicações orientadas por modelos:

Campo de inventário de exportação de dados Campo API de inventário Power Platform
environmentId properties.environmentId
resourceId properties.appModuleId
name properties.displayName
type e subType type

O campo de topo name da API de inventário da Power Platform é o identificador único do recurso de inventário. Não é equivalente à exportação resourceId de dados para aplicações orientadas a modelos.

Para correlacionar uma aplicação orientada a modelos entre os dois esquemas, use tanto properties.environmentId como properties.appModuleId.

Limitações de inventário dos conetores

O inventário de conectores apresenta as seguintes limitações documentadas:

  • Conectores tabulares podem aparecer com um array de operações vazio.
  • As ações integradas do Power Automate, incluindo operações HTTP, Controlo e Dados, não são representadas como conectores.
  • As aplicações de código, as vibe apps, as aplicações geridas e as apps do App Builder não emitem dados de utilização do conector.
  • Aplicações orientadas por modelos raramente indicam conectores diretamente.
  • O uso do conector por uma página de tela incorporada está associado ao registo da página de tela em vez da aplicação orientada por modelos que a contém.
  • Os dados do conector por recurso incluem identificadores do conector e da operação, mas não incluem nomes de exibição dos conectores, informações do editor ou nível.
  • Nomes de exibição dos conectores, informações do publicador e nível estão disponíveis nos registos de inventário dos conectores.
  • A presença do conector não indica se é utilizado um gateway local.

Conteúdo relacionado

  • Última atualização a