Partilhar via

Gestão do Power Automate

O conector Power Automate Management permite a interação com o serviço Power Automate Management. 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 é suportada apenas para ações administrativas.

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

Serviço Class Regiões
Estúdio Copiloto Standard Todas as regiões do Power Automate
Aplicações Power Standard Todas as regiões do Power Apps
Automatize o poder 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
Editora Microsoft
Sítio Web https://make.powerautomate.com/

Limites Gerais

Nome Valor
Ligações por conta 50

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Autenticação de certificado de cliente Forneça credenciais do Microsoft Entra ID usando certificado PFX e senha Todas as regiões Não compartilhável
Microsoft Entra ID Integrado Use o Microsoft Entra ID para acessar este serviço. Todas as regiões Não compartilhável
Padrão [DEPRECATED] Esta 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 de cliente

ID de autenticação: CertOauth

Aplicável: Todas as regiões

Forneça credenciais do Microsoft Entra ID usando certificado PFX e senha

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Tenant cadeia (de caracteres) Verdade
ID do Cliente cadeia (de caracteres) A ID do cliente do aplicativo Microsoft Entra ID
Segredo do certificado do cliente certificado do cliente O segredo do certificado do cliente permitido por este aplicativo Verdade

ID do Microsoft Entra Integrado

ID de autenticação: firstParty

Aplicável: Todas as regiões

Use o Microsoft Entra ID para acessar este serviço.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta 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.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 5 60 segundos
Solicitações não obtidas por conexão 300 3600 segundos

Ações

Ativar o fluxo

Inicie o fluxo dado em um ambiente.
Cancelar execução de fluxo

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

Crie uma conexão para o conector fornecido em um ambiente.
Criar fluxo

Criar fluxo
Desligue o fluxo

Pare o fluxo dado em um ambiente.
Excluir fluxo

Excluir o fluxo dado em um ambiente
Fluxo de atualização

Atualize o fluxo dado em um ambiente.
Fluxo de lista Run-Only usuários

Liste todos os usuários executados somente do fluxo determinado em um ambiente.
Listar conectores

Lista todos os conectores disponíveis no ambiente fornecido. Esta lista incluirá conectores personalizados, bem como os conectores integrados.
Listar fluxos como administrador (v2)

Liste todos os fluxos no ambiente ao qual você tem acesso de administrador. Esta 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 obter 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 criados no ambiente determinado.
Listar Minhas Conexões

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

Liste todos os proprietários do fluxo dado em um ambiente.
Listar URL de retorno de chamada

Liste a URL de retorno de chamada para o fluxo determinado em um ambiente.
Modificar proprietários de fluxo

Modificar os proprietários do fluxo dado 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 de execução do fluxo fornecido em um ambiente.
Obter conector

Obtenha o conector fornecido em um ambiente.
Obter fluxo

Obtenha o fluxo dado em um ambiente.
Obter o Flow como administrador

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

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

Restaure o fluxo de exclusão suave fornecido em um ambiente ao qual você tenha acesso de administrador.

Ativar o fluxo

ID da Operação:
StartFlow

Inicie o fluxo dado em um ambiente.

Parâmetros

Name Chave Necessário Tipo Description
Meio 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

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo
ID de execução
 runId True string

A ID do fluxo executado para reenviar.

Criar conexão

ID da Operação:
CreateConnection

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

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Connector
 apiName True string

Selecionar conector
ligação
 connection dynamic

Connection

Devoluções

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

Criar fluxo

ID da Operação:
CreateFlow

Criar fluxo

Parâmetros

Name Chave Necessário Tipo Description
Meio 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 Ligação
 connectionName string
Nome de exibição da conexão
 displayName string
ID do conector
 id True string
Conexão incorporada 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 tempo de execução do conector
 primaryRuntimeUrl string
URL do ícone do conector
 iconUri string
O conector é Custom Api
 isCustomApi boolean
Camada do conector
 tier string
Tempo criado pelo fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri de gatilho de fluxo
 flowTriggerUri string
Status da instalação de fluxo
 installationStatus string
ID do locatário do criador
 tenantId True string
ID de objeto do criador
 objectId string
ID de utilizador 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

Devoluções

Body
Flow

Desligue o fluxo

ID da Operação:
StopFlow

Pare o fluxo dado em um ambiente.

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Excluir fluxo

ID da Operação:
DeleteFlow

Excluir o fluxo dado em um ambiente

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Fluxo de atualização

ID da Operação:
UpdateFlow

Atualize o fluxo dado em um ambiente.

Parâmetros

Name Chave Necessário Tipo Description
Meio 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 Ligação
 connectionName string
