共用方式為


Power Automate 管理

Power Automate 管理連接器可讓您與 Power Automate 管理服務互動。 例如:建立、編輯和更新流程。 想要以管理員權限執行操作的管理員應呼叫帶有「管理員身份」後綴的操作。 服務主體驗證僅支援系統管理動作。

此連接器適用於以下產品和區域:

服務 Class Regions
副駕駛工作室 標準 所有 Power Automate 區域
Power Apps 標準 所有 Power Apps 區域
Power Automate(自動化服務) 標準 所有 Power Automate 區域
連絡人​​
名稱 Microsoft
URL Microsoft Power Automate 支援
Microsoft Power Apps 支援
連接器中繼資料
Publisher Microsoft
網站 https://make.powerautomate.com/

一般限制

名稱 價值觀
每個帳戶的連線數 50

正在建立連線

連接器支援下列驗證類型:

用戶端憑證驗證 使用 PFX 憑證和密碼提供 Microsoft Entra ID 認證 所有區域 不可共享
Microsoft Entra ID 整合式 使用 Microsoft Entra ID 來存取此服務。 所有區域 不可共享
預設值 [已棄用] 此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。 所有區域 不可共享

用戶端憑證驗證

驗證 ID:CertOauth

適用:所有地區

使用 PFX 憑證和密碼提供 Microsoft Entra ID 認證

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
租戶 字串
用戶端識別碼 字串 Microsoft Entra ID 應用程式的用戶端識別碼
用戶端憑證密碼 客戶憑證 此應用程式允許的用戶端憑證密碼

Microsoft Entra ID 整合

驗證 ID:firstParty

適用:所有地區

使用 Microsoft Entra ID 來存取此服務。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

預設值 [已棄用]

適用:所有地區

此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 5 60 秒
每個連線的非 Get 要求 300 3600 秒

動作

以管理員身份獲取 Flow

從您具有管理員存取權的環境中取得指定的流程。

以管理員身分修改流程擁有者

修改在您具有管理員存取權的環境中建立的指定流程的擁有者。

以管理員身分還原已刪除的流程

在您具有系統管理員存取權的環境中還原指定的虛刪除流程。

修改 Run-Only 使用者

修改環境中指定流程的僅執行使用者。

修改流程擁有者

修改環境中指定流程的擁有者。

列出使用者 Run-Only 流程

列出環境中指定流程的所有僅執行使用者。

列出我的流程

列出您在指定環境中建立的所有流程。

列出我的環境

列出您有權存取的環境。

列出我的聯絡人

列出指定環境中可用的所有連線。

列出連接器

列出指定環境中可用的所有連接器。 此清單將包括自訂連接器以及內建連接器。

刪除流程

刪除環境中的指定流程

取得連接器

在環境中取得指定的連接器。

取消流程執行

取消流程執行。

將流程列為管理員 (V2)

列出您具有管理員存取權的指定環境中的所有流程。 此 V2 動作是效能較高的動作,只會傳回有關流程的識別資訊。 不會傳回流程定義和大部分中繼資料。 如需其他中繼資料和流程定義,請後續呼叫「以管理員身分取得流程」動作。

建立流程

建立流程

建立連線

在環境中為指定的連接器建立連線。

更新流程

更新環境中的指定流程。

清單回呼 URL

列出環境中指定流程的回呼 URL。

清單流程擁有者

列出環境中指定流程的所有擁有者。

獲取流量

在環境中取得指定的流程。

重新提交流程

在環境中重新提交指定的流程執行。

開啟流程

在環境中啟動指定的流程。

關閉流程

停止環境中的指定流程。

以管理員身份獲取 Flow

從您具有管理員存取權的環境中取得指定的流程。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

包括流程定義
includeFlowDefinition boolean

是否包含流程定義。

傳回

以管理員身分修改流程擁有者

修改在您具有管理員存取權的環境中建立的指定流程的擁有者。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

新增使用者物件識別碼
id True string
新增使用者類型
type True string
移除使用者物件識別碼
id True string
移除使用者類型
type True string

