Condividi tramite


Gestione di Power Automate

Il connettore di gestione di Power Automate consente l'interazione con il servizio di gestione di Power Automate. Ad esempio: creazione, modifica e aggiornamento dei flussi. Gli amministratori che vogliono eseguire operazioni con privilegi di amministratore devono chiamare azioni con il suffisso 'as Admin'. L'autenticazione dell'entità servizio è supportata solo per le azioni amministrative.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio Class Regions
Copilot Studio Normale Tutte le aree di Power Automate
Power Apps Normale Tutte le aree di Power Apps
Power Automate Normale Tutte le aree di Power Automate
Contatto
Nome Microsoft
URL Supporto di Microsoft Power Automate
Supporto di Microsoft Power Apps
Metadati del connettore
Editore Microsoft
Sito web https://make.powerautomate.com/

Limiti generali

Nome Value
Connessioni per account 50

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Autenticazione del certificato client Specificare le credenziali dell'ID Entra di Microsoft usando il certificato PFX e la password Tutte le aree geografiche Non condivisibile
Microsoft Entra ID integrato Usare Microsoft Entra ID per accedere a questo servizio. Tutte le aree geografiche Non condivisibile
Impostazione predefinita [DEPRECATO] Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti. Tutte le aree geografiche Non condivisibile

Autenticazione del certificato client

ID autenticazione: CertOauth

Applicabile: tutte le aree

Specificare le credenziali dell'ID Entra di Microsoft usando il certificato PFX e la password

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome TIPO Description Obbligatorio
Tenant corda Vero
ID cliente corda ID client di per l'applicazione Microsoft Entra ID
Segreto certificato client Certificato del Cliente Segreto del certificato client consentito da questa applicazione Vero

Microsoft Entra ID Integrato

ID autenticazione: firstParty

Applicabile: tutte le aree

Usare Microsoft Entra ID per accedere a questo servizio.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Impostazione predefinita [DEPRECATO]

Applicabile: tutte le aree

Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Limiti per la limitazione delle richieste

Nome Chiamate Periodo di rinnovo
Chiamate API per connessione 5 60 secondi
Richieste non Get per connessione 300 3600 secondi

Azioni

Annulla esecuzione flusso

Annullare un'esecuzione del flusso.

Attivare il flusso

Avviare il flusso specificato in un ambiente.

Creare un flusso

Creare un flusso

Creare una connessione

Creare una connessione per il connettore specificato in un ambiente.

Disattiva flusso

Arrestare il flusso specificato in un ambiente.

Elencare gli ambienti personali

Elencare gli ambienti a cui si ha accesso.

Elencare gli utenti di flow Run-Only

Elencare tutti gli utenti che eseguono solo gli utenti del flusso specificato in un ambiente.

Elencare i connettori

Elenca tutti i connettori disponibili nell'ambiente specificato. Questo elenco include connettori personalizzati e connettori predefiniti.

Elencare i flussi come amministratori (V2)

Elencare tutti i flussi nell'ambiente specificato a cui si ha accesso amministratore. Questa azione V2 è un'azione con prestazioni più elevate che restituisce solo le informazioni di identificazione sul flusso. La definizione del flusso e gran parte dei metadati non vengono restituiti. Per i metadati aggiuntivi e la definizione del flusso, effettuare una chiamata successiva all'azione Get Flows as Admin .For additional metadata and the flow definition, make a successive call to the Get Flows as Admin action.

Elencare i flussi personali

Elencare tutti i flussi creati nell'ambiente specificato.

Elencare i proprietari dei flussi

Elencare tutti i proprietari del flusso specificato in un ambiente.

Elencare l'URL di callback

Elencare l'URL di callback per il flusso specificato in un ambiente.

Elencare le connessioni personali

Elenca tutte le connessioni disponibili nell'ambiente specificato.

Elimina flusso

Eliminare il flusso specificato in un ambiente

Flusso di aggiornamento

