Управление Power Automate

Соединитель Power Automate Management позволяет взаимодействовать со службой Управления Power Automate. Например, создание, редактирование и обновление потоков. Администраторы, которые хотят выполнять операции с правами администратора, должны вызывать действия с суффиксом "как администратор". Проверка подлинности субъекта-службы поддерживается только для административных действий.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Стандарт	Все регионы 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

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

Проверка подлинности сертификата клиента	Предоставление учетных данных идентификатора Microsoft Entra с помощью сертификата и пароля PFX	Все регионы	Недоступен для совместного использования
Интегрированный идентификатор Microsoft Entra	Используйте идентификатор Microsoft Entra для доступа к этой службе.	Все регионы	Недоступен для совместного использования
По умолчанию [не рекомендуется]	Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.	Все регионы	Недоступен для совместного использования

Проверка подлинности сертификата клиента

Идентификатор проверки подлинности: CertOauth

Применимо: все регионы

Предоставление учетных данных идентификатора Microsoft Entra с помощью сертификата и пароля PFX

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Tenant	струна		True
Идентификатор клиента	струна	Идентификатор клиента для приложения Идентификатора Microsoft Entra
Секрет сертификата клиента	клиентский сертификат	Секрет сертификата клиента, разрешенный этим приложением	True

Microsoft Entra id Integrated

Идентификатор проверки подлинности: firstParty

Применимо: все регионы

Используйте идентификатор Microsoft Entra для доступа к этой службе.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

По умолчанию [не рекомендуется]

Применимо: все регионы

Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	5	60 секунд
Запросы, отличные от получения для каждого подключения	300	3600 секунд

Действия

URL-адрес обратного вызова списка	Список URL-адреса обратного вызова для заданного потока в среде.
Включение потока	Запустите заданный поток в среде.
Владельцы потока списка	Вывод списка всех владельцев заданного потока в среде.
Восстановление удаленного потока от имени администратора	Восстановите указанный обратимо удаленный поток в среде, к которой у вас есть доступ администратора.
Вывод списка моих подключений	Выводит список всех подключений, доступных в данной среде.
Вывод списка соединителей	Перечисляет все соединители, доступные в данной среде. Этот список включает пользовательские соединители, а также встроенные соединители.
Выполнение потока отмены	Отмена выполнения потока.
Изменение Run-Only пользователей	Измените пользователей только для запуска заданного потока в среде.
Изменение владельцев потока	Изменение владельцев заданного потока в среде.
Изменение владельцев потоков в качестве администратора	Измените владельцев заданного потока, созданного в среде, к которой у вас есть доступ администратора.
Отключение потока	Остановите заданный поток в среде.
Перечисление моих потоков	Перечислить все потоки, созданные в данной среде.
Перечисление моих сред	Список сред, к к которых у вас есть доступ.
Перечисление потоков от имени администратора (версия 2)	Перечислить все потоки в заданной среде, к которой у вас есть доступ администратора. Это действие версии 2 — это действие с более высокой производительностью, которое возвращает только сведения об потоке. Определение потока и большая часть метаданных не возвращаются. Для получения дополнительных метаданных и определения потока выполните последующий вызов действия Get Flow в качестве администратора.
Повторная отправка потока	Повторная отправка заданного потока в среде.
Получение потока	Получение заданного потока в среде.
Получение потока от имени администратора	Получите заданный поток из среды, к которой у вас есть доступ администратора.
Получение соединителя	Получите указанный соединитель в среде.
Пользователи потока списка Run-Only	Список всех запускаемых пользователей заданного потока в среде.
Поток обновления	Обновите заданный поток в среде.
Создание подключения	Создайте подключение для данного соединителя в среде.
Создание потока	Создание потока
Удаление потока	Удаление заданного потока в среде

URL-адрес обратного вызова списка

Идентификатор операции:

ListCallbackUrl

Список URL-адреса обратного вызова для заданного потока в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток

Возвращаемое значение

Тело

FlowListCallbackUrlResponse

Включение потока

Идентификатор операции:

StartFlow

Запустите заданный поток в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток

Владельцы потока списка

Идентификатор операции:

ListFlowOwners

Вывод списка всех владельцев заданного потока в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток

Возвращаемое значение

Тело

ResourceArray[FlowPermission]

Восстановление удаленного потока от имени администратора

Идентификатор операции:

AdminRestoreFlow

Восстановите указанный обратимо удаленный поток в среде, к которой у вас есть доступ администратора.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток

Возвращаемое значение

Тело

AdminFlowWithConnectionReferences

