Power Automate Management

Power Automate 管理コネクタを使用すると、Power Automate 管理サービスとのやり取りが可能になります。 例: フローの作成、編集、および更新。 管理者特権で操作を実行する必要がある管理者は、「管理者として」の接尾辞を持つアクションを呼び出す必要があります。

このコネクタは、次の製品および地域で利用可能です:

サービス クラス リージョン
Power Automate 標準 すべての Power Automate 地域
Power Apps 標準 すべての Power Apps 地域
コネクタ メタデータ
公開元 Microsoft
Web サイト https://flow.microsoft.com/

一般的な制限

件名
アカウントごとの接続 50

接続の作成

コネクタは、次の認証タイプをサポートしています:

ファーストパーティ ファーストパーティ認証を使用します。 すべての地域 共有不可
既定 [非推奨] このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 すべての地域 共有不可

ファーストパーティ

認証ID: firstParty

適用できるもの: すべての領域

ファーストパーティ認証を使用します。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

既定 [非推奨]

適用できるもの: すべての領域

このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 5 60 秒
接続ごとの非 GET 要求 300 3600 秒

アクション

コネクタを一覧表示する

指定された環境内で使用可能なすべてのコネクタを一覧表示します。 この一覧には、カスタム コネクタおよび組み込みコネクタが含まれます。

コネクタを取得する

環境内で指定されたコネクタを取得します。

コールバック URL の一覧

環境内で指定されたフローのコールバック URL の一覧です。

フローの作成

フローの作成

フローの実行専用ユーザーを一覧表示する

環境内で指定されたフローのすべての実行専用ユーザーを一覧表示します。

フローの所有者を変更する

環境内で指定されたフローの所有者を変更します。

フローをオフにする

環境内で指定されたフローを停止します。

フローをオンにする

環境内で指定されたフローを開始します。

フローを再送信する

環境内で指定されたフロー実行を再送信します。

フローを削除する

環境内で指定されたフローを削除します

フローを取得する

環境内で指定されたフローを取得します。

フローを更新する

環境内で指定されたフローを更新します。

フローを管理者として取得する

管理者アクセス権のある環境から指定されたフローを取得します。

フロー実行を取り消す

フロー実行を取り消します。

フロー所有者を一覧表示する

環境内で指定されたフローのすべての所有者を一覧表示します。

フロー所有者を管理者として変更する

管理者アクセス権のある環境内で作成された特定のフローの所有者を変更します。

削除されたフローを管理者として復元する

管理者のアクセス権を持つ環境で、論理的に削除された指定のフローを復元します。

実行専用ユーザーを変更する

環境内で指定されたフローの実行専用ユーザーを変更します。

接続の作成

環境内の特定のコネクタの接続を作成します。

管理者としてフローの一覧を取得 (V2)

管理者アクセス権のある指定された環境内ですべてのフローを一覧表示します。 この V2 アクションは、フローに関する識別情報のみを返す、よりパフォーマンスの高いアクションです。 フロー定義とメタデータの多くは返されません。 追加のメタデータとフロー定義については、その後 Get Flows as Admin アクションを呼び出します。

管理者としてフローを一覧表示 (非推奨)

このアクションは非推奨になりました。 代わりに 管理者としてフローを一覧表示 (V2) を使用してください。

管理者のアクセス許可をもつ、指定した環境内のフローをすべて一覧表示します (非推奨)。

自分のフローを一覧表示する

指定された境内で作成したすべてのフローを一覧表示します。

自分の接続を一覧表示する

指定された環境内で使用可能なすべての接続を一覧表示します。

自分の環境を一覧表示する

アクセス可能な環境を一覧表示します。

コネクタを一覧表示する

指定された環境内で使用可能なすべてのコネクタを一覧表示します。 この一覧には、カスタム コネクタおよび組み込みコネクタが含まれます。

パラメーター

名前 キー 必須 説明
Environment
environmentName True string

環境を選択する

戻り値

コネクタを取得する

環境内で指定されたコネクタを取得します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

コネクタ
apiName True string

コネクタを選択します

戻り値

この操作の出力は状況に応じて変わります。

コールバック URL の一覧

環境内で指定されたフローのコールバック URL の一覧です。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

戻り値

フローの作成

フローの作成

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

