Referència de l'esquema d'inventari de Power Platform

L'inventari de Power Platform exposa les dades de recursos a través de la taula PowerPlatformResources a Azure Resource Graph. Aquest article descriu els tipus de recursos i camps disponibles en aquesta taula perquè puguis construir consultes dirigides i entendre el model de dades darrere de l'experiència d'inventari de Power Platform .

Per a informació sobre com consultar la taula de manera programàtica, vegeu Power Platform Inventory API. Per a la referència completa de l'API REST, consulteu la documentació de l'API REST de Power Platform.

Tipus de recursos

Cada registre de la PowerPlatformResources taula té un camp de tipus que identifica el tipus de recurs. La taula següent llista tots els tipus compatibles.

Nom de visualització type Valor
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
Llocs de Power Pages (vista prèvia) microsoft.powerpages/sites
Connectors microsoft.powerplatformconnector/connectors
Entorns microsoft.powerplatform/environments
Grups d'entorns microsoft.powerplatform/environmentgroups

Camps de recursos compartits

Tots els tipus de recursos a la taula PowerPlatformResources inclouen els següents camps.

Nom d'experiència d'usuari Camí de camp API Tipus de dades Descripció Exemple Estat
Nom d'element properties.displayName cadena El nom de visualització del recurs. Aplicació d'Informes de Despeses Disponible de manera general
Tipus d'element type cadena L'identificador de tipus de recurs ( vegeu Tipus de recurs). microsoft.powerapps/canvasapps Disponible de manera general
Identificador de l'element name cadena L'identificador únic del recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
Ubicació location cadena La regió geogràfica del recurs. unitedstates Disponible de manera general
Data de creació properties.createdAt datetime La data i hora en què es va crear el recurs. 2025-06-01T08:00:00Z Disponible de manera general
Creat per properties.createdBy cadena L'ID de l'objecte de l'usuari que va crear el recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general

Nota

El tenantId camp també està disponible com a camp ARM de nivell superior en cada registre de recursos.

Inventari de connectors

L'inventari de Power Platform representa els connectors de dues maneres relacionades:

  • Connectors utilitzats pels recursos: els connectors i operacions que utilitza cada aplicació, flux o agent, capturats com a properties.powerPlatformConnectors matriu. Aquestes dades també apareixen com a columna Connectors a les graelles d'inventari del centre d'administració de Power Platform: la pàgina unificada de Gestió>de l'inventari i les vistes específiques de recursos sota Copilot Studio, Power Apps i Power Automate.
  • Connectors com a tipus de recurs: cada connector disponible al teu tenant també és el seu propi registre d'inventari, sota el microsoft.powerplatformconnector/connectors tipus de recurs. Per als seus camps, vegeu Connectors com a tipus de recurs.

Els següents tipus de recursos emeten dades de connectors: aplicacions de canvas, aplicacions basades en models, aplicacions integrades en temps d'execució gestionat per Copilot, fluxos al núvol, fluxos d'agents, fluxos d'agents de flux de treball, agents de Copilot Studio en l'arnès Standard o Microsoft Copilot, i agents creats en Microsoft 365 Copilot Agent Builder.

Per als fluxos (fluxos al núvol, fluxos d'agents i fluxos d'agents de flux de treball), l'inventari captura addicionalment el connector i l'operació que inicien el flux com properties.trigger i properties.triggerOperation. Aquests camps complementen powerPlatformConnectors, que captura els connectors invocats durant l'execució del flux.

Esquema

Camí de camp API Tipus de dades Descripció Estat
properties.powerPlatformConnectors matriu Els connectors utilitzats pel recurs. Disponible de manera general
properties.powerPlatformConnectors[].connectorId cadena L'identificador del connector (per exemple, shared_sharepointonline). Disponible de manera general
properties.powerPlatformConnectors[].operations matriu Les operacions al connector que el recurs invoca. Disponible de manera general
properties.powerPlatformConnectors[].operations[].operationId cadena L'identificador de l'operació (per exemple, GetItems). Disponible de manera general

Exemple

{
  "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" }
        ]
      }
    ]
  }
}

Nota

Els agents de Copilot Studio emeten metadades addicionals per operació que reflecteixen com els agents utilitzen connectors com a eines o fonts de coneixement. Per a més detalls, vegeu Microsoft Copilot Studio Esquema d'inventari de l'agent.

Connectors com a tipus de recurs

L'inventari de Power Platform no només captura l'ús de connectors en recursos individuals, sinó que també inclou connectors com a tipus de recurs. microsoft.powerplatformconnector/connectors Cada registre representa un connector disponible al teu llogater i llista les operacions que exposa, juntament amb les metadades de l'editor i del nivell.

