Confrontare l'inventario dell'esportazione dei dati con l'API di inventario di Power Platform

L'API di inventario di Power Platform fornisce i dati di inventario correnti tramite la PowerPlatformResources tabella in Azure Resource Graph. L'API comprende informazioni di base su risorse, proprietà, ambiente e connettore, ma il relativo schema è diverso dallo schema di inventario dell'esportazione dati.

Questo articolo descrive:

  • Dati di inventario disponibili tramite l'API di inventario di Power Platform.
  • Le proprietà dell'inventario di esportazione dati che non sono disponibili.
  • Proprietà con copertura parziale o diversa.

Per informazioni sull'esecuzione di query sull'inventario, vedere API di inventario di Power Platform. Per lo schema API completo, vedere riferimento allo schema di inventario di Power Platform.

Note

Microsoft ritira la versione di anteprima dell'esportazione dei dati. Le esportazioni dei dati di inventario si arrestano a partire dal 1° dicembre 2026. Le esportazioni dati di utilizzo e ambiente continuano con configurazioni esistenti e nuove e i dati già esportati rimangono nel data lake. Aspettatevi un'altra notifica da Microsoft quando le esportazioni dei dati di inventario si arrestano.

Per prepararsi, usare l'API di inventario di Power Platform per esportare programmaticamente i dati di inventario. Prima di eseguire la migrazione, esaminare i mapping dei campi e le lacune note. Alcuni campi di inventario dell'esportazione dei dati non sono disponibili tramite l'API o hanno una copertura diversa.

L'API di inventario di Power Platform non esporta automaticamente i dati nella risorsa di archiviazione di proprietà del cliente. Per creare un'esportazione ricorrente, usare un servizio di Azure, ad esempio Funzioni di Azure, App per la logica di Azure o Automazione di Azure, per eseguire una query sull'API di inventario di Power Platform in base a una pianificazione e scrivere i risultati in Archiviazione BLOB di Azure, Azure Data Lake Storage o un'altra destinazione supportata.

Tipi di risorse supportati

L'API di inventario di Power Platform include i tipi di risorse seguenti:

risorsa Tipo di API di inventario di Power Platform
App canvas microsoft.powerapps/canvasapps
App basate su modello microsoft.powerapps/modeldrivenapps
App di codice microsoft.powerapps/codeapps
App gestite e generatore di app microsoft.powerapps/apps
Flussi cloud microsoft.powerautomate/cloudflows
Flussi dell'agente microsoft.powerautomate/agentflows
Flussi dell'agente di workflow microsoft.powerautomate/m365agentflows
agenti di Copilot Studio microsoft.copilotstudio/agents
Connectors microsoft.powerplatformconnector/connectors
Environments microsoft.powerplatform/environments
Gruppi di ambienti microsoft.powerplatform/environmentgroups

Dati di inventario disponibili

Le sezioni seguenti descrivono i campi disponibili per tipo di risorsa e categoria di dati.

Informazioni sulle risorse condivise

Per i tipi di risorse supportati sono disponibili i campi seguenti. I connettori sono entità di catalogo e supportano solo i campi condivisi identificati nel riferimento allo schema di inventario.

Categoria di dati Informazioni disponibili Campo API di inventario Power Platform
ID risorsa Identificatore univoco della risorsa di inventario name
Nome risorsa Nome visualizzato della risorsa properties.displayName
Tipo di risorsa Tipo di risorsa Power Platform standardizzato type
Tenant Identificatore del tenant tenantId
Location Posizione geografica della risorsa location
Data di creazione Data e ora di creazione della risorsa properties.createdAt
Creato da ID oggetto dell'utente che ha creato la risorsa properties.createdBy

Informazioni sull'app

Le informazioni seguenti sono disponibili per i tipi di app supportati.

Categoria di dati Informazioni disponibili Campo API di inventario Power Platform
Proprietario ID oggetto del proprietario dell'app properties.ownerId
Environment Identificatore dell'ambiente contenente l'app properties.environmentId
Ultima modifica Data e ora dell'ultima modifica dell'app properties.lastModifiedAt
Autore ultima modifica ID oggetto dell'utente che ha modificato l'ultima volta l'app properties.lastModifiedBy
Stato di quarantena Se l'app è in quarantena properties.isQuarantined
ID app basata su modello Identificatore del modulo app di Dataverse properties.appModuleId
Nome logico dell'app basata su modello Nome logico Dataverse properties.logicalName
Tipo secondario app di codice byocApp oppure vibeApp properties.subType
Sottotipo dell'app gestita microsoftApp properties.subType
Sottotipo App Builder appBuilderApp properties.subType