フロー名
name string
フローの表示名
displayName True string
フローの状態
state True string
接続名
connectionName string
接続の表示名
displayName string
コネクタ ID
id True string
埋め込みまたは呼び出し接続のいずれか
source string
接続参照の論理名
connectionReferenceLogicalName string
コネクタ名
name string
コネクタの表示名
displayName string
接続の作成時刻
createdTime date-time
コネクタ ランタイム URL
primaryRuntimeUrl string
コネクタ アイコン URI
iconUri string
コネクタはカスタム API
isCustomApi boolean
コネクタの階層
tier string
フローの作成時刻
createdTime date-time
フローの変更時刻
lastModifiedTime date-time
フローのテンプレート名
templateName string
フロー トリガー URI
flowTriggerUri string
フローのインストールの状態
installationStatus string
作成者のテナント ID
tenantId True string
作成者のオブジェクト ID
objectId string
作成者のユーザー ID
userId True string
作成者のユーザーの種類
userType True string
フロー トリガーの種類
type string
フロー トリガーの種類
kind string
アクションの種類
type string
Swagger の操作 ID
swaggerOperationId string
アクション API 名
name string
アクション API ID
id string
アクション API の種類
type string

戻り値

本文​​
Flow

フローの実行専用ユーザーを一覧表示する

環境内で指定されたフローのすべての実行専用ユーザーを一覧表示します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

戻り値

フローの所有者を変更する

環境内で指定されたフローの所有者を変更します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

ユーザー オブジェクト ID の追加
id True string
ユーザーの種類の追加
type True string
ユーザー オブジェクト ID の削除
id True string
ユーザーの種類の削除
type True string

フローをオフにする

環境内で指定されたフローを停止します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

フローをオンにする

環境内で指定されたフローを開始します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

フローを再送信する

環境内で指定されたフロー実行を再送信します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

トリガー名
triggerName True string

再送信するフロー トリガーの名前です。

実行 ID
runId True string

再送信するフロー実行の ID です。

フローを削除する

環境内で指定されたフローを削除します

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

フローを取得する

環境内で指定されたフローを取得します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

戻り値

フローを更新する

環境内で指定されたフローを更新します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

フロー名
name string
フローの表示名
displayName True string
フローの状態
state True string
接続名
connectionName string
接続の表示名
displayName string
コネクタ ID
id True string
埋め込みまたは呼び出し接続のいずれか
source string
接続参照の論理名
connectionReferenceLogicalName string
コネクタ名
name string
コネクタの表示名
displayName string
接続の作成時刻
createdTime date-time
コネクタ ランタイム URL
primaryRuntimeUrl string
コネクタ アイコン URI
iconUri string
コネクタはカスタム API
isCustomApi boolean
コネクタの階層
tier string
フローの作成時刻
createdTime date-time
フローの変更時刻
lastModifiedTime date-time
フローのテンプレート名
templateName string
フロー トリガー URI
flowTriggerUri string
フローのインストールの状態
installationStatus string
作成者のテナント ID
tenantId True string
作成者のオブジェクト ID
objectId string
作成者のユーザー ID
userId True string
作成者のユーザーの種類
userType True string
フロー トリガーの種類
type string
フロー トリガーの種類
kind string
アクションの種類
type string
Swagger の操作 ID
swaggerOperationId string
アクション API 名
name string
アクション API ID
id string
アクション API の種類
type string

戻り値

本文​​
Flow

フローを管理者として取得する

管理者アクセス権のある環境から指定されたフローを取得します。

パラメーター

名前 キー 必須 説明
Environment
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

フロー定義を含める
includeFlowDefinition boolean

フロー定義を含めるかどうかを指定します。

戻り値

フロー実行を取り消す

フロー実行を取り消します。

パラメーター

名前 キー 必須 説明
Environment
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

実行 ID
runId True string

再送信するフロー実行の ID です。

フロー所有者を一覧表示する

環境内で指定されたフローのすべての所有者を一覧表示します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

戻り値

フロー所有者を管理者として変更する

管理者アクセス権のある環境内で作成された特定のフローの所有者を変更します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

ユーザー オブジェクト ID の追加
id True string
ユーザーの種類の追加
type True string
ユーザー オブジェクト ID の削除
id True string
ユーザーの種類の削除
type True string

削除されたフローを管理者として復元する

管理者のアクセス権を持つ環境で、論理的に削除された指定のフローを復元します。

パラメーター

名前 キー 必須 説明
Environment
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

戻り値

実行専用ユーザーを変更する

環境内で指定されたフローの実行専用ユーザーを変更します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

Flow
flowName True string

フローの選択

