Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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
- Informazioni sull'app
- Informazioni sul flusso
- Utilizzo del connettore
- Informazioni sul catalogo dei connettori
- Informazioni sull'ambiente
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.