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.

Campos de recursos partilhados

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

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

O inventário da Power Platform representa os conectores de duas formas relacionadas:

• Conectores usados pelos recursos: os conectores e operações que cada app, flow ou agente utiliza, capturados como o properties.powerPlatformConnectors array. Estes dados também aparecem como uma coluna Conectores nas grelhas de inventário do centro de administração do Power Platform: a página unificada de Gerir>Inventário e as vistas específicas por recurso em Copilot Studio, Power Apps e Power Automate.
• Conectores como tipo de recurso: cada conector disponível no seu tenant é também o seu próprio registo de inventário, sob o tipo de microsoft.powerplatformconnector/connectors recurso. Para os seus campos, veja Conectores como um tipo de recurso.

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

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

Conectores como tipo de recurso

O inventário da Power Platform não só capta a utilização de conectores em recursos individuais, como também inclui conectores como tipo de recurso. microsoft.powerplatformconnector/connectors Cada registo representa um conector disponível no seu tenant e lista as operações que expõe, juntamente com os metadados do editor e do nível.

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

Aplicativos orientados por modelo

Aplicativos de código

Aplicações construtoras de aplicações

Para mais informações, consulte App Builder.

Fluxos de Nuvem

Fluxos de agentes

Fluxos de agente de fluxo de trabalho

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.

Grupos de ambientes

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

Conteúdo relacionado

• Inventário da Power Platform
• API de inventário da Power Platform
• Consultas de exemplo do inventário do Power Platform
• Descrição geral de ambientes
• Grupos de ambientes
• Visão geral do Azure Resource Graph
• Descrição geral da Linguagem de Pesquisa Kusto (KQL)