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

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

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

Tipos de recursos

Cada registro na PowerPlatformResources tabela tem um campo de tipo que identifica o tipo de recurso. A tabela a seguir lista todos os tipos com suporte.

Nome de exibição Valor de type
Aplicativos de tela microsoft.powerapps/canvasapps
Aplicativos baseados em modelos microsoft.powerapps/modeldrivenapps
Aplicativos de código microsoft.powerapps/codeapps
Aplicativos do Construtor de Aplicativos microsoft.powerapps/apps
Fluxos da nuvem microsoft.powerautomate/cloudflows
Fluxos de agente microsoft.powerautomate/agentflows
Fluxos de agente do fluxo de trabalho microsoft.powerautomate/m365agentflows
agentes do Copilot Studio microsoft.copilotstudio/agents
Ambientes microsoft.powerplatform/environments
Grupos de ambiente microsoft.powerplatform/environmentgroups

Campos de recursos compartilhados

Todos os tipos de recursos na tabela PowerPlatformResources incluem os campos a seguir.

Nome da experiência do usuário Caminho do campo de API Tipo de dados Description Example Situação
Nome do item properties.displayName cadeia O nome de exibição do recurso. Aplicativo relatório de despesas Geralmente disponível
Tipo de item type cadeia O identificador de tipo de recurso (consulte tipos de recurso). microsoft.powerapps/canvasapps Geralmente disponível
ID do Item name cadeia O identificador exclusivo do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
Localização location cadeia A região geográfica do recurso. unitedstates Geralmente disponível
Criação em properties.createdAt datetime A data e a hora em que o recurso foi criado. 2025-06-01T08:00:00Z Geralmente disponível
Criado por properties.createdBy cadeia A ID do objeto do usuário que criou o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível

Note

O tenantId campo também está disponível como um campo ARM de nível superior em cada registro de recurso.

Inventário de conectores (prévia)

O inventário do Power Platform captura os conectores e as operações de conector usadas por cada recurso. Esses dados aparecem como uma coluna Conectores em todas as grades de inventário da central de administração do Power Platform. A página unificada Gerenciar > Inventário e as exibições específicas de recurso em Copilot Studio, Power Apps e Power Automate, e como a matriz properties.powerPlatformConnectors em consultas programáticas.

Os seguintes tipos de recurso emitem dados do conector: aplicativos de tela, aplicativos controlados por modelos, fluxos de nuvem, fluxos de agente, fluxos de agente de fluxo de trabalho e agentes de Copilot Studio (incluindo Microsoft 365 Copilot Agent Builder).

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

Schema

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

Note

Copilot Studio agentes emitem metadados adicionais por operação que refletem como os agentes usam conectores como ferramentas ou fontes de conhecimento. Para obter detalhes, consulte Microsoft Copilot Studio Agent inventory schema.

Limitações conhecidas

  • Conectores tabulares não informam operações. Conectores associados como fontes de dados (como SharePoint, Dataverse, SQL Server e Excel Online) aparecem em powerPlatformConnectors mas emitem uma matriz operations vazia.
  • Aplicativos de código, aplicativos vibe e aplicativos do Construtor de Aplicativos não são cobertos. Somente os tipos de recurso listados nesta seção emitem dados do conector.
  • Aplicativos baseados em modelo raramente informam conectores. Aplicativos orientados por modelo raramente chamam conectores diretamente. Os dados do conector só são exibidos quando uma página de tela é inserida em um aplicativo controlado por modelos e o uso do conector dessa página é capturado no próprio registro da página de tela.
  • Nenhum conector exibe nomes ou dados de camada. Esta versão expõe somente IDs do conector e IDs de operação. Nomes de exibição, camadas (Standard/Premium) e informações do editor não estão incluídos.

Aplicativos de tela

