Compartir a través de


Administración de Power Automate

El conector de administración de Power Automate permite la interacción con el servicio de administración de Power Automate. Por ejemplo: crear, editar y actualizar flujos. Los administradores que quieran realizar operaciones con privilegios de administrador deben llamar a acciones con el sufijo "as Admin". Solo se admite la autenticación de la entidad de servicio para acciones administrativas.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Estándar Todas las regiones de Power Automate
Power Apps Estándar Todas las regiones de Power Apps
Power Automate Estándar Todas las regiones de Power Automate
Contacto
Nombre Microsoft
URL Soporte técnico de Microsoft Power Automate
Soporte técnico de Microsoft Power Apps
Metadatos del conector
Publicador Microsoft
Sitio web https://make.powerautomate.com/

Límites generales

Nombre Importancia
Conexiones por cuenta 50

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Autenticación de certificado de cliente Proporcionar credenciales de Id. de Entra de Microsoft mediante el certificado PFX y la contraseña Todas las regiones No se puede compartir
Microsoft Entra ID: integrado Use microsoft Entra ID para acceder a este servicio. Todas las regiones No se puede compartir
Valor predeterminado [EN DESUSO] Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. Todas las regiones No se puede compartir

Autenticación mediante certificados de cliente

Identificador de autenticación: CertOauth

Aplicable: Todas las regiones

Proporcionar credenciales de Id. de Entra de Microsoft mediante el certificado PFX y la contraseña

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Inquilino cuerda / cadena Cierto
Id. de cliente cuerda / cadena El identificador de cliente de para la aplicación microsoft Entra ID
Secreto de certificado de cliente Certificado de cliente Secreto de certificado de cliente permitido por esta aplicación Cierto

Microsoft Entra ID integrado

Identificador de autenticación: firstParty

Aplicable: Todas las regiones

Use microsoft Entra ID para acceder a este servicio.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Valor predeterminado [EN DESUSO]

Aplicable: Todas las regiones

Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 5 60 segundos
Solicitudes no get por conexión 300 3600 segundos

Acciones

Activar flujo

Inicie el flujo dado en un entorno.

Cancelar ejecución de flujo

Cancelar una ejecución de flujo.

Crear conexión

Cree una conexión para el conector determinado en un entorno.

Crear flujo

Crear flujo

Desactivar el flujo

Detenga el flujo especificado en un entorno.

Eliminar flujo

Eliminación del flujo dado en un entorno

Enumerar conectores

Enumera todos los conectores disponibles en el entorno determinado. Esta lista incluirá conectores personalizados, así como los conectores integrados.

Enumerar flujos como administrador (V2)

Enumere todos los flujos del entorno determinado al que tiene acceso de administrador. Esta acción V2 es una acción de mayor rendimiento que devuelve solo la información de identificación sobre el flujo. No se devuelve la definición del flujo y gran parte de los metadatos. Para metadatos adicionales y la definición del flujo, realice una llamada posterior a la acción Obtener flujos como administrador.

Enumerar la dirección URL de devolución de llamada

Enumerar la dirección URL de devolución de llamada del flujo especificado en un entorno.

Enumerar mis conexiones

Enumera toda la conexión disponible en el entorno determinado.

Enumerar mis entornos

Enumere los entornos a los que tiene acceso.

Enumerar mis flujos

Enumere todos los flujos que creó en el entorno determinado.

Enumerar propietarios de flujo

Enumere todos los propietarios del flujo especificado en un entorno.

Enumerar usuarios de Run-Only Flow

Enumere todos los usuarios de ejecución solo del flujo especificado en un entorno.

Flujo de actualización

Actualice el flujo especificado en un entorno.

Modificar propietarios de flujo

Modifique los propietarios del flujo especificado en un entorno.

Modificar propietarios de flujo como administrador

Modifique los propietarios del flujo especificado creado en un entorno al que tiene acceso de administrador.

Modificar usuarios de Run-Only