Aggiornare il flusso specificato in un ambiente.

Flusso di invio di nuovo

Inviare di nuovo il flusso specificato in un ambiente.

Modificare i proprietari del flusso

Modificare i proprietari del flusso specificato in un ambiente.

Modificare i proprietari del flusso come amministratore

Modificare i proprietari del flusso specificato creato in un ambiente a cui si ha accesso come amministratore.

Modificare Run-Only utenti

Modificare gli utenti di sola esecuzione del flusso specificato in un ambiente.

Ottenere Flow come amministratore

Ottenere il flusso specificato da un ambiente a cui si ha accesso come amministratore.

Ottenere il connettore

Ottenere il connettore specificato in un ambiente.

Ottenere il flusso

Ottenere il flusso specificato in un ambiente.

Ripristinare il flusso eliminato come amministratore

Ripristinare il flusso eliminato leggero specificato in un ambiente a cui si ha accesso amministratore.

Annulla esecuzione flusso

Annullare un'esecuzione del flusso.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

ID esecuzione
runId True string

ID dell'esecuzione del flusso per inviare di nuovo.

Attivare il flusso

Avviare il flusso specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Creare un flusso

Creare un flusso

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Nome flusso
name string
Nome visualizzato flusso
displayName True string
Stato flusso
state True string
Nome connessione
connectionName string
Nome visualizzato connessione
displayName string
ID connettore
id True string
Connessione embedded o invoker
source string
Nome logico del riferimento alla connessione
connectionReferenceLogicalName string
Nome del connettore
name string
Nome visualizzato connettore
displayName string
Ora di creazione connessione
createdTime date-time
URL di runtime del connettore
primaryRuntimeUrl string
URL icona connettore
iconUri string
Il connettore è un'API personalizzata
isCustomApi boolean
Livello connettore
tier string
Ora di creazione del flusso
createdTime date-time
Ora modificata flusso
lastModifiedTime date-time
Nome modello di flusso
templateName string
Uri del trigger di flusso
flowTriggerUri string
Stato installazione flusso
installationStatus string
Creator tenant ID
tenantId True string
ID oggetto creatore
objectId string
ID utente creatore
userId True string
Tipo di utente creator
userType True string
Tipo di trigger di flusso
type string
Tipo di trigger del flusso
kind string
Tipo di azione
type string
ID operazione Swagger
swaggerOperationId string
Nome api azione
name string
ID api azione
id string
Tipo di API azione
type string

Restituisce

Corpo
Flow

Creare una connessione

Creare una connessione per il connettore specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Connector
apiName True string

Selezionare il connettore

connessione
connection dynamic

Connection

Restituisce

Gli output di questa operazione sono dinamici.

Disattiva flusso

Arrestare il flusso specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Elencare gli ambienti personali

Elencare gli ambienti a cui si ha accesso.

Restituisce

Elencare gli utenti di flow Run-Only

Elencare tutti gli utenti che eseguono solo gli utenti del flusso specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Restituisce

Elencare i connettori

Elenca tutti i connettori disponibili nell'ambiente specificato. Questo elenco include connettori personalizzati e connettori predefiniti.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Restituisce

Elencare i flussi come amministratori (V2)

Elencare tutti i flussi nell'ambiente specificato a cui si ha accesso amministratore. Questa azione V2 è un'azione con prestazioni più elevate che restituisce solo le informazioni di identificazione sul flusso. La definizione del flusso e gran parte dei metadati non vengono restituiti. Per i metadati aggiuntivi e la definizione del flusso, effettuare una chiamata successiva all'azione Get Flows as Admin .For additional metadata and the flow definition, make a successive call to the Get Flows as Admin action.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Conteggio superiore
$top integer

Conteggio superiore

Espandi Informazioni sospensione
expandSuspensionInfo boolean

Espande le informazioni sulla sospensione

Includere flussi Soft-Deleted
includeSoftDeletedFlows boolean

