Compartilhar via

Gerenciamento do Power Automate

O conector do Gerenciamento do Power Automate habilita a interação com o serviço de Gerenciamento do Power Automate. Por exemplo: criar, editar e atualizar fluxos. Os administradores que desejam executar operações com privilégios de administrador devem chamar ações com o sufixo "como Administrador". A autenticação da Entidade de Serviço tem suporte apenas para ações administrativas.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Standard Todas as regiões do Power Automate
Power Apps Standard Todas as regiões do Power Apps
Power Automate Standard Todas as regiões do Power Automate
Contato
Nome Microsoft
URL Suporte do Microsoft Power Automate
Suporte do Microsoft Power Apps
Metadados do conector
Publicador Microsoft
Site https://make.powerautomate.com/

Limites Gerais

Nome Value
Conexões por conta 50

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Autenticação de Certificado do Cliente Fornecer credenciais de ID do Microsoft Entra usando certificado PFX e senha Todas as regiões Não compartilhável
Microsoft Entra ID Integrado Use a ID do Microsoft Entra para acessar esse serviço. Todas as regiões Não compartilhável
Padrão [PRETERIDO] Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. Todas as regiões Não compartilhável

Autenticação de Certificado do Cliente

ID de autenticação: CertOauth

Aplicável: todas as regiões

Fornecer credenciais de ID do Microsoft Entra usando certificado PFX e senha

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Inquilino cadeia Verdade
ID do cliente cadeia A ID do cliente do aplicativo Microsoft Entra ID
Segredo do certificado do cliente clientCertificate O segredo do certificado do cliente permitido por este aplicativo Verdade

Microsoft Entra ID Integrado

ID de autenticação: firstParty

Aplicável: todas as regiões

Use a ID do Microsoft Entra para acessar esse serviço.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Padrão [PRETERIDO]

Aplicável: todas as regiões

Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 5 60 segundos
Solicitações não get por conexão 300 3600 segundos

Ações

Ativar Fluxo

Inicie o fluxo determinado em um ambiente.
Cancelar Execução de Fluxo

Cancelar uma execução de fluxo.
Criar conexão

Crie uma conexão para o conector especificado em um ambiente.
Criar Fluxo

Criar fluxo
Desativar Fluxo

Pare o fluxo determinado em um ambiente.
Excluir Fluxo

Excluir o fluxo determinado em um ambiente
Fluxo de Atualização

Atualize o fluxo determinado em um ambiente.
Listar conectores

Lista todos os conectores disponíveis no ambiente especificado. Essa lista incluirá conectores personalizados, bem como os conectores internos.
Listar fluxos como administrador (V2)

Liste todos os fluxos no ambiente ao qual você tem acesso de administrador. Essa ação V2 é uma ação de maior desempenho que retorna apenas as informações de identificação sobre o fluxo. A definição de fluxo e grande parte dos metadados não são retornados. Para metadados adicionais e a definição de fluxo, faça uma chamada subsequente para a ação Obter Fluxos como Administrador.
Listar meus ambientes

Liste os ambientes aos quais você tem acesso.
Listar Meus Fluxos

Liste todos os fluxos que você criou no ambiente especificado.
Listar minhas conexões

Lista toda a conexão disponível no ambiente especificado.
Listar proprietários de fluxo

Liste todos os proprietários do fluxo especificado em um ambiente.
Listar URL de Retorno de Chamada

Listar a URL de retorno de chamada para o fluxo especificado em um ambiente.
Listar usuários do fluxo Run-Only

Listar todos os usuários executados somente do fluxo especificado em um ambiente.
Modificar proprietários de fluxo

Modifique os proprietários do fluxo especificado em um ambiente.
Modificar proprietários de fluxo como administrador

Modifique os proprietários do fluxo determinado criado em um ambiente ao qual você tem acesso de administrador.
Modificar usuários Run-Only

Modifique usuários somente execução do fluxo especificado em um ambiente.
Obter Conector

Obtenha o conector especificado em um ambiente.
Obter Fluxo

