Referência de esquema de inventário do Power Platform

O inventário do Power Platform expõe os dados de recursos através da tabela PowerPlatformResources no Azure Resource Graph. Este artigo descreve os tipos de recursos e campos disponíveis nessa tabela para que possa construir consultas direcionadas e compreender o modelo de dados por trás da experiência de inventário do Power Platform .

Para informações sobre como consultar a tabela programaticamente, consulte Power Platform Inventory API. Para a referência completa da API REST, consulte a documentação da API REST do Power Platform.

Tipos de recursos

Cada registo na PowerPlatformResources tabela tem um campo de tipo que identifica o tipo de recurso. A tabela seguinte lista todos os tipos suportados.

Nome de exibição type Valor
Aplicações Canvas microsoft.powerapps/canvasapps
Aplicativos orientados por modelo microsoft.powerapps/modeldrivenapps
Aplicativos de código microsoft.powerapps/codeapps
Aplicações construtoras de aplicações microsoft.powerapps/apps
Fluxos de Nuvem microsoft.powerautomate/cloudflows
Fluxos de agentes microsoft.powerautomate/agentflows
Fluxos de agente de fluxo de trabalho microsoft.powerautomate/m365agentflows
Agentes da Copilot Studio microsoft.copilotstudio/agents
Environments microsoft.powerplatform/environments
Grupos de ambientes microsoft.powerplatform/environmentgroups

Campos de recursos partilhados

Todos os tipos de recursos na tabela PowerPlatformResources incluem os seguintes campos.

Nome da experiência do utilizador Caminho do campo da API Tipo de dados Description Example Situação
Nome do item properties.displayName cadeia (de caracteres) O nome para exibição do recurso. Aplicação de Relatórios de Despesas Disponível ao público em geral
Tipo de item type cadeia (de caracteres) O identificador do tipo de recurso (ver Tipos de recurso). microsoft.powerapps/canvasapps Disponível ao público em geral
ID de item name cadeia (de caracteres) O identificador exclusivo do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
Localização location cadeia (de caracteres) A região geográfica do recurso. unitedstates Disponível ao público em geral
Criados em properties.createdAt datetime A data e hora em que o recurso foi criado. 2025-06-01T08:00:00Z Disponível ao público em geral
Criado por properties.createdBy cadeia (de caracteres) O ID do objeto do utilizador que criou o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral

Observação

O campo tenantId também está disponível como um campo ARM de nível superior em todos os registos de recursos.

Inventário de conectores (pré-visualização)

O inventário da Power Platform regista os conectores e operações de conectores usados por cada recurso. Estes dados aparecem numa coluna Conectores nas grelhas de inventário do centro de administração da Power Platform. A página unificada Gerir > Inventário e as vistas específicas de recursos em Copilot Studio, Power Apps e Power Automate, e como a matriz properties.powerPlatformConnectors em consultas programáticas.

Os seguintes tipos de recursos emitem dados de conectores: aplicações de tela, aplicações condicionadas por modelo, fluxos de cloud, fluxos de agentes, fluxos de agentes de fluxos de trabalho e agentes do Copilot Studio (incluindo o Construtor de Agentes do Microsoft 365 Copilot).

Para os fluxos (fluxos de cloud, fluxos de agentes e fluxos de agentes de fluxos de trabalho), o inventário também capta o conector e a operação que iniciam o fluxo como properties.trigger e properties.triggerOperation. Estes campos complementam powerPlatformConnectors, que capta os conectores invocados durante a execução do fluxo.

Schema

Caminho do campo da API Tipo de dados Description Situação
properties.powerPlatformConnectors matriz Os conectores usados pelo recurso. Preview
properties.powerPlatformConnectors[].connectorId cadeia (de caracteres) O identificador do conector (por exemplo, shared_sharepointonline). Preview
properties.powerPlatformConnectors[].operations matriz As operações no conetor invocadas pelo recurso. Preview
properties.powerPlatformConnectors[].operations[].operationId cadeia (de caracteres) O identificador da operação (por exemplo, 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" }
        ]
      }
    ]
  }
}

Observação

Os agentes do Copilot Studio emitem metadados adicionais por operação que refletem como os agentes utilizam conectores como ferramentas ou fontes de conhecimento. Para mais detalhes, consulte o esquema de inventário de agentes do Microsoft Copilot Studio.