Indica se includere o meno flussi eliminati soft.Whether or not to include soft-deleted flows.

Restituisce

Elencare i flussi personali

Elencare tutti i flussi creati nell'ambiente specificato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Restituisce

Elencare i proprietari dei flussi

Elencare tutti i proprietari del flusso specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Restituisce

Elencare l'URL di callback

Elencare l'URL di callback per il flusso specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Restituisce

Elencare le connessioni personali

Elenca tutte le connessioni disponibili nell'ambiente specificato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Restituisce

Elimina flusso

Eliminare il flusso specificato in un ambiente

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Flusso di aggiornamento

Aggiornare il flusso specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Nome flusso
name string
Nome visualizzato flusso
displayName True string
Stato flusso
state True string
Nome connessione
connectionName string
Nome visualizzato connessione
displayName string
ID connettore
id True string
Connessione embedded o invoker
source string
Nome logico del riferimento alla connessione
connectionReferenceLogicalName string
Nome del connettore
name string
Nome visualizzato connettore
displayName string
Ora di creazione connessione
createdTime date-time
URL di runtime del connettore
primaryRuntimeUrl string
URL icona connettore
iconUri string
Il connettore è un'API personalizzata
isCustomApi boolean
Livello connettore
tier string
Ora di creazione del flusso
createdTime date-time
Ora modificata flusso
lastModifiedTime date-time
Nome modello di flusso
templateName string
Uri del trigger di flusso
flowTriggerUri string
Stato installazione flusso
installationStatus string
Creator tenant ID
tenantId True string
ID oggetto creatore
objectId string
ID utente creatore
userId True string
Tipo di utente creator
userType True string
Tipo di trigger di flusso
type string
Tipo di trigger del flusso
kind string
Tipo di azione
type string
ID operazione Swagger
swaggerOperationId string
Nome api azione
name string
ID api azione
id string
Tipo di API azione
type string

Restituisce

Corpo
Flow

Flusso di invio di nuovo

Inviare di nuovo il flusso specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Nome trigger
triggerName True string

Nome del trigger del flusso da inviare di nuovo.

ID esecuzione
runId True string

ID dell'esecuzione del flusso per inviare di nuovo.

Modificare i proprietari del flusso

Modificare i proprietari del flusso specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Aggiungere l'ID oggetto utente
id True string
Aggiungi tipo di utente
type True string
Rimuovere l'ID oggetto utente
id True string
Rimuovi tipo di utente
type True string

Modificare i proprietari del flusso come amministratore

Modificare i proprietari del flusso specificato creato in un ambiente a cui si ha accesso come amministratore.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Aggiungere l'ID oggetto utente
id True string
Aggiungi tipo di utente
type True string
Rimuovere l'ID oggetto utente
id True string
Rimuovi tipo di utente
type True string

Modificare Run-Only utenti

Modificare gli utenti di sola esecuzione del flusso specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Aggiungere l'ID oggetto utente
id True string
Aggiungi tipo di utente
type True string
Rimuovere l'ID oggetto utente
id True string
Rimuovi tipo di utente
type True string

Ottenere Flow come amministratore

Ottenere il flusso specificato da un ambiente a cui si ha accesso come amministratore.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Includi definizione flusso
includeFlowDefinition boolean

Indica se includere o meno la definizione del flusso.

Restituisce

Ottenere il connettore

Ottenere il connettore specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Connector
apiName True string

Selezionare il connettore

Restituisce

Gli output di questa operazione sono dinamici.

Ottenere il flusso

Ottenere il flusso specificato in un ambiente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Restituisce

Ripristinare il flusso eliminato come amministratore

Ripristinare il flusso eliminato leggero specificato in un ambiente a cui si ha accesso amministratore.

Parametri

Nome Chiave Necessario Tipo Descrizione
Ambiente
environmentName True string

Seleziona ambiente

Flusso
flowName True string

