Informazioni di riferimento sullo schema di inventario di Power Platform

L'inventario di Power Platform espone i dati delle risorse tramite la tabella PowerPlatformResources in Azure Resource Graph. Questo articolo descrive i tipi di risorse e i campi disponibili in tale tabella in modo da poter costruire query mirate e comprendere il modello di dati dietro l'esperienza di Power Platform di inventario.

Per informazioni sull'esecuzione di query sulla tabella a livello di codice, vedere API di inventario di Power Platform. Per informazioni di riferimento complete sull'API REST, vedere la documentazione dell'API REST di Power Platform.

Tipi di risorsa

Ogni record nella PowerPlatformResources tabella ha un campo di tipo che identifica il tipo di risorsa. Nella tabella seguente sono elencati tutti i tipi supportati.

Nome visualizzato Valore type
App canvas microsoft.powerapps/canvasapps
App basate su modello microsoft.powerapps/modeldrivenapps
App di codice microsoft.powerapps/codeapps
App Generatore di app microsoft.powerapps/apps
Flussi cloud microsoft.powerautomate/cloudflows
Flussi agente microsoft.powerautomate/agentflows
Flussi dell'agente di workflow microsoft.powerautomate/m365agentflows
agenti di Copilot Studio microsoft.copilotstudio/agents
Ambienti microsoft.powerplatform/environments
Gruppi di ambienti microsoft.powerplatform/environmentgroups

Campi delle risorse condivise

Tutti i tipi di risorse nella tabella PowerPlatformResources includono i campi seguenti.

Nome dell'esperienza utente Percorso del campo API Tipo di dati Description Example Stato
Nome elemento properties.displayName stringa Nome visualizzato della risorsa. App per le note spese Generalmente disponibile
Tipo di articolo type stringa Identificatore del tipo di risorsa (vedere Tipi di risorse). microsoft.powerapps/canvasapps Generalmente disponibile
ID articolo name stringa Identificatore univoco della risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
Ubicazione location stringa Area geografica della risorsa. unitedstates Generalmente disponibile
Data di creazione properties.createdAt datetime Data e ora di creazione della risorsa. 2025-06-01T08:00:00Z Generalmente disponibile
Creato da properties.createdBy stringa ID oggetto dell'utente che ha creato la risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile

Note

Il campo tenantId è disponibile anche come campo di primo livello ARM in ogni record delle risorse.

Inventario dei connettori (anteprima)

L'inventario di Power Platform acquisisce i connettori e le operazioni del connettore usati da ogni risorsa. Questi dati vengono visualizzati come colonna Connettori nelle griglie di inventario dell'interfaccia di amministrazione di Power Platform. Pagina unificata Gestisci > Inventory e le visualizzazioni specifiche delle risorse in Copilot StudioPower Apps e Power Automate e come matrice properties.powerPlatformConnectors nelle query a livello di codice.

I tipi di risorse seguenti emettono dati del connettore: app canvas, app basate su modello, flussi cloud, flussi degli agenti, flussi degli agenti del flusso di lavoro e agenti di Copilot Studio (incluso Generatore di agenti di Microsoft 365 Copilot).

Per i flussi (flussi cloud, flussi degli agenti e flussi degli agenti del flusso di lavoro), l'inventario rileva inoltre il connettore e l'operazione che avviano il flusso come properties.trigger e properties.triggerOperation. Questi campi completano powerPlatformConnectors, che registra i connettori richiamati durante l'esecuzione del flusso.

Schema

Percorso del campo API Tipo di dati Description Stato
properties.powerPlatformConnectors array Connettori usati dalla risorsa. Preview
properties.powerPlatformConnectors[].connectorId stringa Identificatore del connettore , ad esempio shared_sharepointonline. Preview
properties.powerPlatformConnectors[].operations array Operazioni sul connettore richiamate dalla risorsa. Preview
properties.powerPlatformConnectors[].operations[].operationId stringa Identificatore dell'operazione , ad esempio GetItems. Preview

Example

{
  "type": "microsoft.powerapps/canvasapps",
  "properties": {
    "displayName": "Learning Resources App",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_sharepointonline",
        "operations": [
          { "operationId": "GetItems" },
          { "operationId": "PostItem" }
        ]
      },
      {
        "connectorId": "shared_office365users",
        "operations": [
          { "operationId": "MyProfile_V2" }
        ]
      }
    ]
  }
}

Note

Gli agenti di Copilot Studio generano metadati aggiuntivi per ogni operazione che indicano come gli agenti usano i connettori come strumenti o fonti di conoscenza. Per informazioni dettagliate, vedere schema di inventario Microsoft Copilot Studio Agent.