Limitações conhecidas

  • Os conectores tabulares não reportam operações. Conectores vinculados como fontes de dados (como SharePoint, Dataverse, SQL Server e Excel Online) aparecem em powerPlatformConnectors mas emitem um array vazio operations.
  • As ações integradas não são capturadas. As ações incorporadas do Power Automate, como a ação incorporada HTTP, as ações de Controlo e as operações de dados, não são conectores e não aparecem em powerPlatformConnectors. Esta diferença frequentemente causa confusão: um fluxo que chama um serviço externo através da ação incorporada HTTP não mostra nenhum conector para essa chamada.
  • As aplicações de código, as aplicações vibe e as aplicações do App Builder não estão incluídas. Apenas os tipos de recursos listados nesta secção emitem dados do conector.
  • Aplicações orientadas a modelos raramente reportam conectores. As aplicações condicionadas por modelo raramente invocam conectores diretamente. Os dados do conector só aparecem quando uma página de tela está incorporada numa aplicação condicionada por modelo, e a utilização do conector dessa página é capturada no registo da própria página de tela.
  • Não existem nomes a apresentar de conectores nem dados de escalão. Esta versão expõe apenas IDs de conectores e IDs de operação. Nomes de visualização, níveis (Standard/Premium) e informações do editor não estão incluídos.

Aplicações Canvas

Caminho do campo da API Tipo de dados Description Example Situação
properties.ownerId cadeia (de caracteres) ID de objeto do proprietário do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.environmentId cadeia (de caracteres) O identificador do ambiente que contém o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.lastModifiedAt datetime A data e hora em que a aplicação foi modificada pela última vez. 2026-01-15T10:30:00Z Disponível ao público em geral
properties.lastModifiedBy cadeia (de caracteres) O ID do objeto do utilizador que modificou a aplicação pela última vez. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.isQuarantined boolean Se a aplicação está em quarentena. false Disponível ao público em geral
properties.powerPlatformConnectors matriz Os conectores e operações usados pela aplicação. Consulte o inventário do Conector (pré-visualização). Ver secção. Preview

Observação

O properties.isQuarantined campo está disponível através da API, mas ainda não aparece na experiência de inventário do centro de administração do Power Platform.

Aplicativos orientados por modelo

Caminho do campo da API Tipo de dados Description Example Situação
properties.ownerId cadeia (de caracteres) ID de objeto do proprietário do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.environmentId cadeia (de caracteres) O identificador do ambiente que contém o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.lastModifiedAt datetime A data e hora em que a aplicação foi modificada pela última vez. 2026-01-15T10:30:00Z Disponível ao público em geral
properties.lastModifiedBy cadeia (de caracteres) O ID do objeto do utilizador que modificou a aplicação pela última vez. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.isQuarantined boolean Se a aplicação está em quarentena. false Disponível ao público em geral
properties.appModuleId cadeia (de caracteres) O ID do módulo da aplicação Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.logicalName cadeia (de caracteres) O nome lógico da aplicação Dataverse. contoso_expensereport Disponível ao público em geral
properties.powerPlatformConnectors matriz Os conectores e operações usados pela aplicação. Consulte o inventário do Conector (pré-visualização). Ver secção. Preview

Observação

O properties.isQuarantined campo está disponível através da API, mas ainda não aparece na experiência de inventário do centro de administração do Power Platform.

Observação

O properties.powerPlatformConnectors campo raramente devolve dados para aplicações orientadas a modelos, porque as aplicações orientadas a modelos não usam conectores diretamente. Os conectores usados pelas páginas de tela incorporadas são, em vez disso, registados no registo da página de tela.

Aplicativos de código

Caminho do campo da API Tipo de dados Description Example Situação
properties.ownerId cadeia (de caracteres) ID de objeto do proprietário do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.environmentId cadeia (de caracteres) O identificador do ambiente que contém o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.lastModifiedAt datetime A data e hora em que a aplicação foi modificada pela última vez. 2026-01-15T10:30:00Z Disponível ao público em geral
properties.lastModifiedBy cadeia (de caracteres) O ID do objeto do utilizador que modificou a aplicação pela última vez. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.isQuarantined boolean Se a aplicação está em quarentena. false Disponível ao público em geral
properties.subType cadeia (de caracteres) O subtipo da aplicação de código: byocApp ou vibeApp. byocApp Disponível ao público em geral

Observação

Os valores de subtipo correspondem a aplicações de código e aplicações de vibração, respetivamente.

Observação

O properties.isQuarantined campo está disponível através da API, mas ainda não aparece na experiência de inventário do centro de administração do Power Platform.

Aplicações construtoras de aplicações

Para mais informações, consulte App Builder.

Caminho do campo da API Tipo de dados Description Example Situação
properties.ownerId cadeia (de caracteres) ID de objeto do proprietário do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.environmentId cadeia (de caracteres) O identificador do ambiente que contém o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.lastModifiedAt datetime A data e hora em que a aplicação foi modificada pela última vez. 2026-01-15T10:30:00Z Disponível ao público em geral
properties.lastModifiedBy cadeia (de caracteres) O ID do objeto do utilizador que modificou a aplicação pela última vez. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.isQuarantined boolean Se a aplicação está em quarentena. false Disponível ao público em geral
properties.subType cadeia (de caracteres) O subtipo da aplicação. Atualmente appBuilderApp. appBuilderApp Disponível ao público em geral

Observação

O properties.isQuarantined campo está disponível através da API, mas ainda não aparece na experiência de inventário do centro de administração do Power Platform.