以管理員身分還原已刪除的流程

在您具有系統管理員存取權的環境中還原指定的虛刪除流程。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

傳回

修改 Run-Only 使用者

修改環境中指定流程的僅執行使用者。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

新增使用者物件識別碼
id True string
新增使用者類型
type True string
移除使用者物件識別碼
id True string
移除使用者類型
type True string

修改流程擁有者

修改環境中指定流程的擁有者。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

新增使用者物件識別碼
id True string
新增使用者類型
type True string
移除使用者物件識別碼
id True string
移除使用者類型
type True string

列出使用者 Run-Only 流程

列出環境中指定流程的所有僅執行使用者。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

傳回

列出我的流程

列出您在指定環境中建立的所有流程。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

傳回

列出我的環境

列出您有權存取的環境。

傳回

列出我的聯絡人

列出指定環境中可用的所有連線。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

傳回

列出連接器

列出指定環境中可用的所有連接器。 此清單將包括自訂連接器以及內建連接器。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

傳回

刪除流程

刪除環境中的指定流程

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

取得連接器

在環境中取得指定的連接器。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Connector
apiName True string

選取連接器

傳回

此作業會輸出隨機的結果。

取消流程執行

取消流程執行。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

執行標識碼
runId True string

要重新提交的流程執行 ID。

將流程列為管理員 (V2)

列出您具有管理員存取權的指定環境中的所有流程。 此 V2 動作是效能較高的動作,只會傳回有關流程的識別資訊。 不會傳回流程定義和大部分中繼資料。 如需其他中繼資料和流程定義,請後續呼叫「以管理員身分取得流程」動作。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

頂數
$top integer

頂數

展開暫停資訊
expandSuspensionInfo boolean

擴展暫停信息

包含 Soft-Deleted 流程
includeSoftDeletedFlows boolean

是否包含虛刪除的流程。

傳回

建立流程

建立流程

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

流程名稱
name string
流程顯示名稱
displayName True string
流程狀態
state True string
連線名稱
connectionName string
連線顯示名稱
displayName string
連接器標識碼
id True string
內嵌或調用程式連線
source string
連線參照的邏輯名稱
connectionReferenceLogicalName string
連接器名稱
name string
連接器顯示名稱
displayName string
連線建立時間
createdTime date-time
連接器執行階段 URL
primaryRuntimeUrl string
連接器圖示 URL
iconUri string
連接器是自訂 API
isCustomApi boolean
連接器層
tier string
流程建立時間
createdTime date-time
流量修改時間
lastModifiedTime date-time
流程範本名稱
templateName string
流程觸發程式 URI
flowTriggerUri string
流程安裝狀態
installationStatus string
建立者租用戶識別碼
tenantId True string
建立者物件識別碼
objectId string
創作者使用者 ID
userId True string
創作者使用者類型
userType True string
流程觸發類型
type string
流程觸發類型
kind string
動作類型
type string
Swagger 作業識別碼
swaggerOperationId string
動作 API 名稱
name string
動作 API ID
id string
動作 API 類型
type string

傳回

身體
Flow

建立連線

在環境中為指定的連接器建立連線。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Connector
apiName True string

選取連接器

連接
connection dynamic

Connection

傳回

此作業會輸出隨機的結果。

更新流程

更新環境中的指定流程。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

流程名稱
name string
流程顯示名稱
displayName True string
流程狀態
state True string
連線名稱
connectionName string
連線顯示名稱
displayName string
連接器標識碼
id True string
內嵌或調用程式連線
source string
連線參照的邏輯名稱
connectionReferenceLogicalName string
連接器名稱
name string
連接器顯示名稱
displayName string
連線建立時間
createdTime date-time
連接器執行階段 URL
primaryRuntimeUrl string
連接器圖示 URL
iconUri string
連接器是自訂 API
isCustomApi boolean
連接器層
tier string
流程建立時間
createdTime date-time
流量修改時間
lastModifiedTime date-time
流程範本名稱
templateName string
流程觸發程式 URI
flowTriggerUri string
流程安裝狀態
installationStatus string
建立者租用戶識別碼
tenantId True string
建立者物件識別碼
objectId string
創作者使用者 ID
userId True string
創作者使用者類型
userType True string
流程觸發類型
type string
流程觸發類型
kind string
動作類型
type string
Swagger 作業識別碼
swaggerOperationId string
動作 API 名稱
name string
動作 API ID
id string
動作 API 類型
type string