Limitazioni note

  • I connettori tabulari non segnalano le operazioni. I connettori associati come origini dati(ad esempio SharePoint, Dataverse, SQL Server e Excel Online) vengono visualizzati in powerPlatformConnectors ma generano una matrice di operations vuota.
  • Le app di codice, le app vibe e le app di Generatore app non sono coperte. Solo i tipi di risorse elencati in questa sezione generano dati del connettore.
  • Le app basate su modello raramente segnalano connettori. Le app basate su modello chiamano raramente direttamente i connettori. I dati del connettore vengono visualizzati solo quando una pagina canvas è incorporata in un'app basata su modello e l'utilizzo del connettore della pagina viene acquisito nel record di pagina canvas stesso.
  • Nessun connettore visualizza nomi o dati di livello. Questa versione mostra solo gli ID dei connettori e delle operazioni. I nomi visualizzati, i livelli (Standard/Premium) e le informazioni sull'editore non sono inclusi.

App canvas

Percorso del campo API Tipo di dati Description Example Stato
properties.ownerId stringa ID dell'oggetto del proprietario della risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.environmentId stringa Identificatore dell'ambiente che contiene la risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.lastModifiedAt datetime Data e ora dell'ultima modifica dell'app. 2026-01-15T10:30:00Z Generalmente disponibile
properties.lastModifiedBy stringa ID oggetto dell'utente che ha modificato l'ultima volta l'app. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.isQuarantined booleano Indica se l'app è in quarantena. false Generalmente disponibile
properties.powerPlatformConnectors array Connettori e operazioni usati dall'app. Vedere Inventario dei connettori (anteprima). Vedere la sezione . Preview

Note

Il properties.isQuarantined campo è disponibile tramite l'API, ma non è ancora visualizzato nell'esperienza di inventario dell'interfaccia di amministrazione di Power Platform.

App basate su modello

Percorso del campo API Tipo di dati Description Example Stato
properties.ownerId stringa ID dell'oggetto del proprietario della risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.environmentId stringa Identificatore dell'ambiente che contiene la risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.lastModifiedAt datetime Data e ora dell'ultima modifica dell'app. 2026-01-15T10:30:00Z Generalmente disponibile
properties.lastModifiedBy stringa ID oggetto dell'utente che ha modificato l'ultima volta l'app. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.isQuarantined booleano Indica se l'app è in quarantena. false Generalmente disponibile
properties.appModuleId stringa ID modulo dell'app Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.logicalName stringa Nome logico Dataverse dell'app. contoso_expensereport Generalmente disponibile
properties.powerPlatformConnectors array Connettori e operazioni usati dall'app. Vedere Inventario dei connettori (anteprima). Vedere la sezione . Preview

Note

Il properties.isQuarantined campo è disponibile tramite l'API, ma non è ancora visualizzato nell'esperienza di inventario dell'interfaccia di amministrazione di Power Platform.

Note

Il properties.powerPlatformConnectors campo restituisce raramente i dati per le app basate su modello, perché le app basate su modello non usano direttamente i connettori. I connettori utilizzati dalle pagine canvas incorporate vengono invece registrati nel record della pagina canvas.

App di codice

Percorso del campo API Tipo di dati Description Example Stato
properties.ownerId stringa ID dell'oggetto del proprietario della risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.environmentId stringa Identificatore dell'ambiente che contiene la risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.lastModifiedAt datetime Data e ora dell'ultima modifica dell'app. 2026-01-15T10:30:00Z Generalmente disponibile
properties.lastModifiedBy stringa ID oggetto dell'utente che ha modificato l'ultima volta l'app. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.isQuarantined booleano Indica se l'app è in quarantena. false Generalmente disponibile
properties.subType stringa Sottotipo dell'app di codice: byocApp o vibeApp. byocApp Generalmente disponibile

Note

I valori del sottotipo corrispondono rispettivamente alle app di codice e alle app vibe.

Note

Il properties.isQuarantined campo è disponibile tramite l'API, ma non è ancora visualizzato nell'esperienza di inventario dell'interfaccia di amministrazione di Power Platform.

App Generatore di app

Per altre informazioni, vedere Generatore app.

Percorso del campo API Tipo di dati Description Example Stato
properties.ownerId stringa ID dell'oggetto del proprietario della risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.environmentId stringa Identificatore dell'ambiente che contiene la risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.lastModifiedAt datetime Data e ora dell'ultima modifica dell'app. 2026-01-15T10:30:00Z Generalmente disponibile
properties.lastModifiedBy stringa ID oggetto dell'utente che ha modificato l'ultima volta l'app. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.isQuarantined booleano Indica se l'app è in quarantena. false Generalmente disponibile
properties.subType stringa Sottotipo dell'app. Attualmente appBuilderApp. appBuilderApp Generalmente disponibile