Obtenha o fluxo determinado em um ambiente.
Obter o Fluxo como Administrador

Obtenha o fluxo determinado de um ambiente ao qual você tem acesso de administrador.
Reenviar Fluxo

Reenviar a execução de fluxo fornecida em um ambiente.
Restaurar fluxo excluído como administrador

Restaure o fluxo de exclusão reversível determinado em um ambiente ao qual você tem acesso de administrador.

Ativar Fluxo

ID da operação:
StartFlow

Inicie o fluxo determinado em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Cancelar Execução de Fluxo

ID da operação:
CancelFlowRun

Cancelar uma execução de fluxo.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo
Executar ID
 runId True string

A ID da execução do fluxo a ser reenviada.

Criar conexão

ID da operação:
CreateConnection

Crie uma conexão para o conector especificado em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Connector
 apiName True string

Selecionar conector
conexão
 connection dynamic

Connection

Retornos

As saídas desta operação são dinâmicas.

Criar Fluxo

ID da operação:
CreateFlow

Criar fluxo

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Nome do fluxo
 name string
Nome de Exibição do Fluxo
 displayName True string
Estado do fluxo
 state True string
Nome da conexão
 connectionName string
Nome de exibição da conexão
 displayName string
ID do conector
 id True string
Conexão inserida ou invocadora
 source string
Nome lógico da referência de conexão
 connectionReferenceLogicalName string
Nome do Conector
 name string
Nome de exibição do conector
 displayName string
Tempo de Criação da Conexão
 createdTime date-time
URL do Runtime do Conector
 primaryRuntimeUrl string
URL do ícone do conector
 iconUri string
Conector é a API Personalizada
 isCustomApi boolean
Camada do conector
 tier string
Tempo de Criação de Fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri do Gatilho de Fluxo
 flowTriggerUri string
Status da instalação do fluxo
 installationStatus string
ID do locatário do criador
 tenantId True string
ID de objeto do criador
 objectId string
ID do usuário do criador
 userId True string
Tipo de usuário do criador
 userType True string
Tipo de gatilho de fluxo
 type string
Tipo de gatilho de fluxo
 kind string
Tipo de ação
 type string
ID da operação swagger
 swaggerOperationId string
Nome da API de ação
 name string
ID da API de ação
 id string
Tipo de API de ação
 type string

Retornos

Corpo
Flow

Desativar Fluxo

ID da operação:
StopFlow

Pare o fluxo determinado em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Excluir Fluxo

ID da operação:
DeleteFlow

Excluir o fluxo determinado em um ambiente

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Fluxo de Atualização

ID da operação:
UpdateFlow

Atualize o fluxo determinado em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo
Nome do fluxo
 name string
Nome de Exibição do Fluxo
 displayName True string
Estado do fluxo
 state True string
Nome da conexão
 connectionName string
Nome de exibição da conexão
 displayName string
ID do conector
 id True string
Conexão inserida ou invocadora
 source string
Nome lógico da referência de conexão
 connectionReferenceLogicalName string
Nome do Conector
 name string
Nome de exibição do conector
 displayName string
Tempo de Criação da Conexão
 createdTime date-time
URL do Runtime do Conector
 primaryRuntimeUrl string
URL do ícone do conector
 iconUri string
Conector é a API Personalizada
 isCustomApi boolean
Camada do conector
 tier string
Tempo de Criação de Fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri do Gatilho de Fluxo
 flowTriggerUri string
Status da instalação do fluxo
 installationStatus string
ID do locatário do criador
 tenantId True string
ID de objeto do criador
 objectId string
ID do usuário do criador
 userId True string
Tipo de usuário do criador
 userType True string
Tipo de gatilho de fluxo
 type string
Tipo de gatilho de fluxo
 kind string
Tipo de ação
 type string
ID da operação swagger
 swaggerOperationId string
Nome da API de ação
 name string
ID da API de ação
 id string
Tipo de API de ação
 type string

Retornos

Corpo
Flow

Listar conectores

ID da operação:
ListApis