Nome de exibição da conexão
 displayName string
ID do conector
 id True string
Conexão incorporada 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 tempo de execução do conector
 primaryRuntimeUrl string
URL do ícone do conector
 iconUri string
O conector é Custom Api
 isCustomApi boolean
Camada do conector
 tier string
Tempo criado pelo fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri de gatilho de fluxo
 flowTriggerUri string
Status da instalação de fluxo
 installationStatus string
ID do locatário do criador
 tenantId True string
ID de objeto do criador
 objectId string
ID de utilizador 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

Devoluções

Body
Flow

Fluxo de lista Run-Only usuários

ID da Operação:
ListFlowUsers

Liste todos os usuários executados somente do fluxo determinado em um ambiente.

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Devoluções

Body
ResourceArray[FlowPermission]

Listar conectores

ID da Operação:
ListApis

Lista todos os conectores disponíveis no ambiente fornecido. Esta lista incluirá conectores personalizados, bem como os conectores integrados.

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente

Devoluções

Body
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. Esta 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 obter metadados adicionais e a definição de fluxo, faça uma chamada subsequente para a ação Obter fluxos como administrador.

Parâmetros

Name Chave Necessário Tipo Description
Meio 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 de exclusão suave.

Devoluções

Body
ResourceArray[AdminFlowWithoutDefinition]

Listar Meus Ambientes

ID da Operação:
ListUserEnvironments

Liste os ambientes aos quais você tem acesso.

Devoluções

Body
ResourceArray[Environment]

Listar Meus Fluxos

ID da Operação:
ListMyFlows

Liste todos os fluxos criados no ambiente determinado.

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente

Devoluções

Body
ResourceArray[AdminFlow]

Listar Minhas Conexões

ID da Operação:
ListConnections

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

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente

Devoluções

Body
ResourceArray[ConnectionWithoutConnectionParameters]

Listar proprietários de fluxo

ID da Operação:
ListFlowOwners

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

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Devoluções

Body
ResourceArray[FlowPermission]

Listar URL de retorno de chamada

ID da Operação:
ListCallbackUrl

Liste a URL de retorno de chamada para o fluxo determinado em um ambiente.

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Devoluções

Body
FlowListCallbackUrlResponse

Modificar proprietários de fluxo

ID da Operação:
ModifyFlowOwners

Modificar os proprietários do fluxo dado em um ambiente.

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo
Adicionar ID do objeto do usuário
 id True string
Adicionar tipo de usuário
 type True string
Remover ID do objeto do 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

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo
Adicionar ID do objeto do usuário
 id True string
Adicionar tipo de usuário
 type True string
Remover ID do objeto do 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 de execução do fluxo fornecido em um ambiente.

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

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

Obter conector

ID da Operação:
GetApi

Obtenha o conector fornecido em um ambiente.

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Connector
 apiName True string

Selecionar conector

Devoluções

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

Obter fluxo

ID da Operação:
GetFlow

Obtenha o fluxo dado em um ambiente.

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Devoluções

Body
FlowWithConnectionReferences

Obter o Flow como administrador

ID da Operação:
AdminGetFlow

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

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo
Incluir definição de fluxo
 includeFlowDefinition boolean

Incluir ou não a definição de fluxo.

Devoluções

Body
AdminFlowWithConnectionReferences

Reenviar fluxo

ID da Operação:
ResubmitFlow

Reenvie a execução de fluxo dada em um ambiente.

Parâmetros

Name Chave Necessário Tipo Description
Meio 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.
ID de execução
 runId True string

A ID do fluxo executado para reenviar.

Restaurar fluxo excluído como administrador

ID da Operação:
AdminRestoreFlow

Restaure o fluxo de exclusão suave fornecido em um ambiente ao qual você tenha acesso de administrador.

Parâmetros

Name Chave Necessário Tipo Description
Meio Ambiente
 environmentName True string

Selecionar ambiente
Flow
 flowName True string

Selecionar fluxo

Devoluções

Body
AdminFlowWithConnectionReferences

Definições

ResourceArray[ApiWithoutConnectionParameters]

Name Caminho Tipo Description
valor
 value array of ApiWithoutConnectionParameters

ResourceArray[ConnectionWithoutConnectionParameters]

Name Caminho Tipo Description
valor
 value array of ConnectionWithoutConnectionParameters

ResourceArray[Ambiente]

Name Caminho Tipo Description
valor
 value array of Environment

ResourceArray[AdminFlow]

Name Caminho Tipo Description
valor
 value array of AdminFlow