Nota

Els connectors són entitats de catàleg més que recursos creats en un entorn, així que són una excepció als camps de recursos compartits. Els camps Creat sobre, Creat per i Ubicació , així com la informació de propietari i entorn, no s'apliquen als connectors. Només s'apliquen el nom de l'element (properties.displayName), el tipus d'element (type) i l'ID de l'article (name).

Camí de camp API Tipus de dades Descripció Exemple Estat
properties.connectorId cadena L'identificador del connector. shared_sharepointonline Disponible de manera general
properties.description cadena Una descripció del connector. SharePoint helps organizations share and collaborate with colleagues, partners, and customers. Disponible de manera general
properties.publisher cadena L'editor del connector. Microsoft Disponible de manera general
properties.tier cadena El nivell de llicència del connector, com Standard ara o Premium. Standard Disponible de manera general
properties.releaseTag cadena L'etapa d'alliberament del connector, com Production ara o Preview. Production Disponible de manera general
properties.isDeprecated boolean Si el connector està obsolet. false Disponible de manera general
properties.operations matriu Les operacions que exposa el connector. Vegeu les següents files. Disponible de manera general
properties.operations[].operationId cadena L'identificador de l'operació. GetItems Disponible de manera general
properties.operations[].displayName cadena El nom visual de l'operació. Get items Disponible de manera general
properties.operations[].description cadena Una descripció de l'operació. Gets items from a SharePoint list. Disponible de manera general
properties.operations[].method cadena El mètode HTTP de l'operació. GET Disponible de manera general

Limitacions conegudes

  • Els connectors tabulars no informen d'operacions. Els connectors vinculats com a fonts de dades (com SharePoint, Dataverse, SQL Server i Excel Online) apareixen en powerPlatformConnectors però emeten una matriu buida operations.
  • Les accions integrades no es capturen. Les accions integrades de Power Automate, com l'acció integrada HTTP, les accions de Control i les operacions de dades, no són connectors i no apareixen a powerPlatformConnectors. Aquesta diferència sovint causa confusió: un flux que crida un servei extern a través de l'acció HTTP integrada no mostra cap connector per a aquesta trucada.
  • Les aplicacions de codi, les aplicacions d'ambient i les aplicacions d'App Builder no estan cobertes. Només els tipus de recursos llistats en aquesta secció emeten dades del connector.
  • Les aplicacions basades en models rarament informen de connectors. Les aplicacions basades en models rarament criden connectors directament. Les dades del connector només apareixen quan una pàgina de canvas està incrustada en una aplicació basada en models, i l'ús del connector d'aquesta pàgina es captura al registre de la pàgina de canvas.
  • No hi ha noms visuals de connectors ni dades de nivells. Aquesta versió exposa només els identificadors de connectors i d'operació. No s'inclouen noms de visualització, nivells (Estàndard/Premium) ni informació de l'editor.

Aplicacions de llenç

Camí de camp API Tipus de dades Descripció Exemple Estat
properties.ownerId cadena L'ID de l'objecte del propietari del recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.environmentId cadena L'identificador de l'entorn que conté el recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.lastModifiedAt datetime La data i hora en què es va modificar l'aplicació per última vegada. 2026-01-15T10:30:00Z Disponible de manera general
properties.lastModifiedBy cadena L'ID de l'objecte de l'usuari que va modificar l'aplicació per última vegada. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.isQuarantined boolean Si l'aplicació està en quarantena. false Disponible de manera general
properties.powerPlatformConnectors matriu Els connectors i operacions que utilitza l'aplicació. Vegeu l'inventari de connectors. Vegeu la secció. Disponible de manera general

Aplicacions basades en models

Camí de camp API Tipus de dades Descripció Exemple Estat
properties.ownerId cadena L'ID de l'objecte del propietari del recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.environmentId cadena L'identificador de l'entorn que conté el recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.lastModifiedAt datetime La data i hora en què es va modificar l'aplicació per última vegada. 2026-01-15T10:30:00Z Disponible de manera general
properties.lastModifiedBy cadena L'ID de l'objecte de l'usuari que va modificar l'aplicació per última vegada. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.isQuarantined boolean Si l'aplicació està en quarantena. false Disponible de manera general
properties.appModuleId cadena L'ID del mòdul de l'aplicació Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.logicalName cadena El nom lògic Dataverse de l'aplicació. contoso_expensereport Disponible de manera general
properties.powerPlatformConnectors matriu Els connectors i operacions que utilitza l'aplicació. Vegeu l'inventari de connectors. Vegeu la secció. Disponible de manera general