Fluxos de Nuvem

Caminho do campo da API Tipo de dados Description Example Situação
properties.ownerId cadeia (de caracteres) ID de objeto do proprietário do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.environmentId cadeia (de caracteres) O identificador do ambiente que contém o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.lastModifiedAt datetime A data e hora em que o fluxo foi modificado pela última vez. 2026-01-15T10:30:00Z Disponível ao público em geral
properties.lastModifiedBy cadeia (de caracteres) O ID do objeto do utilizador que modificou o fluxo pela última vez. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.workflowEntityId cadeia (de caracteres) O ID da entidade do fluxo de trabalho Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.powerPlatformConnectors matriz Os conectores e operações utilizados pelo fluxo. Consulte o inventário do Conector (pré-visualização). Ver secção. Preview
properties.trigger cadeia (de caracteres) O conector que inicia o fluxo. Vazio quando o acionador não é baseado em conectores (por exemplo, recorrência ou manual). sharepointonline Preview
properties.triggerOperation cadeia (de caracteres) A operação que inicia o fluxo. GetOnNewItems Preview

Fluxos de agentes

Caminho do campo da API Tipo de dados Description Example Situação
properties.ownerId cadeia (de caracteres) ID de objeto do proprietário do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.environmentId cadeia (de caracteres) O identificador do ambiente que contém o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.lastModifiedAt datetime A data e hora em que o fluxo foi modificado pela última vez. 2026-01-15T10:30:00Z Disponível ao público em geral
properties.lastModifiedBy cadeia (de caracteres) O ID do objeto do utilizador que modificou o fluxo pela última vez. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.workflowEntityId cadeia (de caracteres) O ID da entidade do fluxo de trabalho Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.powerPlatformConnectors matriz Os conectores e operações utilizados pelo fluxo. Consulte o inventário do Conector (pré-visualização). Ver secção. Preview
properties.trigger cadeia (de caracteres) O conector que inicia o fluxo. Vazio quando o acionador não é baseado em conectores (por exemplo, recorrência ou manual). sharepointonline Preview
properties.triggerOperation cadeia (de caracteres) A operação que inicia o fluxo. GetOnNewItems Preview

Fluxos de agente de fluxo de trabalho

Caminho do campo da API Tipo de dados Description Example Situação
properties.ownerId cadeia (de caracteres) ID de objeto do proprietário do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.environmentId cadeia (de caracteres) O identificador do ambiente que contém o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.lastModifiedAt datetime A data e hora em que o fluxo foi modificado pela última vez. 2026-01-15T10:30:00Z Disponível ao público em geral
properties.lastModifiedBy cadeia (de caracteres) O ID do objeto do utilizador que modificou o fluxo pela última vez. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.workflowEntityId cadeia (de caracteres) O ID da entidade do fluxo de trabalho Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.powerPlatformConnectors matriz Os conectores e operações utilizados pelo fluxo. Consulte o inventário do Conector (pré-visualização). Ver secção. Preview
properties.trigger cadeia (de caracteres) O conector que inicia o fluxo. Vazio quando o acionador não é baseado em conectores (por exemplo, recorrência ou manual). sharepointonline Preview
properties.triggerOperation cadeia (de caracteres) A operação que inicia o fluxo. GetOnNewItems Preview

Agentes da Copilot Studio

Os agentes do Copilot Studio têm um conjunto rico de propriedades para além dos campos partilhados, incluindo propriedades de núcleo, identidade e configuração. Para consultar o esquema completo, veja esquema de inventário de agentes do Microsoft Copilot Studio.

Environments

Para mais informações sobre ambientes, consulte Visão Geral dos Ambientes.

Caminho do campo da API Tipo de dados Description Example Situação
properties.environmentType cadeia (de caracteres) O tipo de ambiente: Produção, Padrão, Sandbox, Teste, Desenvolvedor ou Dataverse para Teams. Production Disponível ao público em geral
properties.isManaged boolean Se o ambiente é um ambiente gerido. true Disponível ao público em geral
properties.environmentGroup cadeia (de caracteres) O nome do grupo de ambiente, caso atribuído. Finance Disponível ao público em geral
properties.environmentGroupId cadeia (de caracteres) O identificador do agrupamento de ambientes, caso seja atribuído. aaaa0000-bb11-2222-33cc-444444dddddd Disponível ao público em geral
properties.lastModifiedAt datetime A data e hora em que o ambiente foi modificado pela última vez. 2026-01-15T10:30:00Z Disponível ao público em geral

Grupos de ambientes

Para mais informações, consulte Grupos de Ambiente.

Caminho do campo da API Tipo de dados Description Example Situação
properties.description cadeia (de caracteres) A descrição do grupo ambiental. All finance team environments Disponível ao público em geral
properties.lastModifiedAt datetime A data e hora em que o grupo foi modificado pela última vez. 2026-01-15T10:30:00Z Disponível ao público em geral

Conteúdo relacionado

  • Last updated on