傳回

身體
Flow

清單回呼 URL

列出環境中指定流程的回呼 URL。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

傳回

清單流程擁有者

列出環境中指定流程的所有擁有者。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

傳回

獲取流量

在環境中取得指定的流程。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

傳回

重新提交流程

在環境中重新提交指定的流程執行。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

觸發程式名稱
triggerName True string

要重新提交的流程觸發程式名稱。

執行標識碼
runId True string

要重新提交的流程執行 ID。

開啟流程

在環境中啟動指定的流程。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

關閉流程

停止環境中的指定流程。

參數

名稱 機碼 必要 類型 Description
環境
environmentName True string

選取環境

Flow
flowName True string

選取流程

定義

ResourceArray[ApiWithoutConnectionParameters]

名稱 路徑 類型 Description
value
value array of ApiWithoutConnectionParameters

ResourceArray[ConnectionWithoutConnectionParameters]

名稱 路徑 類型 Description
value
value array of ConnectionWithoutConnectionParameters

ResourceArray[環境]

名稱 路徑 類型 Description
value
value array of Environment

資源陣列[管理流程]

名稱 路徑 類型 Description
value
value array of AdminFlow

ResourceArray[AdminFlowWithoutDefinition]

名稱 路徑 類型 Description
value
value array of AdminFlowWithoutDefinition

ResourceArray[FlowPermission]

名稱 路徑 類型 Description
value
value array of FlowPermission

流程權限

名稱 路徑 類型 Description
權限名稱
name string
properties
properties PermissionProperties

PermissionProperties

名稱 路徑 類型 Description
roleName
roleName string
主體
principal Principal

校長

名稱 路徑 類型 Description
物件識別碼
id string
顯示名稱
displayName string
Email
email string
類型
type string
租用戶識別碼
tenantId string
主要名稱
userPrincipalName string
業主縮略圖
thumbnailPhoto string

Flow

名稱 路徑 類型 Description
流程名稱
name string
properties
properties FlowProperties

FlowProperties

名稱 路徑 類型 Description
流程顯示名稱
displayName string
流程狀態
state string
connection參考資料
connectionReferences ConnectionReferencesDictionary
流程建立時間
createdTime date-time
流量修改時間
lastModifiedTime date-time
流程範本名稱
templateName string
流程觸發程式 URI
flowTriggerUri string
流程安裝狀態
installationStatus string

FlowListCallbackUrl回應

名稱 路徑 類型 Description
回呼 URL
response.value string

FlowWithConnection參考

名稱 路徑 類型 Description
流程名稱
name string
properties
properties FlowWithConnectionReferencesProperties

FlowWithConnectionReferences屬性

名稱 路徑 類型 Description
流程顯示名稱
displayName string
流程狀態
state string
connection參考資料
connectionReferences ConnectionReferencesArray
流程建立時間
createdTime date-time
流量修改時間
lastModifiedTime date-time
流程範本名稱
templateName string
流程觸發程式 URI
flowTriggerUri string
流程安裝狀態
installationStatus string
建立者
creator UserIdentity
定義總結
definitionSummary DefinitionSummary

管理流程

名稱 路徑 類型 Description
流程名稱
name string
properties
properties AdminFlowProperties

AdminFlowWithoutDefinition

名稱 路徑 類型 Description
流程名稱
name string
properties
properties AdminFlowWithoutDefinitionProperties

管理流程屬性