Modifique los usuarios de solo ejecución del flujo especificado en un entorno.

Obtención del conector

Obtenga el conector determinado en un entorno.

Obtener flujo

Obtenga el flujo especificado en un entorno.

Obtener flujo como administrador

Obtenga el flujo dado desde un entorno al que tiene acceso de administrador.

Restaurar flujo eliminado como administrador

Restaure el flujo eliminado temporalmente dado en un entorno al que tiene acceso de administrador.

Volver a enviar el flujo

Vuelva a enviar la ejecución del flujo determinado en un entorno.

Activar flujo

Inicie el flujo dado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Cancelar ejecución de flujo

Cancelar una ejecución de flujo.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Id. de ejecución
runId True string

Identificador de la ejecución del flujo que se va a volver a enviar.

Crear conexión

Cree una conexión para el conector determinado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Conector
apiName True string

Selección del conector

connection
connection dynamic

Conexión

Devoluciones

Las salidas de esta operación son dinámicas.

Crear flujo

Crear flujo

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Nombre del flujo
name string
Nombre para mostrar del flujo
displayName True string
Estado de flujo
state True string
Nombre de la conexión
connectionName string
Nombre para mostrar de la conexión
displayName string
Identificador del conector
id True string
Conexión insertada o invocador
source string
Nombre lógico de la referencia de conexión
connectionReferenceLogicalName string
Nombre del conector
name string
Nombre para mostrar del conector
displayName string
Hora de creación de conexión
createdTime date-time
Dirección URL del entorno de ejecución del conector
primaryRuntimeUrl string
Dirección URL del icono del conector
iconUri string
Connector es Custom Api
isCustomApi boolean
Nivel de conector
tier string
Tiempo de creación del flujo
createdTime date-time
Tiempo de modificación del flujo
lastModifiedTime date-time
Nombre de plantilla de flujo
templateName string
Uri del desencadenador de flujo
flowTriggerUri string
Estado de instalación de flujo
installationStatus string
Id. de inquilino de Creator
tenantId True string
Identificador de objeto de Creator
objectId string
Id. de usuario de Creator
userId True string
Tipo de usuario creator
userType True string
Tipo de desencadenador de flujo
type string
Tipo de desencadenador de flujo
kind string
Tipo de acción
type string
Identificador de operación de Swagger
swaggerOperationId string
Nombre de api de acción
name string
Id. de api de acción
id string
Tipo de API de acción
type string

Devoluciones

Body
Flow

Desactivar el flujo

Detenga el flujo especificado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Eliminar flujo

Eliminación del flujo dado en un entorno

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Enumerar conectores

Enumera todos los conectores disponibles en el entorno determinado. Esta lista incluirá conectores personalizados, así como los conectores integrados.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Devoluciones

Enumerar flujos como administrador (V2)

Enumere todos los flujos del entorno determinado al que tiene acceso de administrador. Esta acción V2 es una acción de mayor rendimiento que devuelve solo la información de identificación sobre el flujo. No se devuelve la definición del flujo y gran parte de los metadatos. Para metadatos adicionales y la definición del flujo, realice una llamada posterior a la acción Obtener flujos como administrador.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Recuento superior
$top integer

Recuento superior

Expandir información de suspensión
expandSuspensionInfo boolean

Expande la información de suspensión

Incluir flujos de Soft-Deleted
includeSoftDeletedFlows boolean

Si se van a incluir o no flujos eliminados temporalmente.

Devoluciones

Enumerar la dirección URL de devolución de llamada

Enumerar la dirección URL de devolución de llamada del flujo especificado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Devoluciones

Enumerar mis conexiones

Enumera toda la conexión disponible en el entorno determinado.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Devoluciones

Enumerar mis entornos

Enumere los entornos a los que tiene acceso.

Devoluciones

Enumerar mis flujos

Enumere todos los flujos que creó en el entorno determinado.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Devoluciones

Enumerar propietarios de flujo

Enumere todos los propietarios del flujo especificado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Devoluciones