Informazioni sul flusso

Le informazioni seguenti sono disponibili per flussi cloud, flussi agente e flussi agente del flusso di lavoro.

Categoria di dati Informazioni disponibili Campo API di inventario Power Platform
Proprietario ID oggetto del proprietario del flusso properties.ownerId
Environment Identificatore dell'ambiente contenente il flusso properties.environmentId
Ultima modifica Data e ora dell'ultima modifica del flusso properties.lastModifiedAt
Autore ultima modifica ID oggetto dell'utente che ha modificato per ultimo il flusso properties.lastModifiedBy
Entità del flusso di lavoro Identificatore dell'entità del flusso di lavoro Dataverse properties.workflowEntityId
Connettore trigger Connettore che avvia il flusso properties.trigger
Operazione del trigger Operazione del connettore che avvia il flusso properties.triggerOperation

I campi del trigger sono vuoti quando un flusso usa un trigger che non è basato sul connettore, ad esempio una ricorrenza o un trigger manuale.

Utilizzo dei connettori

L'utilizzo del connettore è disponibile per app, flussi e agenti supportati.

Categoria di dati Informazioni disponibili Campo API di inventario Power Platform
Connettori usati Identificatori dei connettori usati dalla risorsa properties.powerPlatformConnectors[].connectorId
Operazioni utilizzate Identificatori delle operazioni richiamate su un connettore properties.powerPlatformConnectors[].operations[].operationId
Trigger di flusso Connettore che avvia un flusso supportato properties.trigger
Operazione del trigger di flusso Operazione del connettore che avvia un flusso supportato properties.triggerOperation

Informazioni sul catalogo dei connettori

È anche possibile trovare i connettori come singole risorse di inventario.

Categoria di dati Informazioni disponibili Campo API di inventario Power Platform
L'ID del connettore Identificatore del connettore properties.connectorId
Descrizione Descrizione del connettore properties.description
Editore Editore connettore properties.publisher
Tier Classificazione Standard o Premium properties.tier
Fase di rilascio Designazione del rilascio, ad esempio Produzione o Anteprima properties.releaseTag
Stato di deprecazione Se il connettore è deprecato properties.isDeprecated
Operations Operazioni esposte dal connettore properties.operations
ID dell'operazione Identificatore univoco dell'operazione properties.operations[].operationId
Nome dell'operazione Nome visualizzato dell'operazione properties.operations[].displayName
Descrizione dell'operazione Descrizione dell'operazione properties.operations[].description
Metodo HTTP Metodo HTTP usato dall'operazione properties.operations[].method

Informazioni ambientali

È possibile trovare le informazioni seguenti sui record di inventario dell'ambiente.

Categoria di dati Informazioni disponibili Campo API di inventario Power Platform
ID dell'ambiente Identificatore univoco dell'ambiente name
Nome dell'ambiente Nome visualizzato dell'ambiente properties.displayName
Location Posizione geografica dell'ambiente location
Tipo di ambiente Produzione, predefinito, sandbox, versione di valutazione, sviluppatore o Dataverse per Teams properties.environmentType
Stato gestito Se l'ambiente è un ambiente gestito properties.isManaged
Gruppo di ambiente Nome del gruppo di ambiente assegnato properties.environmentGroup
ID del gruppo di ambiente Identificatore del gruppo di ambiente assegnato properties.environmentGroupId
Ultima modifica Data e ora dell'ultima modifica dell'ambiente properties.lastModifiedAt

Dati non disponibili

Le proprietà di inventario di esportazione dei dati seguenti non hanno equivalenti diretti nello schema dell'API di inventario di Power Platform pubblicato.