Nota

El properties.powerPlatformConnectors camp rarament retorna dades per a aplicacions basades en models, perquè aquestes no utilitzen connectors directament. Els connectors utilitzats per pàgines de llenç incrustats es capturen al registre de pàgina de tela.

Aplicacions de codi

Camí de camp API Tipus de dades Descripció Exemple Estat
properties.ownerId cadena L'ID de l'objecte del propietari del recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.environmentId cadena L'identificador de l'entorn que conté el recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.lastModifiedAt datetime La data i hora en què es va modificar l'aplicació per última vegada. 2026-01-15T10:30:00Z Disponible de manera general
properties.lastModifiedBy cadena L'ID de l'objecte de l'usuari que va modificar l'aplicació per última vegada. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.isQuarantined boolean Si l'aplicació està en quarantena. false Disponible de manera general
properties.subType cadena El subtipus de l'aplicació de codi: byocApp o vibeApp. byocApp Disponible de manera general

Nota

Els valors de subtipus corresponen respectivament a aplicacions de codi i aplicacions de vibració.

Aplicacions

El microsoft.powerapps/apps tipus de recurs inclou els següents subtipus d'aplicació.

Tipus d’aplicació properties.subType Valor
Aplicacions gestionades microsoftApp
Aplicacions App Builder appBuilderApp
Camí de camp API Tipus de dades Descripció Exemple Estat
properties.ownerId cadena L'ID de l'objecte del propietari del recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.environmentId cadena L'identificador de l'entorn que conté el recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.lastModifiedAt datetime La data i hora en què es va modificar l'aplicació per última vegada. 2026-01-15T10:30:00Z Disponible de manera general
properties.lastModifiedBy cadena L'ID de l'objecte de l'usuari que va modificar l'aplicació per última vegada. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.isQuarantined boolean Si l'aplicació està en quarantena. false Disponible de manera general
properties.subType cadena El subtipus de l'aplicació: microsoftApp per a aplicacions gestionades o appBuilderApp per a aplicacions d'App Builder. microsoftApp Disponible de manera general

Aplicacions gestionades

Les aplicacions construïdes en runtime gestionat per Copilot utilitzen aquest microsoftApp subtipus.

Camí de camp API Tipus de dades Descripció Exemple Estat
properties.powerPlatformConnectors matriu Els connectors i operacions que utilitza l'aplicació. Vegeu l'inventari de connectors. Vegeu la secció. Disponible de manera general

Aplicacions App Builder

Les aplicacions d'App Builder utilitzen aquest appBuilderApp subtipus i no afegeixen camps específics de subtipus més enllà dels camps compartits d'Apps. Per a més informació, vegeu App Builder.

Fluxos de núvol

Camí de camp API Tipus de dades Descripció Exemple Estat
properties.ownerId cadena L'ID de l'objecte del propietari del recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.environmentId cadena L'identificador de l'entorn que conté el recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.lastModifiedAt datetime La data i l'hora en què es va modificar el flux per última vegada. 2026-01-15T10:30:00Z Disponible de manera general
properties.lastModifiedBy cadena L'ID de l'objecte de l'usuari que va modificar el flux per última vegada. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.workflowEntityId cadena L'ID de l'entitat del flux de treball Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.powerPlatformConnectors matriu Els connectors i operacions que utilitza el flux. Vegeu l'inventari de connectors. Vegeu la secció. Disponible de manera general
properties.trigger cadena El connector que inicia el flux. Buida quan el disparador no és basat en connector (per exemple, de recurrència o manual). sharepointonline Disponible de manera general
properties.triggerOperation cadena L'operació que inicia el flux. GetOnNewItems Disponible de manera general

Fluxos d'agents

Camí de camp API Tipus de dades Descripció Exemple Estat
properties.ownerId cadena L'ID de l'objecte del propietari del recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.environmentId cadena L'identificador de l'entorn que conté el recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.lastModifiedAt datetime La data i l'hora en què es va modificar el flux per última vegada. 2026-01-15T10:30:00Z Disponible de manera general
properties.lastModifiedBy cadena L'ID de l'objecte de l'usuari que va modificar el flux per última vegada. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.workflowEntityId cadena L'ID de l'entitat del flux de treball Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.powerPlatformConnectors matriu Els connectors i operacions que utilitza el flux. Vegeu l'inventari de connectors. Vegeu la secció. Disponible de manera general
properties.trigger cadena El connector que inicia el flux. Buida quan el disparador no és basat en connector (per exemple, de recurrència o manual). sharepointonline Disponible de manera general
properties.triggerOperation cadena L'operació que inicia el flux. GetOnNewItems Disponible de manera general