Lista todos os conectores disponíveis no ambiente especificado. Essa lista incluirá conectores personalizados, bem como os conectores internos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente

Retornos

Corpo
ResourceArray[ApiWithoutConnectionParameters]

Listar fluxos como administrador (V2)

ID da operação:
ListFlowsInEnvironment_V2

Liste todos os fluxos no ambiente ao qual você tem acesso de administrador. Essa ação V2 é uma ação de maior desempenho que retorna apenas as informações de identificação sobre o fluxo. A definição de fluxo e grande parte dos metadados não são retornados. Para metadados adicionais e a definição de fluxo, faça uma chamada subsequente para a ação Obter Fluxos como Administrador.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Contagem superior
 $top integer

Contagem superior
Expandir informações de suspensão
 expandSuspensionInfo boolean

Expande as informações de suspensão
Incluir fluxos de Soft-Deleted
 includeSoftDeletedFlows boolean

Incluir ou não fluxos excluídos suavemente.

Retornos

Corpo
ResourceArray[AdminFlowWithoutDefinition]

Listar meus ambientes

ID da operação:
ListUserEnvironments

Liste os ambientes aos quais você tem acesso.

Retornos

Corpo
ResourceArray[Environment]

Listar Meus Fluxos

ID da operação:
ListMyFlows

Liste todos os fluxos que você criou no ambiente especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente

Retornos

Corpo
ResourceArray[AdminFlow]

Listar minhas conexões

ID da operação:
ListConnections

Lista toda a conexão disponível no ambiente especificado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente

Retornos

Corpo
ResourceArray[ConnectionWithoutConnectionParameters]

Listar proprietários de fluxo

ID da operação:
ListFlowOwners

Liste todos os proprietários do fluxo especificado em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Retornos

Corpo
ResourceArray[FlowPermission]

Listar URL de Retorno de Chamada

ID da operação:
ListCallbackUrl

Listar a URL de retorno de chamada para o fluxo especificado em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Retornos

Corpo
FlowListCallbackUrlResponse

Listar usuários do fluxo Run-Only

ID da operação:
ListFlowUsers

Listar todos os usuários executados somente do fluxo especificado em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Retornos

Corpo
ResourceArray[FlowPermission]

Modificar proprietários de fluxo

ID da operação:
ModifyFlowOwners

Modifique os proprietários do fluxo especificado em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo
Adicionar id de objeto de usuário
 id True string
Adicionar tipo de usuário
 type True string
Remover id de objeto de usuário
 id True string
Remover tipo de usuário
 type True string

Modificar proprietários de fluxo como administrador

ID da operação:
AdminModifyFlowOwners

Modifique os proprietários do fluxo determinado criado em um ambiente ao qual você tem acesso de administrador.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo
Adicionar id de objeto de usuário
 id True string
Adicionar tipo de usuário
 type True string
Remover id de objeto de usuário
 id True string
Remover tipo de usuário
 type True string

Modificar usuários Run-Only

ID da operação:
ModifyRunOnlyUsers

Modifique usuários somente execução do fluxo especificado em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo
Adicionar id de objeto de usuário
 id True string
Adicionar tipo de usuário
 type True string
Remover id de objeto de usuário
 id True string
Remover tipo de usuário
 type True string

Obter Conector

ID da operação:
GetApi

Obtenha o conector especificado em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Connector
 apiName True string

Selecionar conector

Retornos

As saídas desta operação são dinâmicas.

Obter Fluxo

ID da operação:
GetFlow

Obtenha o fluxo determinado em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Retornos

Corpo
FlowWithConnectionReferences

Obter o Fluxo como Administrador

ID da operação:
AdminGetFlow

Obtenha o fluxo determinado de um ambiente ao qual você tem acesso de administrador.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo
Incluir definição de fluxo
 includeFlowDefinition boolean

Se deve ou não incluir a definição de fluxo.

Retornos

Corpo
AdminFlowWithConnectionReferences

Reenviar Fluxo

ID da operação:
ResubmitFlow