Enumerar usuarios de Run-Only Flow

Enumere todos los usuarios de ejecución solo del flujo especificado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Devoluciones

Flujo de actualización

Actualice el flujo especificado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Nombre del flujo
name string
Nombre para mostrar del flujo
displayName True string
Estado de flujo
state True string
Nombre de la conexión
connectionName string
Nombre para mostrar de la conexión
displayName string
Identificador del conector
id True string
Conexión insertada o invocador
source string
Nombre lógico de la referencia de conexión
connectionReferenceLogicalName string
Nombre del conector
name string
Nombre para mostrar del conector
displayName string
Hora de creación de conexión
createdTime date-time
Dirección URL del entorno de ejecución del conector
primaryRuntimeUrl string
Dirección URL del icono del conector
iconUri string
Connector es Custom Api
isCustomApi boolean
Nivel de conector
tier string
Tiempo de creación del flujo
createdTime date-time
Tiempo de modificación del flujo
lastModifiedTime date-time
Nombre de plantilla de flujo
templateName string
Uri del desencadenador de flujo
flowTriggerUri string
Estado de instalación de flujo
installationStatus string
Id. de inquilino de Creator
tenantId True string
Identificador de objeto de Creator
objectId string
Id. de usuario de Creator
userId True string
Tipo de usuario creator
userType True string
Tipo de desencadenador de flujo
type string
Tipo de desencadenador de flujo
kind string
Tipo de acción
type string
Identificador de operación de Swagger
swaggerOperationId string
Nombre de api de acción
name string
Id. de api de acción
id string
Tipo de API de acción
type string

Devoluciones

Body
Flow

Modificar propietarios de flujo

Modifique los propietarios del flujo especificado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Agregar identificador de objeto de usuario
id True string
Agregar tipo de usuario
type True string
Quitar identificador de objeto de usuario
id True string
Quitar tipo de usuario
type True string

Modificar propietarios de flujo como administrador

Modifique los propietarios del flujo especificado creado en un entorno al que tiene acceso de administrador.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Agregar identificador de objeto de usuario
id True string
Agregar tipo de usuario
type True string
Quitar identificador de objeto de usuario
id True string
Quitar tipo de usuario
type True string

Modificar usuarios de Run-Only

Modifique los usuarios de solo ejecución del flujo especificado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Agregar identificador de objeto de usuario
id True string
Agregar tipo de usuario
type True string
Quitar identificador de objeto de usuario
id True string
Quitar tipo de usuario
type True string

Obtención del conector

Obtenga el conector determinado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Conector
apiName True string

Selección del conector

Devoluciones

Las salidas de esta operación son dinámicas.

Obtener flujo

Obtenga el flujo especificado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Devoluciones

Obtener flujo como administrador

Obtenga el flujo dado desde un entorno al que tiene acceso de administrador.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Incluir definición de flujo
includeFlowDefinition boolean

Si se va a incluir o no la definición de flujo.

Devoluciones

Restaurar flujo eliminado como administrador

Restaure el flujo eliminado temporalmente dado en un entorno al que tiene acceso de administrador.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Devoluciones

Volver a enviar el flujo

Vuelva a enviar la ejecución del flujo determinado en un entorno.

Parámetros

Nombre Clave Requerido Tipo Description
Medio ambiente
environmentName True string

Seleccionar entorno

Flujo
flowName True string

Seleccionar flujo

Nombre del desencadenador
triggerName True string

Nombre del desencadenador de flujo que se va a volver a enviar.

Id. de ejecución
runId True string

Identificador de la ejecución del flujo que se va a volver a enviar.

Definiciones

ResourceArray[ApiWithoutConnectionParameters]

Nombre Ruta de acceso Tipo Description
value
value array of ApiWithoutConnectionParameters

ResourceArray[ConnectionWithoutConnectionParameters]

Nombre Ruta de acceso Tipo Description
value
value array of ConnectionWithoutConnectionParameters

ResourceArray[Environment]

