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
Connectors microsoft.powerplatformconnector/connectors
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 rappresenta i connettori in due modi correlati:

  • Connettori usati dalle risorse: connettori e operazioni usati da ogni app, flusso o agente, acquisiti come properties.powerPlatformConnectors matrice. Questi dati vengono visualizzati anche come colonna Connettori nelle griglie di inventario dell'interfaccia di amministrazione di Power Platform: la pagina unificata Gestisci> e le visualizzazioni specifiche delle risorse in Copilot Studio, Power Apps e Power Automate.
  • I connettori come tipo di risorsa: ogni connettore disponibile nel tenant ha anche un proprio record di inventario, nel tipo di risorsa microsoft.powerplatformconnector/connectors. Per i relativi campi, vedere Connettori come tipo di risorsa.

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.

Connettori come tipo di risorsa

L'inventario di Power Platform non solo acquisisce l'utilizzo del connettore su singole risorse, ma include anche i connettori come tipo di risorsa, microsoft.powerplatformconnector/connectors. Ogni record rappresenta un connettore disponibile nel tenant ed elenca le operazioni che espone, insieme ai metadati del pubblicatore e del livello.

Note

I connettori sono entità di catalogo anziché risorse create in un ambiente, quindi rappresentano un'eccezione ai campi delle risorse condivise. I campi Creato in, Creato da e Posizione e informazioni sul proprietario e sull'ambiente non si applicano ai connettori. Si applicano solo Nome elemento (properties.displayName), Tipo di elemento (type) e ID elemento (name).

Percorso del campo API Tipo di dati Description Example Stato
properties.connectorId stringa Identificatore del connettore. shared_sharepointonline Preview
properties.description stringa Descrizione del connettore. SharePoint helps organizations share and collaborate with colleagues, partners, and customers. Preview
properties.publisher stringa L'editore del connettore. Microsoft Preview
properties.tier stringa Livello di licenza del connettore, ad esempio Standard o Premium. Standard Preview
properties.releaseTag stringa Fase di rilascio del connettore, ad esempio Production o Preview. Production Preview
properties.isDeprecated booleano Indica se il connettore è deprecato. false Preview
properties.operations array Le operazioni esposte dal connettore. Vedere le righe seguenti. Preview
properties.operations[].operationId stringa Identificatore dell'operazione. GetItems Preview
properties.operations[].displayName stringa Nome visualizzato dell'operazione. Get items Preview
properties.operations[].description stringa Una descrizione dell'operazione. Gets items from a SharePoint list. Preview
properties.operations[].method stringa Metodo HTTP dell'operazione. GET Preview

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 azioni predefinite non vengono registrate. Le azioni predefinite di Power Automate, ad esempio l'azione predefinita HTTP, le azioni di controllo e le operazioni sui dati, non sono connettori e non vengono visualizzati in powerPlatformConnectors. Questa differenza causa spesso confusione: un flusso che chiama un servizio esterno tramite l'azione predefinita HTTP non mostra alcun connettore per tale chiamata.
  • 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

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.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.

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

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 connettore, ad esempio ricorrenza o 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 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 connettore, ad esempio ricorrenza o manuale. sharepointonline Preview
properties.triggerOperation stringa Operazione che avvia il flusso. GetOnNewItems Preview

agenti di Copilot Studio

Gli agenti di Copilot Studio hanno un'ampia gamma di proprietà oltre ai campi condivisi. 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