Fluxos d'agents de flux de treball

Camí de camp API Tipus de dades Descripció Exemple Estat
properties.ownerId cadena L'ID de l'objecte del propietari del recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.environmentId cadena L'identificador de l'entorn que conté el recurs. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.lastModifiedAt datetime La data i l'hora en què es va modificar el flux per última vegada. 2026-01-15T10:30:00Z Disponible de manera general
properties.lastModifiedBy cadena L'ID de l'objecte de l'usuari que va modificar el flux per última vegada. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.workflowEntityId cadena L'ID de l'entitat del flux de treball Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.powerPlatformConnectors matriu Els connectors i operacions que utilitza el flux. Vegeu l'inventari de connectors. Vegeu la secció. Disponible de manera general
properties.trigger cadena El connector que inicia el flux. Buida quan el disparador no és basat en connector (per exemple, de recurrència o manual). sharepointonline Disponible de manera general
properties.triggerOperation cadena L'operació que inicia el flux. GetOnNewItems Disponible de manera general

Agents de Copilot Studio

Els agents de Copilot Studio disposen d'un conjunt ric de propietats més enllà dels camps compartits. Per a l'esquema complet, vegeu Microsoft Copilot Studio Esquema d'inventari de l'agent.

Llocs de Power Pages (vista prèvia)

Els llocs Power Pages utilitzen el microsoft.powerpages/sites tipus de recurs. A més dels camps de recursos compartits, els llocs de Power Pages inclouen els següents camps.

Camí de camp API Tipus de dades Descripció Exemple Estat
properties.environmentId cadena L'identificador de l'entorn que conté el lloc. aaaa0000-bb11-2222-33cc-444444dddddd Visualització prèvia
properties.lastModifiedAt datetime La data i hora en què es va modificar per última vegada el flux, en UTC. 2026-09-21T10:08:21.6034821Z Visualització prèvia
properties.ownerId cadena L'ID de l'objecte del propietari del recurs. aaaa0000-bb11-2222-33cc-444444dddddd Visualització prèvia
properties.status cadena L'estat operatiu actual del lloc. Online Visualització prèvia
properties.anonymousAccessAllowed boolean Si es permet l'accés anònim al lloc. false Visualització prèvia
properties.provisioningState cadena L'estat actual de provisionament del recurs d'inventari. Succeeded Visualització prèvia
properties.maintenanceMode boolean Si el lloc està en mode de manteniment. false Visualització prèvia
properties.siteVisibility cadena La configuració de visibilitat del lloc. private Visualització prèvia
properties.customSiteUrl cadena La URL personalitzada del lloc, quan està configurada. Buit quan no hi ha cap URL personalitzada configurada. https://www.contoso.com/ or Empty when no custom URL is configured Visualització prèvia
properties.siteType cadena El tipus de lloc de Power Pages. Production Visualització prèvia
properties.siteUrl cadena L'URL per defecte del lloc de Power Pages. https://site.powerappsportals.com/ Visualització prèvia

Per a consultes d'exemple, vegeu consultes de Power Pages (previsualització).

Entorns

Per a més informació sobre els entorns, vegeu Visió general dels entorns.

Camí de camp API Tipus de dades Descripció Exemple Estat
properties.environmentType cadena El tipus d'entorn: Producció, Default, Sandbox, Trial, Developer o Dataverse per a Teams. Production Disponible de manera general
properties.isManaged boolean Si l'entorn és un entorn gestionat. true Disponible de manera general
properties.environmentGroup cadena El nom del grup d'entorn, si s'assigna. Finance Disponible de manera general
properties.environmentGroupId cadena L'identificador del grup d'entorn, si s'assigna. aaaa0000-bb11-2222-33cc-444444dddddd Disponible de manera general
properties.lastModifiedAt datetime La data i hora en què es va modificar l'entorn per última vegada. 2026-01-15T10:30:00Z Disponible de manera general

Grups d'entorns

Per a més informació, vegeu Grups de Medi Ambient.

Camí de camp API Tipus de dades Descripció Exemple Estat
properties.description cadena La descripció del grup d'entorn. All finance team environments Disponible de manera general
properties.lastModifiedAt datetime La data i hora en què es va modificar el grup per última vegada. 2026-01-15T10:30:00Z Disponible de manera general

Contingut relacionat

  • Darrera actualització el