Note

Il properties.isQuarantined campo è disponibile tramite l'API, ma non è ancora visualizzato nell'esperienza di inventario dell'interfaccia di amministrazione di Power Platform.

Flussi cloud

Percorso del campo API Tipo di dati Description Example Stato
properties.ownerId stringa ID dell'oggetto del proprietario della risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.environmentId stringa Identificatore dell'ambiente che contiene la risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.lastModifiedAt datetime Data e ora dell'ultima modifica apportata al flusso. 2026-01-15T10:30:00Z Generalmente disponibile
properties.lastModifiedBy stringa ID dell'oggetto dell'utente che ha modificato per ultimo il flusso. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.workflowEntityId stringa ID dell'entità del flusso di lavoro di Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.powerPlatformConnectors array Connettori e operazioni usati dal flusso. Vedere Inventario dei connettori (anteprima). Vedere la sezione . Preview
properties.trigger stringa Connettore che avvia il flusso. È vuoto quando il trigger non è basato su un connettore (ad esempio, ricorrenza o attivazione manuale). sharepointonline Preview
properties.triggerOperation stringa Operazione che avvia il flusso. GetOnNewItems Preview

Flussi agente

Percorso del campo API Tipo di dati Description Example Stato
properties.ownerId stringa ID dell'oggetto del proprietario della risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.environmentId stringa Identificatore dell'ambiente che contiene la risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.lastModifiedAt datetime Data e ora dell'ultima modifica apportata al flusso. 2026-01-15T10:30:00Z Generalmente disponibile
properties.lastModifiedBy stringa ID dell'oggetto dell'utente che ha modificato per ultimo il flusso. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.workflowEntityId stringa ID dell'entità del flusso di lavoro di Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.powerPlatformConnectors array Connettori e operazioni usati dal flusso. Vedere Inventario dei connettori (anteprima). Vedere la sezione . Preview
properties.trigger stringa Connettore che avvia il flusso. È vuoto quando il trigger non è basato su connettore (ad esempio, ricorrenza o attivazione manuale). sharepointonline Preview
properties.triggerOperation stringa Operazione che avvia il flusso. GetOnNewItems Preview

Flussi dell'agente di workflow

Percorso del campo API Tipo di dati Description Example Stato
properties.ownerId stringa ID dell'oggetto del proprietario della risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.environmentId stringa Identificatore dell'ambiente che contiene la risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.lastModifiedAt datetime Data e ora dell'ultima modifica apportata al flusso. 2026-01-15T10:30:00Z Generalmente disponibile
properties.lastModifiedBy stringa ID dell'oggetto dell'utente che ha modificato per ultimo il flusso. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.workflowEntityId stringa ID dell'entità del flusso di lavoro di Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.powerPlatformConnectors array Connettori e operazioni usati dal flusso. Vedere Inventario dei connettori (anteprima). Vedere la sezione . Preview
properties.trigger stringa Connettore che avvia il flusso. È vuoto quando il trigger non è basato su un connettore (ad esempio, ricorrenza o attivazione manuale). sharepointonline Preview
properties.triggerOperation stringa Operazione che avvia il flusso. GetOnNewItems Preview

agenti di Copilot Studio

Gli agenti di Copilot Studio hanno un set completo di proprietà oltre i campi condivisi, tra cui le proprietà di base, identità e configurazione. Per lo schema completo, vedere schema di inventario Microsoft Copilot Studio Agent.

Ambienti

Per altre informazioni sugli ambienti, vedere Panoramica degli ambienti.

Percorso del campo API Tipo di dati Description Example Stato
properties.environmentType stringa Tipo di ambiente: Produzione, Predefinito, Sandbox, Versione di Valutazione, Sviluppatore o Dataverse per Teams. Production Generalmente disponibile
properties.isManaged booleano Indica se l'ambiente è un ambiente gestito. true Generalmente disponibile
properties.environmentGroup stringa Nome del gruppo di ambiente, se assegnato. Finance Generalmente disponibile
properties.environmentGroupId stringa Identificatore del gruppo di ambiente, se assegnato. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.lastModifiedAt datetime Data e ora dell'ultima modifica dell'ambiente. 2026-01-15T10:30:00Z Generalmente disponibile

Gruppi di ambienti

Per altre informazioni, vedere Gruppi di ambiente.

Percorso del campo API Tipo di dati Description Example Stato
properties.description stringa Descrizione del gruppo di ambiente. All finance team environments Generalmente disponibile
properties.lastModifiedAt datetime Data e ora dell'ultima modifica apportata al gruppo. 2026-01-15T10:30:00Z Generalmente disponibile