Reenviar a execução de fluxo fornecida em um ambiente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo
Nome do gatilho
 triggerName True string

Nome do gatilho de fluxo a ser reenviado.
Executar ID
 runId True string

A ID da execução do fluxo a ser reenviada.

Restaurar fluxo excluído como administrador

ID da operação:
AdminRestoreFlow

Restaure o fluxo de exclusão reversível determinado em um ambiente ao qual você tem acesso de administrador.

Parâmetros

Nome Chave Obrigatório Tipo Description
Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Retornos

Corpo
AdminFlowWithConnectionReferences

Definições

ResourceArray[ApiWithoutConnectionParameters]

Nome Caminho Tipo Description
value
 value array of ApiWithoutConnectionParameters

ResourceArray[ConnectionWithoutConnectionParameters]

Nome Caminho Tipo Description
value
 value array of ConnectionWithoutConnectionParameters

ResourceArray[Environment]

Nome Caminho Tipo Description
value
 value array of Environment

ResourceArray[AdminFlow]

Nome Caminho Tipo Description
value
 value array of AdminFlow

ResourceArray[AdminFlowWithoutDefinition]

Nome Caminho Tipo Description
value
 value array of AdminFlowWithoutDefinition

ResourceArray[FlowPermission]

Nome Caminho Tipo Description
value
 value array of FlowPermission

FlowPermission

Nome Caminho Tipo Description
Nome da permissão
 name string
propriedades
 properties PermissionProperties

PermissionProperties

Nome Caminho Tipo Description
nome_do_papel
 roleName string
entidade de segurança
 principal Principal

Entidade de segurança

Nome Caminho Tipo Description
ID do objeto
 id string
Nome de Exibição
 displayName string
Email
 email string
Tipo
 type string
ID do Inquilino
 tenantId string
Nome Principal
 userPrincipalName string
Foto da Miniatura do Proprietário
 thumbnailPhoto string

Flow

Nome Caminho Tipo Description
Nome do fluxo
 name string
propriedades
 properties FlowProperties

Propriedades de fluxo

Nome Caminho Tipo Description
Nome de Exibição do Fluxo
 displayName string
Estado do fluxo
 state string
connectionReferences
 connectionReferences ConnectionReferencesDictionary
Tempo de Criação de Fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri do Gatilho de Fluxo
 flowTriggerUri string
Status da instalação do fluxo
 installationStatus string

FlowListCallbackUrlResponse

Nome Caminho Tipo Description
URL de retorno de chamada
 response.value string

FlowWithConnectionReferences

Nome Caminho Tipo Description
Nome do fluxo
 name string
propriedades
 properties FlowWithConnectionReferencesProperties

FlowWithConnectionReferencesProperties

Nome Caminho Tipo Description
Nome de Exibição do Fluxo
 displayName string
Estado do fluxo
 state string
connectionReferences
 connectionReferences ConnectionReferencesArray
Tempo de Criação de Fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri do Gatilho de Fluxo
 flowTriggerUri string
Status da instalação do fluxo
 installationStatus string
criador
 creator UserIdentity
definitionSummary
 definitionSummary DefinitionSummary

AdminFlow

Nome Caminho Tipo Description
Nome do fluxo
 name string
propriedades
 properties AdminFlowProperties

AdminFlowWithoutDefinition

Nome Caminho Tipo Description
Nome do fluxo
 name string
propriedades
 properties AdminFlowWithoutDefinitionProperties

AdminFlowProperties

Nome Caminho Tipo Description
Nome de Exibição do Fluxo
 displayName string
Estado do fluxo
 state string
connectionReferences
 connectionReferences ConnectionReferencesDictionary
Tempo de Criação de Fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri do Gatilho de Fluxo
 flowTriggerUri string
Status da instalação do fluxo
 installationStatus string
criador
 creator UserIdentity
definitionSummary
 definitionSummary DefinitionSummary
estimatedSuspensionData
 estimatedSuspensionData EstimatedSuspensionData

AdminFlowWithoutDefinitionProperties