ユーザー オブジェクト ID の追加
id True string
ユーザーの種類の追加
type True string
ユーザー オブジェクト ID の削除
id True string
ユーザーの種類の削除
type True string

接続の作成

環境内の特定のコネクタの接続を作成します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

コネクタ
apiName True string

コネクタを選択します

つながり
connection dynamic

つながり

戻り値

この操作の出力は状況に応じて変わります。

管理者としてフローの一覧を取得 (V2)

管理者アクセス権のある指定された環境内ですべてのフローを一覧表示します。 この V2 アクションは、フローに関する識別情報のみを返す、よりパフォーマンスの高いアクションです。 フロー定義とメタデータの多くは返されません。 追加のメタデータとフロー定義については、その後 Get Flows as Admin アクションを呼び出します。

パラメーター

名前 キー 必須 説明
Environment
environmentName True string

環境を選択する

上位の件数
$top integer

上位の件数

中断情報を展開
expandSuspensionInfo boolean

中断情報を展開する

論理的に削除されたフローを含める
includeSoftDeletedFlows boolean

論理的に削除されたフローを含めるかどうかを指定します。

戻り値

管理者としてフローを一覧表示 (非推奨)

このアクションは非推奨になりました。 代わりに 管理者としてフローを一覧表示 (V2) を使用してください。

管理者のアクセス許可をもつ、指定した環境内のフローをすべて一覧表示します (非推奨)。

パラメーター

名前 キー 必須 説明
Environment
environmentName True string

環境を選択する

上位の件数
$top integer

上位の件数

中断情報を展開
expandSuspensionInfo boolean

中断情報を展開する

論理的に削除されたフローを含める
includeSoftDeletedFlows boolean

論理的に削除されたフローを含めるかどうかを指定します。

戻り値

自分のフローを一覧表示する

指定された境内で作成したすべてのフローを一覧表示します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

戻り値

自分の接続を一覧表示する

指定された環境内で使用可能なすべての接続を一覧表示します。

パラメーター

名前 キー 必須 説明
環境
environmentName True string

環境を選択する

戻り値

自分の環境を一覧表示する

アクセス可能な環境を一覧表示します。

戻り値

定義

ResourceArray[ApiWithoutConnectionParameters]

名前 パス 説明
価値
value array of ApiWithoutConnectionParameters

ResourceArray[ConnectionWithoutConnectionParameters]

名前 パス 説明
価値
value array of ConnectionWithoutConnectionParameters

ResourceArray[Environment]

名前 パス 説明
価値
value array of Environment

ResourceArray[AdminFlow]

名前 パス 説明
価値
value array of AdminFlow

ResourceArray[AdminFlowWithoutDefinition]

名前 パス 説明
価値
value array of AdminFlowWithoutDefinition

ResourceArray[FlowPermission]

名前 パス 説明
価値
value array of FlowPermission

FlowPermission

名前 パス 説明
アクセス許可名
name string
プロパティ
properties PermissionProperties

PermissionProperties

名前 パス 説明
roleName
roleName string
プリンシパル
principal Principal

プリンシパル

名前 パス 説明
オブジェクト ID
id string
表示名
displayName string
電子メール
email string
タイプ
type string
テナント ID です
tenantId string
プリンシパル名
userPrincipalName string
所有者のサムネイル写真
thumbnailPhoto string

Flow

名前 パス 説明
フロー名
name string
プロパティ
properties FlowProperties

FlowProperties

名前 パス 説明
フローの表示名
displayName string
フローの状態
state string
connectionReferences
connectionReferences ConnectionReferencesDictionary
フローの作成時刻
createdTime date-time
フローの変更時刻
lastModifiedTime date-time
フローのテンプレート名
templateName string
フロー トリガー URI
flowTriggerUri string
フローのインストールの状態
installationStatus string

FlowListCallbackUrlResponse

名前 パス 説明
コールバック URL
response.value string

FlowWithConnectionReferences

名前 パス 説明
フロー名
name string
プロパティ
properties FlowWithConnectionReferencesProperties

FlowWithConnectionReferencesProperties

名前 パス 説明
フローの表示名
displayName string
フローの状態
state string
connectionReferences
connectionReferences ConnectionReferencesArray
フローの作成時刻
createdTime date-time
フローの変更時刻
lastModifiedTime date-time
フローのテンプレート名
templateName string
フロー トリガー URI
flowTriggerUri string
フローのインストールの状態
installationStatus string
作成者
creator UserIdentity
definitionSummary
definitionSummary DefinitionSummary