Seleziona flusso

Restituisce

Definizioni

ResourceArray[ApiWithoutConnectionParameters]

Nome Percorso Tipo Descrizione
value
value array of ApiWithoutConnectionParameters

ResourceArray[ConnectionWithoutConnectionParameters]

Nome Percorso Tipo Descrizione
value
value array of ConnectionWithoutConnectionParameters

ResourceArray[Ambiente]

Nome Percorso Tipo Descrizione
value
value array of Environment

ResourceArray[AdminFlow]

Nome Percorso Tipo Descrizione
value
value array of AdminFlow

ResourceArray[AdminFlowWithoutDefinition]

Nome Percorso Tipo Descrizione
value
value array of AdminFlowWithoutDefinition

ResourceArray[FlowPermission]

Nome Percorso Tipo Descrizione
value
value array of FlowPermission

FlowPermission

Nome Percorso Tipo Descrizione
Nome autorizzazione
name string
proprietà
properties PermissionProperties

PermissionProperties

Nome Percorso Tipo Descrizione
roleName
roleName string
preside
principal Principal

Principale

Nome Percorso Tipo Descrizione
ID oggetto
id string
Nome visualizzato
displayName string
Email
email string
TIPO
type string
ID tenant
tenantId string
Nome principale
userPrincipalName string
Foto anteprima proprietario
thumbnailPhoto string

Flusso

Nome Percorso Tipo Descrizione
Nome flusso
name string
proprietà
properties FlowProperties

Proprietà del flusso

Nome Percorso Tipo Descrizione
Nome visualizzato flusso
displayName string
Stato flusso
state string
connectionReferences
connectionReferences ConnectionReferencesDictionary
Ora di creazione del flusso
createdTime date-time
Ora modificata flusso
lastModifiedTime date-time
Nome modello di flusso
templateName string
Uri del trigger di flusso
flowTriggerUri string
Stato installazione flusso
installationStatus string

FlowListCallbackUrlResponse

Nome Percorso Tipo Descrizione
Callback URL (URL callback)
response.value string

FlowWithConnectionReferences

Nome Percorso Tipo Descrizione
Nome flusso
name string
proprietà
properties FlowWithConnectionReferencesProperties

FlowWithConnectionReferencesProperties

Nome Percorso Tipo Descrizione
Nome visualizzato flusso
displayName string
Stato flusso
state string
connectionReferences
connectionReferences ConnectionReferencesArray
Ora di creazione del flusso
createdTime date-time
Ora modificata flusso
lastModifiedTime date-time
Nome modello di flusso
templateName string
Uri del trigger di flusso
flowTriggerUri string
Stato installazione flusso
installationStatus string
creatore
creator UserIdentity
definitionSummary
definitionSummary DefinitionSummary

AdminFlow

Nome Percorso Tipo Descrizione
Nome flusso
name string
proprietà
properties AdminFlowProperties

AdminFlowWithoutDefinition

Nome Percorso Tipo Descrizione
Nome flusso
name string
proprietà
properties AdminFlowWithoutDefinitionProperties

AdminFlowProperties

Nome Percorso Tipo Descrizione
Nome visualizzato flusso
displayName string
Stato flusso
state string
connectionReferences
connectionReferences ConnectionReferencesDictionary
Ora di creazione del flusso
createdTime date-time
Ora modificata flusso
lastModifiedTime date-time
Nome modello di flusso
templateName string
Uri del trigger di flusso
flowTriggerUri string
Stato installazione flusso
installationStatus string
creatore
creator UserIdentity
definitionSummary
definitionSummary DefinitionSummary
estimatedSuspensionData
estimatedSuspensionData EstimatedSuspensionData

AdminFlowWithoutDefinitionProperties

Nome Percorso Tipo Descrizione
Nome visualizzato flusso
displayName string
Stato flusso
state string
Ora di creazione del flusso
createdTime date-time
Ora modificata flusso
lastModifiedTime date-time

