Compareu l'inventari d'exportació de dades amb l'API d'inventari de Power Platform

L'API d'inventari de Power Platform proporciona dades d'inventari actuals a través de la taula d'Azure PowerPlatformResources Resource Graph. L'API inclou informació de recursos centrals, propietat, entorn i connectors, però el seu esquema difereix de l'esquema d'inventari d'exportació de dades.

Aquest article descriu:

  • Dades d'inventari disponibles a través de l'API d'inventari Power Platform.
  • Exportació de dades propietats d'inventari que no estan disponibles.
  • Propietats que tenen cobertura parcial o diferent.

Per a informació sobre com consultar inventaris, vegeu Power Platform Inventory API. Per a l'esquema complet de l'API, vegeu la referència de l'esquema d'inventari de Power Platform.

Nota

Microsoft retira la versió prèvia de l'exportació de dades. Les exportacions de dades d'inventari s'aturen després de l'1 de desembre de 2026. Les exportacions de dades d'ús i d'entorn continuen a través de configuracions existents i noves, i les dades que ja has exportat romanen al teu data lake. Espereu una altra notificació de Microsoft quan s'aturi l'exportació de dades d'inventari.

Per preparar-te, utilitza l'API d'inventari de Power Platform per exportar les dades d'inventari de manera programàtica. Abans de migrar, revisa els mapatges de camp i els buits coneguts. Alguns camps d'inventari d'exportació de dades no estan disponibles a través de l'API o tenen una cobertura diferent.

L'API d'inventari de Power Platform no exporta automàticament les dades a l'emmagatzematge propietat del client. Per crear una exportació recurrent, utilitza un servei d'Azure, com Azure Functions, Azure Logic Apps o Azure Automation, per consultar l'API d'inventari de Power Platform en un horari i escriure els resultats a Azure Blob Storage, Azure Data Lake Storage, o una altra destinació compatible.

Tipus de recursos admesos

L'API d'inventari de Power Platform inclou els següents tipus de recursos:

Recurs Tipus d'API d'inventari Power Platform
Aplicacions de llenç microsoft.powerapps/canvasapps
Aplicacions basades en models microsoft.powerapps/modeldrivenapps
Aplicacions de codi microsoft.powerapps/codeapps
Aplicacions gestionades i App Builder microsoft.powerapps/apps
Fluxos de núvol microsoft.powerautomate/cloudflows
Fluxos d'agents microsoft.powerautomate/agentflows
Fluxos d'agents de flux de treball microsoft.powerautomate/m365agentflows
Agents de Copilot Studio microsoft.copilotstudio/agents
Connectors microsoft.powerplatformconnector/connectors
Entorns microsoft.powerplatform/environments
Grups d'entorns microsoft.powerplatform/environmentgroups

Dades d'inventari disponibles

Les seccions següents descriuen els camps disponibles per tipus de recurs i categoria de dades.

Informació de recursos compartits

Els següents camps estan disponibles per a tipus de recursos suportats. Els connectors són entitats de catàleg i només admeten els camps compartits identificats a la referència de l'esquema d'inventari.

Categoria de dades Informació disponible Camp API d'inventari de Power Platform
ID del recurs Identificador únic de recursos d'inventari name
Nom del recurs Nom de visualització del recurs properties.displayName
Tipus de recurs Tipus de recurs estandarditzat de la Plataforma de Potència type
Inquilí Identificador de llogater tenantId
Ubicació Ubicació geogràfica del recurs location
Data de creació Data i hora en què es va crear el recurs properties.createdAt
Creat per ID d'objecte de l'usuari que va crear el recurs properties.createdBy

Informació de l'aplicació

La següent informació està disponible per als tipus d'aplicacions compatibles.

Categoria de dades Informació disponible Camp API d'inventari de Power Platform
Propietari ID d'objecte del propietari de l'aplicació properties.ownerId
Entorn Identificador de l'entorn que conté l'aplicació properties.environmentId
Última modificació Data i hora de l'última modificació de l'aplicació properties.lastModifiedAt
Última modificació per ID d'objecte de l'usuari que va modificar l'aplicació per última vegada properties.lastModifiedBy
Estat de quarantena Si l'aplicació està en quarantena properties.isQuarantined
ID d'aplicació guiat per models Identificador de mòdul d'aplicació Dataverse properties.appModuleId
Nom lògic d'aplicació basada en models Nom lògic de Dataverse properties.logicalName
Subtipus d'aplicació de codi byocApp o vibeApp properties.subType
Subtipus d'aplicació gestionada microsoftApp properties.subType
Subtipus App Builder appBuilderApp properties.subType