Caminho do campo de API Tipo de dados Description Example Situação
properties.ownerId cadeia O identificador do objeto do proprietário do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.environmentId cadeia O identificador do ambiente que contém o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.lastModifiedAt datetime A data e a hora que o aplicativo foi modificado pela última vez. 2026-01-15T10:30:00Z Geralmente disponível
properties.lastModifiedBy cadeia A ID do objeto do usuário que modificou o aplicativo pela última vez. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.isQuarantined booliano Se o aplicativo está em quarentena. false Geralmente disponível
properties.powerPlatformConnectors matriz Os conectores e as operações usados pelo aplicativo. Consulte o inventário do Conector (versão prévia). Consulte a seção. Preview

Note

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

Aplicativos baseados em modelos

Caminho do campo de API Tipo de dados Description Example Situação
properties.ownerId cadeia O identificador do objeto do proprietário do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.environmentId cadeia O identificador do ambiente que contém o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.lastModifiedAt datetime A data e a hora que o aplicativo foi modificado pela última vez. 2026-01-15T10:30:00Z Geralmente disponível
properties.lastModifiedBy cadeia A ID do objeto do usuário que modificou o aplicativo pela última vez. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.isQuarantined booliano Se o aplicativo está em quarentena. false Geralmente disponível
properties.appModuleId cadeia A ID do módulo do aplicativo Dataverse. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.logicalName cadeia O nome lógico do aplicativo no Dataverse. contoso_expensereport Geralmente disponível
properties.powerPlatformConnectors matriz Os conectores e as operações usados pelo aplicativo. Consulte o inventário do Conector (versão prévia). Consulte a seção. Preview

Note

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

Note

O properties.powerPlatformConnectors campo raramente retorna dados para aplicativos controlados por modelos, pois aplicativos controlados por modelos não usam conectores diretamente. Os conectores usados por páginas de canvas incorporadas são registrados no registro da página de canvas, em vez disso.

Aplicativos de código

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

Note

Os valores de subtipo correspondem a aplicativos de código e aplicativos de vibe, respectivamente.

Note

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

Aplicativos do Construtor de Aplicativos

Para obter mais informações, consulte o Construtor de Aplicativos.

Caminho do campo de API Tipo de dados Description Example Situação
properties.ownerId cadeia O identificador do objeto do proprietário do recurso. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.environmentId cadeia O identificador do ambiente que contém o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.lastModifiedAt datetime A data e a hora que o aplicativo foi modificado pela última vez. 2026-01-15T10:30:00Z Geralmente disponível
properties.lastModifiedBy cadeia A ID do objeto do usuário que modificou o aplicativo pela última vez. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.isQuarantined booliano Se o aplicativo está em quarentena. false Geralmente disponível
properties.subType cadeia O subtipo do aplicativo. Atualmente appBuilderApp. appBuilderApp Geralmente disponível

Note

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

Fluxos da nuvem

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

Fluxos de agente

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

Fluxos de agente do fluxo de trabalho

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

agentes do Copilot Studio

Os agentes do Copilot Studio têm um conjunto avançado de propriedades além dos campos compartilhados, incluindo propriedades de núcleo, identidade e configuração. Para obter o esquema completo, consulte Esquema de inventário do agente do Microsoft Copilot Studio.

Ambientes

Para obter mais informações sobre ambientes, consulte a visão geral de Ambientes.

Caminho do campo de API Tipo de dados Description Example Situação
properties.environmentType cadeia O tipo de ambiente: Produção, Padrão, Área Restrita, Avaliação, Desenvolvedor ou Dataverse for Teams. Production Geralmente disponível
properties.isManaged booliano Se o ambiente é um Ambiente Gerenciado. true Geralmente disponível
properties.environmentGroup cadeia O nome do grupo de ambiente, se atribuído. Finance Geralmente disponível
properties.environmentGroupId cadeia O identificador do grupo de ambiente, se atribuído. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.lastModifiedAt datetime A data e a hora em que o ambiente foi modificado pela última vez. 2026-01-15T10:30:00Z Geralmente disponível

Grupos de ambiente

Para obter mais informações, consulte Grupos de ambiente.

Caminho do campo de API Tipo de dados Description Example Situação
properties.description cadeia A descrição do grupo de ambiente. All finance team environments Geralmente disponível
properties.lastModifiedAt datetime A data e a hora em que o grupo foi modificado pela última vez. 2026-01-15T10:30:00Z Geralmente disponível