Categoria di dati Informazioni di inventario per l'esportazione dei dati non disponibili nell'API di inventario di Power Platform
Descrizione dell'app Descrizione di un'app canvas o basata su modello
Collegamenti dell'applicazione URI dell'app, URI documento, URI icona e URL modulo SharePoint
Condivisione Numero di utenti e gruppi con cui un'app è condivisa
Stato di eliminazione Indicatore esplicito delle risorse eliminate
Cronologia dell'abilitazione Data dell'ultima abilitazione di un'app e dell'identità che l'ha abilitata
Informazioni su soluzioni e ALM Associazione soluzione e modalità ALM
Valutazione DLP Stato di valutazione, data di valutazione, messaggio di violazione e violazioni in base ai criteri di policy
Configurazione dell'app Impostazioni, tipo di creazione, tipo di dispositivo client, host di incorporamento, estensioni personalizzate e impostazione di ottimizzazione delle prestazioni
Presentazione dell'app Immagine di sfondo, colore di sfondo, designazione hero-app, designazione featured-app e classificazione del piano app
Consenso e licenze Impostazione bypass del consenso e idoneità per pass di app
Versione del documento Versione del documento associata all'app
Utilizzo del gateway locale Indicatore esplicito che un'app usa un gateway dati on-premises
Utilizzo delle tabelle di Dataverse Indicatore esplicito che un'app usa tabelle Dataverse
Utilizzo di external-service PCF Indicatore esplicito che un controllo framework del componente Power Apps usa un servizio esterno

Importante

properties.isQuarantined indica se un'app è in quarantena. Non è un equivalente dell'indicatore di eliminazione dell'esportazione dei dati.

Dati disponibili con copertura diversa

Alcuni campi dell'API di inventario di Power Platform forniscono informazioni correlate, ma non sono equivalenti diretti delle proprietà di esportazione dei dati.

Categoria di dati Inventario di esportazione dati Copertura API inventario Power Platform
Tipo di risorsa Valori subType e type separati Un identificatore di risorsa standardizzato in type. Alcuni tipi di risorse forniscono anche properties.subType
Stato e ciclo di vita Stato della risorsa e stato del ciclo di vita Lo stato di quarantena è disponibile per i tipi di app supportati, ma non rappresenta tutti i valori di stato o ciclo di vita
Proprietario Valore proprietario e ID oggetto proprietario properties.ownerId fornisce un ID oggetto, se disponibile. Il nome visualizzato di un proprietario non è incluso
Utilizzo dell'API personalizzata Indicatore esplicito dell'API personalizzata Gli identificatori del connettore sono disponibili per le risorse supportate, ma non è disponibile un indicatore API personalizzato equivalente
Utilizzo del connettore Premium Indicatore esplicito dell'API Premium Il livello connettore è disponibile nei record di inventario del connettore, ma non è disponibile un indicatore equivalente a livello di risorsa
Azioni flusso di lavoro Azioni del flusso di lavoro e indicatori correlati al connettore I connettori strutturati e gli identificatori delle operazioni sono disponibili per i tipi di risorse supportati
Informazioni ambientali Identificatore dell'ambiente sulla risorsa e dati di esportazione dell'ambiente separati La risorsa include properties.environmentId. I dettagli dell'ambiente sono disponibili tramite i record di inventario dell'ambiente

Mappatura degli identificatori

Gli identificatori di risorsa non sono rappresentati in modo identico nell'esportazione dei dati e nell'API di inventario di Power Platform.

App basate su modello

Usare il mapping seguente per le app basate su modello:

Campo inventario esportazione dati Campo API di inventario Power Platform
environmentId properties.environmentId
resourceId properties.appModuleId
name properties.displayName
type e subType type

Il campo principale name dell'API di inventario di Power Platform è l'identificatore univoco della risorsa di inventario. Non equivale all'esportazione resourceId dei dati per le app basate su modello.

Per correlare un'app basata su modello tra i due schemi, usare sia properties.environmentId che properties.appModuleId.

Limitazioni dell'inventario dei connettori

L'inventario dei connettori presenta le limitazioni documentate seguenti:

  • I connettori tabulari possono comparire con una matrice di operazioni vuota.
  • Le azioni predefinite di Power Automate, incluse le operazioni HTTP, Controllo e Dati, non sono rappresentate come connettori.
  • Le app di codice, le app vibe, le app gestite e le app di Generatore di app non generano dati di utilizzo del connettore.
  • Le app basate su modello raramente restituiscono direttamente i connettori.
  • L'utilizzo del connettore da parte di una pagina canvas incorporata è associato al record di pagina canvas anziché all'app basata su modello contenitore.
  • I dati del connettore per risorsa includono identificatori di connettore e operazioni, ma non includono nomi visualizzati del connettore, informazioni sull'editore o tier.
  • I nomi visualizzati del connettore, le informazioni sull'editore e il livello sono disponibili nei record di inventario dei connettori.
  • La presenza del connettore non indica se viene usato un gateway locale.