名稱 路徑 類型 Description
流程顯示名稱
displayName string
流程狀態
state string
connection參考資料
connectionReferences ConnectionReferencesDictionary
流程建立時間
createdTime date-time
流量修改時間
lastModifiedTime date-time
流程範本名稱
templateName string
流程觸發程式 URI
flowTriggerUri string
流程安裝狀態
installationStatus string
建立者
creator UserIdentity
定義總結
definitionSummary DefinitionSummary
estimatedSuspensionData
estimatedSuspensionData EstimatedSuspensionData

AdminFlowWithoutDefinitionProperties

名稱 路徑 類型 Description
流程顯示名稱
displayName string
流程狀態
state string
流程建立時間
createdTime date-time
流量修改時間
lastModifiedTime date-time

AdminFlowWithConnection參考

名稱 路徑 類型 Description
流程名稱
name string
properties
properties AdminFlowWithConnectionReferencesProperties

AdminFlowWithConnectionReferences屬性

名稱 路徑 類型 Description
流程顯示名稱
displayName string
流程狀態
state string
connection參考資料
connectionReferences ConnectionReferencesArray
流程建立時間
createdTime date-time
流量修改時間
lastModifiedTime date-time
流程範本名稱
templateName string
流程觸發程式 URI
flowTriggerUri string
流程安裝狀態
installationStatus string
建立者
creator UserIdentity
定義總結
definitionSummary DefinitionSummary

估計暫停資料

名稱 路徑 類型 Description
流量估計暫停原因
reason string
流量預估暫停時間
time date-time
如果流程已排除或未排除 Power App 方案
powerAppPlanExcluded boolean

定義摘要

名稱 路徑 類型 Description
觸發器
triggers array of object
流程觸發類型
triggers.type string
流程觸發類型
triggers.kind string
行為
actions array of object
動作類型
actions.type string
Swagger 作業識別碼
actions.swaggerOperationId string
動作 API 名稱
actions.api.name string
動作 API ID
actions.api.id string
動作 API 類型
actions.api.type string

UserIdentity

名稱 路徑 類型 Description
建立者租用戶識別碼
tenantId string
建立者物件識別碼
objectId string
創作者使用者 ID
userId string
創作者使用者類型
userType string

環境

名稱 路徑 類型 Description
環境名稱
name string
環境位置
location string
properties
properties EnvironmentProperties

環境屬性

名稱 路徑 類型 Description
環境顯示名稱
displayName string
環境描述
description string
環境建立時間
createdTime date-time
環境上次修改時間
lastModifiedTime date-time
環境佈建狀態
provisioningState string
環境建立類型
creationType string
環境 SKU
environmentSku string
環境類型
environmentType string
是預設環境
isDefault boolean

ConnectionReferences陣列

名稱 路徑 類型 Description
物品
ConnectionReference

ConnectionReferences字典

連線參考

名稱 路徑 類型 Description
連線名稱
connectionName string
連線顯示名稱
displayName string
連接器標識碼
id string
內嵌或調用程式連線
source string
連線參照的邏輯名稱
connectionReferenceLogicalName string
api定義
apiDefinition ApiWithoutConnectionParameters

ApiWithoutConnection參數

名稱 路徑 類型 Description
連接器名稱
name string
properties
properties ApiPropertiesWithoutConnectionParameters

ApiPropertiesWithoutConnectionParameters

名稱 路徑 類型 Description
連接器顯示名稱
displayName string
連線建立時間
createdTime date-time
連接器執行階段 URL
primaryRuntimeUrl string
連接器圖示 URL
iconUri string
連接器是自訂 API
isCustomApi boolean
連接器層
tier string

ConnectionWithoutConnectionParameters

名稱 路徑 類型 Description
連線名稱
name string
properties
properties ConnectionPropertiesWithoutConnectionParameters

ConnectionPropertiesWithoutConnectionParameters

名稱 路徑 類型 Description
連接器顯示名稱
displayName string
連接器標識碼
apiId string
連線建立時間
createdTime date-time
連線上次修改時間
lastModifiedTime date-time