Nombre Ruta de acceso Tipo Description
value
value array of Environment

ResourceArray[AdminFlow]

Nombre Ruta de acceso Tipo Description
value
value array of AdminFlow

ResourceArray[AdminFlowWithoutDefinition]

Nombre Ruta de acceso Tipo Description
value
value array of AdminFlowWithoutDefinition

ResourceArray[FlowPermission]

Nombre Ruta de acceso Tipo Description
value
value array of FlowPermission

FlowPermission

Nombre Ruta de acceso Tipo Description
Nombre del permiso
name string
Propiedades
properties PermissionProperties

PermissionProperties

Nombre Ruta de acceso Tipo Description
roleName
roleName string
principal
principal Principal

Entidad de seguridad

Nombre Ruta de acceso Tipo Description
Id. de objeto
id string
Nombre de pantalla
displayName string
Correo Electrónico
email string
Tipo
type string
Identificador de inquilino
tenantId string
Nombre principal
userPrincipalName string
Foto de miniatura del propietario
thumbnailPhoto string

Flujo

Nombre Ruta de acceso Tipo Description
Nombre del flujo
name string
Propiedades
properties FlowProperties

FlowProperties (Propiedades de flujo)

Nombre Ruta de acceso Tipo Description
Nombre para mostrar del flujo
displayName string
Estado de flujo
state string
connectionReferences
connectionReferences ConnectionReferencesDictionary
Tiempo de creación del flujo
createdTime date-time
Tiempo de modificación del flujo
lastModifiedTime date-time
Nombre de plantilla de flujo
templateName string
Uri del desencadenador de flujo
flowTriggerUri string
Estado de instalación de flujo
installationStatus string

FlowListCallbackUrlResponse

Nombre Ruta de acceso Tipo Description
Dirección URL de devolución de llamadas
response.value string

FlowWithConnectionReferences

Nombre Ruta de acceso Tipo Description
Nombre del flujo
name string
Propiedades
properties FlowWithConnectionReferencesProperties

FlowWithConnectionReferencesProperties

Nombre Ruta de acceso Tipo Description
Nombre para mostrar del flujo
displayName string
Estado de flujo
state string
connectionReferences
connectionReferences ConnectionReferencesArray
Tiempo de creación del flujo
createdTime date-time
Tiempo de modificación del flujo
lastModifiedTime date-time
Nombre de plantilla de flujo
templateName string
Uri del desencadenador de flujo
flowTriggerUri string
Estado de instalación de flujo
installationStatus string
creador
creator UserIdentity
definitionSummary
definitionSummary DefinitionSummary

AdminFlow

Nombre Ruta de acceso Tipo Description
Nombre del flujo
name string
Propiedades
properties AdminFlowProperties

AdminFlowWithoutDefinition

Nombre Ruta de acceso Tipo Description
Nombre del flujo
name string
Propiedades
properties AdminFlowWithoutDefinitionProperties

AdminFlowProperties

Nombre Ruta de acceso Tipo Description
Nombre para mostrar del flujo
displayName string
Estado de flujo
state string
connectionReferences
connectionReferences ConnectionReferencesDictionary
Tiempo de creación del flujo
createdTime date-time
Tiempo de modificación del flujo
lastModifiedTime date-time
Nombre de plantilla de flujo
templateName string
Uri del desencadenador de flujo
flowTriggerUri string
Estado de instalación de flujo
installationStatus string
creador
creator UserIdentity
definitionSummary
definitionSummary DefinitionSummary
estimatedSuspensionData
estimatedSuspensionData EstimatedSuspensionData

AdminFlowWithoutDefinitionProperties

Nombre Ruta de acceso Tipo Description
Nombre para mostrar del flujo
displayName string
Estado de flujo
state string
Tiempo de creación del flujo
createdTime date-time
Tiempo de modificación del flujo
lastModifiedTime date-time

AdminFlowWithConnectionReferences