Nome Caminho Tipo Description
Nome de Exibição do Fluxo
 displayName string
Estado do fluxo
 state string
Tempo de Criação de Fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time

AdminFlowWithConnectionReferences

Nome Caminho Tipo Description
Nome do fluxo
 name string
propriedades
 properties AdminFlowWithConnectionReferencesProperties

AdminFlowWithConnectionReferencesProperties

Nome Caminho Tipo Description
Nome de Exibição do Fluxo
 displayName string
Estado do fluxo
 state string
connectionReferences
 connectionReferences ConnectionReferencesArray
Tempo de Criação de Fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri do Gatilho de Fluxo
 flowTriggerUri string
Status da instalação do fluxo
 installationStatus string
criador
 creator UserIdentity
definitionSummary
 definitionSummary DefinitionSummary

EstimatedSuspensionData

Nome Caminho Tipo Description
Motivo estimado da suspensão do fluxo
 reason string
Tempo de suspensão estimado do fluxo
 time date-time
Se o fluxo for o plano de aplicativo de energia excluído ou não
 powerAppPlanExcluded boolean

DefinitionSummary

Nome Caminho Tipo Description
gatilhos
 triggers array of object
Tipo de gatilho de fluxo
 triggers.type string
Tipo de gatilho de fluxo
 triggers.kind string
Ações
 actions array of object
Tipo de ação
 actions.type string
ID da operação swagger
 actions.swaggerOperationId string
Nome da API de ação
 actions.api.name string
ID da API de ação
 actions.api.id string
Tipo de API de ação
 actions.api.type string

UserIdentity

Nome Caminho Tipo Description
ID do locatário do criador
 tenantId string
ID de objeto do criador
 objectId string
ID do usuário do criador
 userId string
Tipo de usuário do criador
 userType string

Ambiente

Nome Caminho Tipo Description
Nome do ambiente
 name string
Localização do ambiente
 location string
propriedades
 properties EnvironmentProperties

Propriedades do ambiente

Nome Caminho Tipo Description
Nome de Exibição do Ambiente
 displayName string
Descrição do ambiente
 description string
Tempo de Criação do Ambiente
 createdTime date-time
Hora da Última Modificação do Ambiente
 lastModifiedTime date-time
Estado de provisionamento de ambiente
 provisioningState string
Tipo de criação de ambiente
 creationType string
SKU do ambiente
 environmentSku string
Tipo de ambiente
 environmentType string
É o ambiente padrão
 isDefault boolean

ConnectionReferencesArray

Nome Caminho Tipo Description
Itens
 ConnectionReference

ConnectionReferencesDictionary

ConnectionReference

Nome Caminho Tipo Description
Nome da conexão
 connectionName string
Nome de exibição da conexão
 displayName string
ID do conector
 id string
Conexão inserida ou invocadora
 source string
Nome lógico da referência de conexão
 connectionReferenceLogicalName string
apiDefinição
 apiDefinition ApiWithoutConnectionParameters

ApiWithoutConnectionParameters

Nome Caminho Tipo Description
Nome do Conector
 name string
propriedades
 properties ApiPropertiesWithoutConnectionParameters

ApiPropertiesWithoutConnectionParameters

Nome Caminho Tipo Description
Nome de exibição do conector
 displayName string
Tempo de Criação da Conexão
 createdTime date-time
URL do Runtime do Conector
 primaryRuntimeUrl string
URL do ícone do conector
 iconUri string
Conector é a API Personalizada
 isCustomApi boolean
Camada do conector
 tier string

ConnectionWithoutConnectionParameters

Nome Caminho Tipo Description
Nome da conexão
 name string
propriedades
 properties ConnectionPropertiesWithoutConnectionParameters

ConnectionPropertiesWithoutConnectionParameters

Nome Caminho Tipo Description
Nome de exibição do conector
 displayName string
ID do conector
 apiId string
Tempo de Criação da Conexão
 createdTime date-time
Hora da Última Modificação da Conexão
 lastModifiedTime date-time