AdminFlow

名前 パス 説明
フロー名
name string
properties
properties AdminFlowProperties

AdminFlowWithoutDefinition

名前 パス 説明
フロー名
name string
properties
properties AdminFlowWithoutDefinitionProperties

AdminFlowProperties

名前 パス 説明
フローの表示名
displayName string
フローの状態
state string
connectionReferences
connectionReferences ConnectionReferencesDictionary
フローの作成時刻
createdTime date-time
フローの変更時刻
lastModifiedTime date-time
フローのテンプレート名
templateName string
フロー トリガー URI
flowTriggerUri string
フローのインストールの状態
installationStatus string
作成者
creator UserIdentity
definitionSummary
definitionSummary DefinitionSummary
estimatedSuspensionData
estimatedSuspensionData EstimatedSuspensionData

AdminFlowWithoutDefinitionProperties

名前 パス 説明
フローの表示名
displayName string
フローの状態
state string
フローの作成時刻
createdTime date-time
フローの変更時刻
lastModifiedTime date-time

AdminFlowWithConnectionReferences

名前 パス 説明
フロー名
name string
properties
properties AdminFlowWithConnectionReferencesProperties

AdminFlowWithConnectionReferencesProperties

名前 パス 説明
フローの表示名
displayName string
フローの状態
state string
connectionReferences
connectionReferences ConnectionReferencesArray
フローの作成時刻
createdTime date-time
フローの変更時刻
lastModifiedTime date-time
フローのテンプレート名
templateName string
フロー トリガー URI
flowTriggerUri string
フローのインストールの状態
installationStatus string
作成者
creator UserIdentity
definitionSummary
definitionSummary DefinitionSummary

EstimatedSuspensionData

名前 パス 説明
フローの推定中断理由
reason string
フローの推定中断時間
time date-time
フローが Power Apps プランの場合に除外するかどうか
powerAppPlanExcluded boolean

DefinitionSummary

名前 パス 説明
トリガー
triggers array of object
フロー トリガーの種類
triggers.type string
フロー トリガーの種類
triggers.kind string
アクション
actions array of object
アクションの種類
actions.type string
Swagger の操作 ID
actions.swaggerOperationId string
アクション API 名
actions.api.name string
アクション API ID
actions.api.id string
アクション API の種類
actions.api.type string

UserIdentity

名前 パス 説明
作成者のテナント ID
tenantId string
作成者のオブジェクト ID
objectId string
作成者のユーザー ID
userId string
作成者のユーザーの種類
userType string

環境

名前 パス 説明
環境名
name string
環境の場所
location string
プロパティ
properties EnvironmentProperties

EnvironmentProperties

名前 パス 説明
環境の表示名
displayName string
環境の説明
description string
環境の作成時刻
createdTime date-time
環境の最終変更時刻
lastModifiedTime date-time
環境のプロビジョニングの状態
provisioningState string
環境の作成の種類
creationType string
環境 SKU
environmentSku string
環境の種類
environmentType string
既定の環境
isDefault boolean

ConnectionReferencesArray

名前 パス 説明
項目
ConnectionReference

ConnectionReferencesDictionary

ConnectionReference

名前 パス 説明
接続名
connectionName string
接続の表示名
displayName string
コネクタ ID
id string
埋め込みまたは呼び出し接続のいずれか
source string
接続参照の論理名
connectionReferenceLogicalName string
apiDefinition
apiDefinition ApiWithoutConnectionParameters

ApiWithoutConnectionParameters

名前 パス 説明
コネクタ名
name string
プロパティ
properties ApiPropertiesWithoutConnectionParameters

ApiPropertiesWithoutConnectionParameters

名前 パス 説明
コネクタの表示名
displayName string
接続の作成時刻
createdTime date-time
コネクタ ランタイム URL
primaryRuntimeUrl string
コネクタ アイコン URI
iconUri string
コネクタはカスタム API
isCustomApi boolean
コネクタの階層
tier string

ConnectionWithoutConnectionParameters

名前 パス 説明
接続名
name string
プロパティ
properties ConnectionPropertiesWithoutConnectionParameters

ConnectionPropertiesWithoutConnectionParameters

名前 パス 説明
コネクタの表示名
displayName string
コネクタ ID
apiId string
接続の作成時刻
createdTime date-time
接続の最終変更時刻
lastModifiedTime date-time