ResourceArray[AdminFlowWithoutDefinition]

Name Caminho Tipo Description
valor
 value array of AdminFlowWithoutDefinition

ResourceArray[FlowPermission]

Name Caminho Tipo Description
valor
 value array of FlowPermission

FlowPermission

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

PermissionProperties

Name Caminho Tipo Description
roleName
 roleName string
principal
 principal Principal

Diretor

Name Caminho Tipo Description
ID do objeto
 id string
Nome de exibição
 displayName string
Email
 email string
Tipo
 type string
ID de Inquilino
 tenantId string
Nome principal
 userPrincipalName string
Foto em miniatura do proprietário
 thumbnailPhoto string

Flow

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

FlowProperties

Name Caminho Tipo Description
Nome de exibição do fluxo
 displayName string
Estado do fluxo
 state string
connectionReferências
 connectionReferences ConnectionReferencesDictionary
Tempo criado pelo fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri de gatilho de fluxo
 flowTriggerUri string
Status da instalação de fluxo
 installationStatus string

FlowListCallbackUrlResponse

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

FlowWithConnectionReferences

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

FlowWithConnectionReferencesProperties

Name Caminho Tipo Description
Nome de exibição do fluxo
 displayName string
Estado do fluxo
 state string
connectionReferências
 connectionReferences ConnectionReferencesArray
Tempo criado pelo fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri de gatilho de fluxo
 flowTriggerUri string
Status da instalação de fluxo
 installationStatus string
criador
 creator UserIdentity
definiçãoResumo
 definitionSummary DefinitionSummary

AdminFlow

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

AdminFlowWithoutDefinition

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

AdminFlowProperties

Name Caminho Tipo Description
Nome de exibição do fluxo
 displayName string
Estado do fluxo
 state string
connectionReferências
 connectionReferences ConnectionReferencesDictionary
Tempo criado pelo fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri de gatilho de fluxo
 flowTriggerUri string
Status da instalação de fluxo
 installationStatus string
criador
 creator UserIdentity
definiçãoResumo
 definitionSummary DefinitionSummary
estimadoSuspensãoDados
 estimatedSuspensionData EstimatedSuspensionData

AdminFlowWithoutDefinitionProperties

Name Caminho Tipo Description
Nome de exibição do fluxo
 displayName string
Estado do fluxo
 state string
Tempo criado pelo fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time

AdminFlowWithConnectionReferences

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

AdminFlowWithConnectionReferencesProperties

Name Caminho Tipo Description
Nome de exibição do fluxo
 displayName string
Estado do fluxo
 state string
connectionReferências
 connectionReferences ConnectionReferencesArray
Tempo criado pelo fluxo
 createdTime date-time
Tempo modificado do fluxo
 lastModifiedTime date-time
Nome do modelo de fluxo
 templateName string
Uri de gatilho de fluxo
 flowTriggerUri string
Status da instalação de fluxo
 installationStatus string
criador
 creator UserIdentity
definiçãoResumo
 definitionSummary DefinitionSummary

EstimadoSuspensãoDados

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

DefiniçãoResumo

Name Caminho Tipo Description
triggers
 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

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

Meio Ambiente

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

AmbientePropriedades

Name Caminho Tipo Description
Nome de exibição do ambiente
 displayName string
Descrição do ambiente
 description string
Tempo criado pelo ambiente
 createdTime date-time
Hora da última modificação do ambiente
 lastModifiedTime date-time
Estado de provisionamento do ambiente
 provisioningState string
Tipo de criação de ambiente
 creationType string
Ambiente Sku
 environmentSku string
Tipo de ambiente
 environmentType string
É ambiente padrão
 isDefault boolean

ConnectionReferencesArray

Name Caminho Tipo Description
Itens
 ConnectionReference

ConnectionReferencesDictionary

ConnectionReference

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

ApiWithoutConnectionParameters

Name Caminho Tipo Description
Nome do conector
 name string
propriedades
 properties ApiPropertiesWithoutConnectionParameters

ApiPropertiesWithoutConnectionParameters

Name Caminho Tipo Description
Nome de exibição do conector
 displayName string
Tempo de criação da conexão
 createdTime date-time
URL do tempo de execução do conector
 primaryRuntimeUrl string
URL do ícone do conector
 iconUri string
O conector é Custom Api
 isCustomApi boolean
Camada do conector
 tier string

ConnectionWithoutConnectionParameters

Name Caminho Tipo Description
Nome da Ligação
 name string
propriedades
 properties ConnectionPropertiesWithoutConnectionParameters

ConnectionPropertiesWithoutConnectionParameters

Name 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