AdminFlowWithConnectionReferences

Nome Percorso Tipo Descrizione
Nome flusso
name string
proprietà
properties AdminFlowWithConnectionReferencesProperties

AdminFlowWithConnectionReferencesProperties

Nome Percorso Tipo Descrizione
Nome visualizzato flusso
displayName string
Stato flusso
state string
connectionReferences
connectionReferences ConnectionReferencesArray
Ora di creazione del flusso
createdTime date-time
Ora modificata flusso
lastModifiedTime date-time
Nome modello di flusso
templateName string
Uri del trigger di flusso
flowTriggerUri string
Stato installazione flusso
installationStatus string
creatore
creator UserIdentity
definitionSummary
definitionSummary DefinitionSummary

EstimatedSuspensionData

Nome Percorso Tipo Descrizione
Motivo della sospensione stimata del flusso
reason string
Tempo di sospensione stimato del flusso
time date-time
Se il flusso è il piano di risparmio energia escluso o meno
powerAppPlanExcluded boolean

DefinitionSummary

Nome Percorso Tipo Descrizione
Trigger
triggers array of object
Tipo di trigger di flusso
triggers.type string
Tipo di trigger del flusso
triggers.kind string
Azioni
actions array of object
Tipo di azione
actions.type string
ID operazione Swagger
actions.swaggerOperationId string
Nome api azione
actions.api.name string
ID api azione
actions.api.id string
Tipo di API azione
actions.api.type string

UserIdentity

Nome Percorso Tipo Descrizione
Creator tenant ID
tenantId string
ID oggetto creatore
objectId string
ID utente creatore
userId string
Tipo di utente creator
userType string

Ambiente

Nome Percorso Tipo Descrizione
Nome ambiente
name string
Posizione dell'ambiente
location string
proprietà
properties EnvironmentProperties

Proprietà dell'ambiente

Nome Percorso Tipo Descrizione
Nome visualizzato dell'ambiente
displayName string
Descrizione dell'ambiente
description string
Ora di creazione dell'ambiente
createdTime date-time
Ora dell'ultima modifica dell'ambiente
lastModifiedTime date-time
Stato del provisioning dell'ambiente
provisioningState string
Tipo di creazione dell'ambiente
creationType string
Sku dell'ambiente
environmentSku string
Tipo di ambiente
environmentType string
Ambiente predefinito
isDefault boolean

ConnectionReferencesArray

Nome Percorso Tipo Descrizione
Elementi
ConnectionReference

ConnectionReferencesDictionary

ConnectionReference

Nome Percorso Tipo Descrizione
Nome connessione
connectionName string
Nome visualizzato connessione
displayName string
ID connettore
id string
Connessione embedded o invoker
source string
Nome logico del riferimento alla connessione
connectionReferenceLogicalName string
apiDefinition
apiDefinition ApiWithoutConnectionParameters

ApiWithoutConnectionParameters

Nome Percorso Tipo Descrizione
Nome del connettore
name string
proprietà
properties ApiPropertiesWithoutConnectionParameters

ApiPropertiesWithoutConnectionParameters

Nome Percorso Tipo Descrizione
Nome visualizzato connettore
displayName string
Ora di creazione connessione
createdTime date-time
URL di runtime del connettore
primaryRuntimeUrl string
URL icona connettore
iconUri string
Il connettore è un'API personalizzata
isCustomApi boolean
Livello connettore
tier string

ConnectionWithoutConnectionParameters

Nome Percorso Tipo Descrizione
Nome connessione
name string
proprietà
properties ConnectionPropertiesWithoutConnectionParameters

ConnectionPropertiesWithoutConnectionParameters

Nome Percorso Tipo Descrizione
Nome visualizzato connettore
displayName string
ID connettore
apiId string
Ora di creazione connessione
createdTime date-time
Ora ultima modifica della connessione
lastModifiedTime date-time