Nombre Ruta de acceso Tipo Description
Nombre del flujo
name string
Propiedades
properties AdminFlowWithConnectionReferencesProperties

AdminFlowWithConnectionReferencesProperties

Nombre Ruta de acceso Tipo Description
Nombre para mostrar del flujo
displayName string
Estado de flujo
state string
connectionReferences
connectionReferences ConnectionReferencesArray
Tiempo de creación del flujo
createdTime date-time
Tiempo de modificación del flujo
lastModifiedTime date-time
Nombre de plantilla de flujo
templateName string
Uri del desencadenador de flujo
flowTriggerUri string
Estado de instalación de flujo
installationStatus string
creador
creator UserIdentity
definitionSummary
definitionSummary DefinitionSummary

EstimatedSuspensionData

Nombre Ruta de acceso Tipo Description
Motivo de suspensión estimado del flujo
reason string
Tiempo de suspensión estimado del flujo
time date-time
Si el flujo está excluido o no del plan de power app
powerAppPlanExcluded boolean

DefinitionSummary

Nombre Ruta de acceso Tipo Description
Desencadenadores
triggers array of object
Tipo de desencadenador de flujo
triggers.type string
Tipo de desencadenador de flujo
triggers.kind string
Acciones
actions array of object
Tipo de acción
actions.type string
Identificador de operación de Swagger
actions.swaggerOperationId string
Nombre de api de acción
actions.api.name string
Id. de api de acción
actions.api.id string
Tipo de API de acción
actions.api.type string

UserIdentity

Nombre Ruta de acceso Tipo Description
Id. de inquilino de Creator
tenantId string
Identificador de objeto de Creator
objectId string
Id. de usuario de Creator
userId string
Tipo de usuario creator
userType string

Medio ambiente

Nombre Ruta de acceso Tipo Description
Nombre del entorno
name string
Ubicación del entorno
location string
Propiedades
properties EnvironmentProperties

EnvironmentProperties

Nombre Ruta de acceso Tipo Description
Nombre para mostrar del entorno
displayName string
Descripción del entorno
description string
Hora de creación del entorno
createdTime date-time
Hora de última modificación del entorno
lastModifiedTime date-time
Estado de aprovisionamiento del entorno
provisioningState string
Tipo de creación del entorno
creationType string
SKU de entorno
environmentSku string
Tipo de entorno
environmentType string
Es el entorno predeterminado
isDefault boolean

ConnectionReferencesArray

Nombre Ruta de acceso Tipo Description
Productos
ConnectionReference

ConnectionReferencesDictionary

ConnectionReference

Nombre Ruta de acceso Tipo Description
Nombre de la conexión
connectionName string
Nombre para mostrar de la conexión
displayName string
Identificador del conector
id string
Conexión insertada o invocador
source string
Nombre lógico de la referencia de conexión
connectionReferenceLogicalName string
apiDefinition
apiDefinition ApiWithoutConnectionParameters

ApiWithoutConnectionParameters

Nombre Ruta de acceso Tipo Description
Nombre del conector
name string
Propiedades
properties ApiPropertiesWithoutConnectionParameters

ApiPropertiesWithoutConnectionParameters

Nombre Ruta de acceso Tipo Description
Nombre para mostrar del conector
displayName string
Hora de creación de conexión
createdTime date-time
Dirección URL del entorno de ejecución del conector
primaryRuntimeUrl string
Dirección URL del icono del conector
iconUri string
Connector es Custom Api
isCustomApi boolean
Nivel de conector
tier string

ConnectionWithoutConnectionParameters

Nombre Ruta de acceso Tipo Description
Nombre de la conexión
name string
Propiedades
properties ConnectionPropertiesWithoutConnectionParameters

ConnectionPropertiesWithoutConnectionParameters

Nombre Ruta de acceso Tipo Description
Nombre para mostrar del conector
displayName string
Identificador del conector
apiId string
Hora de creación de conexión
createdTime date-time
Hora de última modificación de conexión
lastModifiedTime date-time