Вывод списка моих подключений

Идентификатор операции:

ListConnections

Выводит список всех подключений, доступных в данной среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды

Возвращаемое значение

Тело

ResourceArray[ConnectionWithoutConnectionParameters]

Вывод списка соединителей

Идентификатор операции:

ListApis

Перечисляет все соединители, доступные в данной среде. Этот список включает пользовательские соединители, а также встроенные соединители.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды

Возвращаемое значение

Тело

ResourceArray[ApiWithoutConnectionParameters]

Выполнение потока отмены

Идентификатор операции:

CancelFlowRun

Отмена выполнения потока.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток
Идентификатор запуска	runId	True	string	Идентификатор потока выполняется для повторного отправки.

Изменение Run-Only пользователей

Идентификатор операции:

ModifyRunOnlyUsers

Измените пользователей только для запуска заданного потока в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток
Добавление идентификатора объекта пользователя	id	True	string
Добавление типа пользователя	type	True	string
Удаление идентификатора объекта пользователя	id	True	string
Удаление типа пользователя	type	True	string

Изменение владельцев потока

Идентификатор операции:

ModifyFlowOwners

Изменение владельцев заданного потока в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток
Добавление идентификатора объекта пользователя	id	True	string
Добавление типа пользователя	type	True	string
Удаление идентификатора объекта пользователя	id	True	string
Удаление типа пользователя	type	True	string

Изменение владельцев потоков в качестве администратора

Идентификатор операции:

AdminModifyFlowOwners

Измените владельцев заданного потока, созданного в среде, к которой у вас есть доступ администратора.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток
Добавление идентификатора объекта пользователя	id	True	string
Добавление типа пользователя	type	True	string
Удаление идентификатора объекта пользователя	id	True	string
Удаление типа пользователя	type	True	string

Отключение потока

Идентификатор операции:

StopFlow

Остановите заданный поток в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток

Перечисление моих потоков

Идентификатор операции:

ListMyFlows

Перечислить все потоки, созданные в данной среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды

Возвращаемое значение

Тело

ResourceArray[AdminFlow]

Перечисление моих сред

Идентификатор операции:

ListUserEnvironments

Список сред, к к которых у вас есть доступ.

Возвращаемое значение

Тело

ResourceArray[Environment]

Перечисление потоков от имени администратора (версия 2)

Идентификатор операции:

ListFlowsInEnvironment_V2

Перечислить все потоки в заданной среде, к которой у вас есть доступ администратора. Это действие версии 2 — это действие с более высокой производительностью, которое возвращает только сведения об потоке. Определение потока и большая часть метаданных не возвращаются. Для получения дополнительных метаданных и определения потока выполните последующий вызов действия Get Flow в качестве администратора.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Первое число	$top		integer	Первое число
Разверните сведения о приостановке	expandSuspensionInfo		boolean	Расширяет сведения о приостановке
Включение потоков Soft-Deleted	includeSoftDeletedFlows		boolean	Следует ли включать обратимо удаленные потоки.

Возвращаемое значение

Тело

ResourceArray[AdminFlowWithoutDefinition]

Повторная отправка потока

Идентификатор операции:

ResubmitFlow

Повторная отправка заданного потока в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток
Имя триггера	triggerName	True	string	Имя триггера потока для повторной отправки.
Идентификатор запуска	runId	True	string	Идентификатор потока выполняется для повторного отправки.

Получение потока

Идентификатор операции:

GetFlow

Получение заданного потока в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток

Возвращаемое значение

Тело

FlowWithConnectionReferences

Получение потока от имени администратора

Идентификатор операции:

AdminGetFlow

Получите заданный поток из среды, к которой у вас есть доступ администратора.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток
Включение определения потока	includeFlowDefinition		boolean	Следует ли включать определение потока.

Возвращаемое значение

Тело

AdminFlowWithConnectionReferences

Получение соединителя

Идентификатор операции:

GetApi

Получите указанный соединитель в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Connector	apiName	True	string	Выбор соединителя

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Пользователи потока списка Run-Only

Идентификатор операции:

ListFlowUsers

Список всех запускаемых пользователей заданного потока в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток

Возвращаемое значение

Тело

ResourceArray[FlowPermission]

Поток обновления

Идентификатор операции:

UpdateFlow

Обновите заданный поток в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	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
Идентификатор клиента Creator	tenantId	True	string
Идентификатор объекта Creator	objectId		string
Идентификатор пользователя Creator	userId	True	string
Тип пользователя Creator	userType	True	string
Тип триггера потока	type		string
Тип триггера потока	kind		string
Тип действия	type		string
Идентификатор операции Swagger	swaggerOperationId		string
Имя API действий	name		string
Идентификатор API действий	id		string
Тип API действий	type		string

