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.

Campos de recursos compartilhados

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

Inventário de conectores (prévia)

O inventário do Power Platform representa conectores de duas maneiras relacionadas:

• Conectores usados por recursos: os conectores e operações que cada aplicativo, fluxo ou agente usa, capturados como a properties.powerPlatformConnectors matriz. Esses dados também aparecem como uma coluna Conectores nas grades de inventário do centro de administração do Power Platform: a página Gerenciar>Inventário unificada e as exibições específicas do recurso em Copilot Studio, Power Apps e Power Automate.
• Conectores como um tipo de recurso: cada conector disponível em seu locatário também é seu próprio registro de inventário, no microsoft.powerplatformconnector/connectors tipo de recurso. Para seus campos, consulte Conectores como um tipo de recurso.

Os seguintes tipos de recursos geram dados do conector: aplicativos de tela, aplicativos baseados em modelos, fluxos da nuvem, fluxos de agente, fluxos de agentes de fluxo de trabalho e agentes do Copilot Studio (incluindo Microsoft 365 Copilot Agent Builder).

Para fluxos (fluxos da nuvem, fluxos de agente e fluxos de agente de fluxo de trabalho), o estoque 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

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 um tipo de recurso

O inventário do Power Platform não apenas captura o uso do conector em recursos individuais, mas também inclui conectores como um tipo de recurso. microsoft.powerplatformconnector/connectors Cada registro representa um conector disponível em seu locatário e lista as operações expostas por ele, juntamente com os metadados do editor e da camada.

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.
• Ações integradas não são capturadas. Ações internas do Power Automate, como a ação interna de HTTP, ações de controle e operações de dados, não são conectores e não aparecem em powerPlatformConnectors. Essa diferença geralmente causa confusão: um fluxo que chama um serviço externo por meio da ação interna HTTP não mostra nenhum conector para essa chamada.
• 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 baseado em modelo 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

Aplicativos baseados em modelos

Aplicativos de código

Aplicativos do Construtor de Aplicativos

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

Fluxos da nuvem

Fluxos de agente

Fluxos de agente do fluxo de trabalho

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.

Grupos de ambiente

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

Conteúdo relacionado

• Inventário do Power Platform
• API de inventário do Power Platform
• Consultas de exemplo para o inventário do Power Platform
• Visão geral dos ambientes
• Grupos de ambientes
• Visão geral do Azure Resource Graph
• Visão geral do KQL (Linguagem de Consulta Kusto)