Informació de flux

La següent informació està disponible per a fluxos de núvol, fluxos d'agents i fluxos d'agents de flux de treball.

Categoria de dades Informació disponible Camp API d'inventari de Power Platform
Propietari ID d'objecte del propietari del flux properties.ownerId
Entorn Identificador de l'entorn que conté el flux properties.environmentId
Última modificació Data i hora en què es va modificar per última vegada el flux properties.lastModifiedAt
Última modificació per ID d'objecte de l'usuari que va modificar el flux per última vegada properties.lastModifiedBy
Entitat de flux de treball Identificador d'entitat de flux de treball Dataverse properties.workflowEntityId
Connector de disparador Connector que inicia el flux properties.trigger
Funcionament del disparador Operació del connector que inicia el flux properties.triggerOperation

Els camps de disparador queden buits quan un flux utilitza un disparador que no està basat en connectors, com ara un disparador de recurrència o manual.

Ús del connector

L'ús de connectors està disponible per a aplicacions, fluxos i agents compatibles.

Categoria de dades Informació disponible Camp API d'inventari de Power Platform
Connectors utilitzats Identificadors dels connectors utilitzats pel recurs properties.powerPlatformConnectors[].connectorId
Operacions utilitzades Identificadors d'operacions invocades en un connector properties.powerPlatformConnectors[].operations[].operationId
Desencadenant de flux Connector que inicia un flux suportat properties.trigger
Funcionament del disparador de flux Funcionament del connector que inicia un flux suportat properties.triggerOperation

Informació del catàleg de connectors

També pots trobar connectors com a recursos individuals d'inventari.

Categoria de dades Informació disponible Camp API d'inventari de Power Platform
Connector ID Identificador de connector properties.connectorId
Descripció Descripció del connector properties.description
Editor Editor de connectors properties.publisher
Nivell Classificació estàndard o premium properties.tier
Fase de llançament Designació de llançament, com ara Producció o Previsualització properties.releaseTag
Estat de depreció Si el connector està obsolet properties.isDeprecated
Operations Operacions exposades pel connector properties.operations
ID d'operació Identificador únic d'operació properties.operations[].operationId
Nom de l'operació Nom de pantalla de l'operació properties.operations[].displayName
Descripció de l'operació Descripció de l'operació properties.operations[].description
Mètode HTTP Mètode HTTP utilitzat per l'operació properties.operations[].method

Informació ambiental

Podeu trobar la següent informació als registres d'inventari ambiental.

Categoria de dades Informació disponible Camp API d'inventari de Power Platform
ID de l'entorn Identificador únic d'entorn name
Nom de l’entorn Nom de visualització de l'entorn properties.displayName
Ubicació Ubicació geogràfica de l'entorn location
Tipus d’entorn Producció, per defecte, sandbox, prova, desenvolupador o Dataverse per a equips properties.environmentType
Estat gestionat Si l'entorn és un entorn gestionat properties.isManaged
Grup ambiental Nom del grup d'entorn assignat properties.environmentGroup
ID de grup ambiental Identificador del grup d'entorn assignat properties.environmentGroupId
Última modificació Data i hora de l'última modificació de l'entorn properties.lastModifiedAt

Dades no disponibles

Les següents propietats d'inventari d'exportació de dades no tenen equivalents directes a l'esquema d'inventari publicat de Power Platform.