Возвращаемое значение

Тело

Flow

Создание подключения

Идентификатор операции:

CreateConnection

Создайте подключение для данного соединителя в среде.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Connector	apiName	True	string	Выбор соединителя
connection	connection		dynamic	Подключение

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Создание потока

Идентификатор операции:

CreateFlow

Создание потока

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	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
Идентификатор клиента Creator	tenantId	True	string
Идентификатор объекта Creator	objectId		string
Идентификатор пользователя Creator	userId	True	string
Тип пользователя Creator	userType	True	string
Тип триггера потока	type		string
Тип триггера потока	kind		string
Тип действия	type		string
Идентификатор операции Swagger	swaggerOperationId		string
Имя API действий	name		string
Идентификатор API действий	id		string
Тип API действий	type		string

Возвращаемое значение

Тело

Flow

Удаление потока

Идентификатор операции:

DeleteFlow

Удаление заданного потока в среде

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Окружающая среда	environmentName	True	string	Выбор среды
Flow	flowName	True	string	Выбрать поток

Определения

ResourceArray[ApiWithoutConnectionParameters]

Имя	Путь	Тип	Описание
value	value	array of ApiWithoutConnectionParameters

ResourceArray[ConnectionWithoutConnectionParameters]

Имя	Путь	Тип	Описание
value	value	array of ConnectionWithoutConnectionParameters

ResourceArray[Среда]

Имя	Путь	Тип	Описание
value	value	array of Environment

ResourceArray[AdminFlow]

Имя	Путь	Тип	Описание
value	value	array of AdminFlow

ResourceArray[AdminFlowWithoutDefinition]

Имя	Путь	Тип	Описание
value	value	array of AdminFlowWithoutDefinition

ResourceArray[FlowPermission]

Имя	Путь	Тип	Описание
value	value	array of FlowPermission

FlowPermission

Имя	Путь	Тип	Описание
Имя разрешения	name	string
properties	properties	PermissionProperties

PermissionProperties

Имя	Путь	Тип	Описание
roleName	roleName	string
основной	principal	Principal

Директор

Имя	Путь	Тип	Описание
Идентификатор объекта	id	string
Отображаемое имя	displayName	string
Адрес электронной почты	email	string
Тип	type	string
Идентификатор арендатора	tenantId	string
Основное имя	userPrincipalName	string
Фотография эскиза владельца	thumbnailPhoto	string

Flow

Имя	Путь	Тип	Описание
Имя потока	name	string
properties	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	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 app исключен или нет	powerAppPlanExcluded	boolean

DefinitionSummary

Имя	Путь	Тип	Описание
триггеры	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 действий	actions.api.id	string
Тип API действий	actions.api.type	string

UserIdentity

Имя	Путь	Тип	Описание
Идентификатор клиента Creator	tenantId	string
Идентификатор объекта Creator	objectId	string
Идентификатор пользователя Creator	userId	string
Тип пользователя Creator	userType	string

Окружающая среда

Имя	Путь	Тип	Описание
Имя среды	name	string
Расположение среды	location	string
properties	properties	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	string
Встроенное или вызывающее подключение	source	string
Логическое имя ссылки на подключение	connectionReferenceLogicalName	string
apiОпределение	apiDefinition	ApiWithoutConnectionParameters

ApiWithoutConnectionParameters

Имя	Путь	Тип	Описание
Имя соединителя	name	string
properties	properties	ApiPropertiesWithoutConnectionParameters

ApiPropertiesWithoutConnectionParameters

Имя	Путь	Тип	Описание
Отображаемое имя соединителя	displayName	string
Время создания подключения	createdTime	date-time
URL-адрес среды выполнения соединителя	primaryRuntimeUrl	string
URL-адрес значка соединителя	iconUri	string
Соединитель — это настраиваемый API	isCustomApi	boolean
Уровень соединителя	tier	string

ConnectionWithoutConnectionParameters

Имя	Путь	Тип	Описание
Имя подключения	name	string
properties	properties	ConnectionPropertiesWithoutConnectionParameters

ConnectionPropertiesWithoutConnectionParameters

Имя	Путь	Тип	Описание
Отображаемое имя соединителя	displayName	string
Идентификатор соединителя	apiId	string
Время создания подключения	createdTime	date-time
Время последнего изменения подключения	lastModifiedTime	date-time