Categoria de dades Informació d'inventari d'exportació de dades no disponible a l'API d'inventari de Power Platform
Descripció de l'aplicació Descripció d'una aplicació basada en llenç o model
Enllaços d'aplicació URI d'aplicació, URI de documents, URI d'icones i URL del formulari de SharePoint
Ús compartit Nombre d'usuaris i grups amb qui es comparteix una aplicació
Estat d'eliminació Indicador explícit de recursos eliminats
Historial d'habilitació Data de l'última vegada que es va activar una aplicació i el principal responsable que l'ha activada
Informació sobre solucions i ALM Associació de solucions i mode ALM
Avaluació DLP Estat de l'avaluació, data d'avaluació, missatge de violació i infraccions per política
Configuració de l'aplicació Configuració, tipus de creació, tipus de dispositiu client, hoste d'incrustació, extensions personalitzades i configuració d'optimització de rendiment
Presentació de l'aplicació Imatge de fons, color de fons, designació de l'aplicació heroica, designació de l'aplicació destacada i classificació del pla de l'aplicació
Consentiment i llicència Configuració de consentiment per bypass i elegibilitat per a l'app pass
Versió del document Versió del document associada a l'aplicació
Ús de passarel·la local Indicador explícit que una aplicació utilitza una passarel·la de dades local
Ús de les taules Dataverse Indicador explícit que una aplicació utilitza taules Dataverse
Ús de servei extern de PCF Indicador explícit que un control del marc de components de Power Apps utilitza un servei extern

Important

properties.isQuarantined indica si una aplicació està en quarantena. No és l'equivalent de l'indicador d'eliminació d'exportació de dades.

Dades disponibles amb diferents cobertures

Alguns camps de l'API d'inventari de Power Platform proporcionen informació relacionada però no són equivalents directes de les propietats d'exportació de dades.

Categoria de dades Inventari d'exportació de dades Cobertura de l'API d'inventari de Power Platform
Tipus de recurs Separació type i subType valors Un identificador de recurs estandarditzat en type. Alguns tipus de recursos també proporcionen properties.subType
Estat i cicle de vida Estat dels recursos i estat del cicle de vida L'estat de quarantena està disponible per als tipus d'aplicacions compatibles, però no representa tots els valors d'estat o del cicle de vida
Propietari Valor del propietari i ID de l'objecte del propietari properties.ownerId proporciona un ID d'objecte quan està disponible. No s'inclou el nom de propietari
Ús personalitzat d'API Indicador d'API personalitzat explícit Hi ha identificadors de connectors disponibles per als recursos suportats, però no hi ha un indicador d'API personalitzat equivalent
Ús del connector premium Indicador explícit d'API premium El nivell connector està disponible als registres d'inventari de connectors, però no hi ha un indicador equivalent a nivell de recurs
Accions del flux de treball Accions de flux de treball i indicadors relacionats amb connectors Hi ha connectors estructurats i identificadors d'operació disponibles per als tipus de recursos compatibles
Informació ambiental Identificador d'entorn al recurs i dades d'exportació d'entorn separades El recurs inclou properties.environmentId. Els detalls de l'entorn estan disponibles a través dels registres d'inventari ambiental

Mapeig d'identificadors

Els identificadors de recursos no es representen de manera idèntica a l'exportació de dades ni a l'API d'inventari de Power Platform.

Aplicacions basades en models

Utilitza el següent mapeig per a aplicacions basades en models:

Camp d'inventari d'exportació de dades Camp API d'inventari de Power Platform
environmentId properties.environmentId
resourceId properties.appModuleId
name properties.displayName
type i subType type

El camp de nivell superior name de l'API d'inventari de Power Platform és l'identificador únic de recursos d'inventari. No és equivalent a l'exportació resourceId de dades per a aplicacions basades en models.

Per correlacionar una aplicació basada en models entre els dos esquemes, utilitza tant properties.environmentId com properties.appModuleId.

Limitacions de l'inventari dels connectors

L'inventari de connectors té les següents limitacions documentades:

  • Els connectors tabulars poden aparèixer amb una matriu d'operacions buida.
  • Les accions integrades de Power Automate, incloent-hi HTTP, Control i les operacions de dades, no es representen com a connectors.
  • Les aplicacions de codi, les aplicacions de vibració, les aplicacions gestionades i les aplicacions App Builder no emeten dades d'ús del connector.
  • Les aplicacions basades en models rarament informen directament dels connectors.
  • L'ús del connector per part d'una pàgina de canvas incrustada s'associa amb el registre de pàgina de canvas en lloc de l'aplicació basada en models que conté.
  • Les dades del connector per recurs inclouen identificadors de connectors i operacions, però no inclouen noms de visualització del connector, informació de l'editor ni nivell.
  • Els noms de visualització dels connectors, la informació de l'editor i els nivells estan disponibles als registres d'inventari dels connectors.
  • La presència del connector no indica si s'utilitza una passarel·la local.

Contingut relacionat

  • Darrera actualització el