다음을 통해 공유


Power Automate 관리

Power Automate 관리 커넥터를 사용하면 Power Automate 관리 서비스와 상호 작용할 수 있습니다. 예를 들어 흐름 만들기, 편집 및 업데이트입니다. 관리자 권한으로 작업을 수행하려는 관리자는 'as Admin' 접미사를 사용하여 작업을 호출해야 합니다. 서비스 주체 인증은 관리 작업에 대해서만 지원됩니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio 스탠다드 모든 Power Automate 지역
Power Apps 스탠다드 모든 Power Apps 지역
Power Automate 스탠다드 모든 Power Automate 지역
연락처
이름 Microsoft
URL Microsoft Power Automate 지원
Microsoft Power Apps 지원
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://make.powerautomate.com/

일반 제한

이름 가치
계정당 연결 50

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

클라이언트 인증서 인증 PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공 모든 지역 공유할 수 없음
Microsoft Entra ID 통합 Microsoft Entra ID를 사용하여 이 서비스에 액세스합니다. 모든 지역 공유할 수 없음
기본값 [사용되지 않음] 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. 모든 지역 공유할 수 없음

클라이언트 인증서 인증

인증 ID: CertOauth

적용 가능: 모든 지역

PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
임차인 문자열 진실
클라이언트 ID 문자열 Microsoft Entra ID 애플리케이션의 클라이언트 ID
클라이언트 인증서 비밀 클라이언트 인증서 이 애플리케이션에서 허용하는 클라이언트 인증서 비밀 진실

Microsoft Entra ID 통합

인증 ID: firstParty

적용 가능: 모든 지역

Microsoft Entra ID를 사용하여 이 서비스에 액세스합니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

기본값 [사용되지 않음]

적용 가능: 모든 지역

이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

제한 한도

Name 호출 갱신 기간
연결당 API 호출 5 60초
연결당 비 가져오기 요청 300 3600초

동작

Flow를 관리자로 가져오기

관리자 액세스 권한이 있는 환경에서 지정된 흐름을 가져옵니다.

Run-Only 사용자 수정

환경에서 지정된 흐름의 실행 전용 사용자를 수정합니다.

관리자로 흐름 나열(V2)

관리자가 액세스할 수 있는 지정된 환경의 모든 흐름을 나열합니다. 이 V2 작업은 흐름에 대한 식별 정보만 반환하는 더 높은 성능 작업입니다. 흐름 정의 및 대부분의 메타데이터가 반환되지 않습니다. 추가 메타데이터 및 흐름 정의의 경우 흐름 가져오기 작업을 관리자로 호출합니다.

내 연결 나열

지정된 환경에서 사용할 수 있는 모든 연결을 나열합니다.

내 환경 나열

액세스할 수 있는 환경을 나열합니다.

내 흐름 나열

지정된 환경에서 만든 모든 흐름을 나열합니다.

삭제된 흐름을 관리자로 복원

관리자가 액세스할 수 있는 환경에서 지정된 일시 삭제된 흐름을 복원합니다.

연결 만들기

환경에서 지정된 커넥터에 대한 연결을 만듭니다.

커넥터 가져오기

환경에서 지정된 커넥터를 가져옵니다.

커넥터 나열

지정된 환경에서 사용할 수 있는 모든 커넥터를 나열합니다. 이 목록에는 사용자 지정 커넥터와 기본 제공 커넥터가 포함됩니다.

콜백 URL 나열

환경에서 지정된 흐름에 대한 콜백 URL을 나열합니다.

흐름 Run-Only 사용자 나열

환경에서 지정된 흐름의 모든 실행 사용자만 나열합니다.

흐름 가져오기

환경에서 지정된 흐름을 가져옵니다.

흐름 끄기

환경에서 지정된 흐름을 중지합니다.

흐름 다시 제출

환경에서 지정된 흐름 실행을 다시 제출합니다.

흐름 만들기

흐름 만들기

흐름 삭제

환경에서 지정된 흐름을 삭제합니다.

흐름 소유자 나열

환경에서 지정된 흐름의 모든 소유자를 나열합니다.

흐름 소유자 수정

환경에서 지정된 흐름의 소유자를 수정합니다.

흐름 소유자를 관리자로 수정

관리자 액세스 권한이 있는 환경에서 만든 지정된 흐름의 소유자를 수정합니다.

흐름 실행 취소

흐름 실행을 취소합니다.

흐름 업데이트

환경에서 지정된 흐름을 업데이트합니다.

흐름 켜기

환경에서 지정된 흐름을 시작합니다.

Flow를 관리자로 가져오기

관리자 액세스 권한이 있는 환경에서 지정된 흐름을 가져옵니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

흐름 정의 포함
includeFlowDefinition boolean

흐름 정의를 포함할지 여부입니다.

반환

Run-Only 사용자 수정

환경에서 지정된 흐름의 실행 전용 사용자를 수정합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

사용자 개체 ID 추가
id True string
사용자 유형 추가
type True string
사용자 개체 ID 제거
id True string
사용자 유형 제거
type True string

관리자로 흐름 나열(V2)

관리자가 액세스할 수 있는 지정된 환경의 모든 흐름을 나열합니다. 이 V2 작업은 흐름에 대한 식별 정보만 반환하는 더 높은 성능 작업입니다. 흐름 정의 및 대부분의 메타데이터가 반환되지 않습니다. 추가 메타데이터 및 흐름 정의의 경우 흐름 가져오기 작업을 관리자로 호출합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

상위 개수
$top integer

상위 개수

일시 중단 정보 확장
expandSuspensionInfo boolean

일시 중단 정보를 확장합니다.

Soft-Deleted 흐름 포함
includeSoftDeletedFlows boolean

일시 삭제된 흐름을 포함할지 여부입니다.

반환

내 연결 나열

지정된 환경에서 사용할 수 있는 모든 연결을 나열합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

반환

내 환경 나열

액세스할 수 있는 환경을 나열합니다.

반환

내 흐름 나열

지정된 환경에서 만든 모든 흐름을 나열합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

반환

삭제된 흐름을 관리자로 복원

관리자가 액세스할 수 있는 환경에서 지정된 일시 삭제된 흐름을 복원합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

반환

연결 만들기

환경에서 지정된 커넥터에 대한 연결을 만듭니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Connector
apiName True string

커넥터 선택

connection
connection dynamic

Connection

반환

이 작업의 출력은 동적입니다.

커넥터 가져오기

환경에서 지정된 커넥터를 가져옵니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Connector
apiName True string

커넥터 선택

반환

이 작업의 출력은 동적입니다.

커넥터 나열

지정된 환경에서 사용할 수 있는 모든 커넥터를 나열합니다. 이 목록에는 사용자 지정 커넥터와 기본 제공 커넥터가 포함됩니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

반환

콜백 URL 나열

환경에서 지정된 흐름에 대한 콜백 URL을 나열합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

반환

흐름 Run-Only 사용자 나열

환경에서 지정된 흐름의 모든 실행 사용자만 나열합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

반환

흐름 가져오기

환경에서 지정된 흐름을 가져옵니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

반환

흐름 끄기

환경에서 지정된 흐름을 중지합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

흐름 다시 제출

환경에서 지정된 흐름 실행을 다시 제출합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

트리거 이름
triggerName True string

다시 제출할 흐름 트리거의 이름입니다.

실행 ID
runId True string

다시 제출할 흐름의 ID입니다.

흐름 만들기

흐름 만들기

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

흐름 이름
name string
흐름 표시 이름
displayName True string
흐름 상태
state True string
연결 이름
connectionName string
연결 표시 이름
displayName string
커넥터 ID
id True string
Embedded 또는 Invoker 연결
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
작성자 테넌트 ID
tenantId True string
Creator 개체 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

흐름 삭제

환경에서 지정된 흐름을 삭제합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

흐름 소유자 나열

환경에서 지정된 흐름의 모든 소유자를 나열합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

반환

흐름 소유자 수정

환경에서 지정된 흐름의 소유자를 수정합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

사용자 개체 ID 추가
id True string
사용자 유형 추가
type True string
사용자 개체 ID 제거
id True string
사용자 유형 제거
type True string

흐름 소유자를 관리자로 수정

관리자 액세스 권한이 있는 환경에서 만든 지정된 흐름의 소유자를 수정합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

사용자 개체 ID 추가
id True string
사용자 유형 추가
type True string
사용자 개체 ID 제거
id True string
사용자 유형 제거
type True string

흐름 실행 취소

흐름 실행을 취소합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

실행 ID
runId True string

다시 제출할 흐름의 ID입니다.

흐름 업데이트

환경에서 지정된 흐름을 업데이트합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

흐름 이름
name string
흐름 표시 이름
displayName True string
흐름 상태
state True string
연결 이름
connectionName string
연결 표시 이름
displayName string
커넥터 ID
id True string
Embedded 또는 Invoker 연결
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
작성자 테넌트 ID
tenantId True string
Creator 개체 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

흐름 켜기

환경에서 지정된 흐름을 시작합니다.

매개 변수

Name 필수 형식 Description
환경
environmentName True string

환경 선택

Flow
flowName True string

흐름 선택

정의

ResourceArray[ApiWithoutConnectionParameters]

Name 경로 형식 Description
value
value array of ApiWithoutConnectionParameters

ResourceArray[ConnectionWithoutConnectionParameters]

Name 경로 형식 Description
value
value array of ConnectionWithoutConnectionParameters

ResourceArray[환경]

Name 경로 형식 Description
value
value array of Environment

ResourceArray[AdminFlow]

Name 경로 형식 Description
value
value array of AdminFlow

ResourceArray[AdminFlowWithoutDefinition]

Name 경로 형식 Description
value
value array of AdminFlowWithoutDefinition

ResourceArray[FlowPermission]

Name 경로 형식 Description
value
value array of FlowPermission

FlowPermission

Name 경로 형식 Description
사용 권한 이름
name string
properties
properties PermissionProperties

PermissionProperties

Name 경로 형식 Description
roleName
roleName string
원금
principal Principal

교장

Name 경로 형식 Description
개체 ID
id string
표시 이름
displayName string
전자 메일
email string
유형
type string
테넌트 ID
tenantId string
주체 이름
userPrincipalName string
소유자 썸네일 사진
thumbnailPhoto string

Flow

Name 경로 형식 Description
흐름 이름
name string
properties
properties FlowProperties

플로우프로퍼티

Name 경로 형식 Description
흐름 표시 이름
displayName string
흐름 상태
state string
connectionReferences
connectionReferences ConnectionReferencesDictionary
흐름 생성 시간
createdTime date-time
흐름 수정 시간
lastModifiedTime date-time
흐름 템플릿 이름
templateName string
흐름 트리거 URI
flowTriggerUri string
흐름 설치 상태
installationStatus string

FlowListCallbackUrlResponse

Name 경로 형식 Description
콜백 URL
response.value string

FlowWithConnectionReferences

Name 경로 형식 Description
흐름 이름
name string
properties
properties FlowWithConnectionReferencesProperties

FlowWithConnectionReferencesProperties

Name 경로 형식 Description
흐름 표시 이름
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 경로 형식 Description
흐름 이름
name string
properties
properties AdminFlowProperties

AdminFlowWithoutDefinition

Name 경로 형식 Description
흐름 이름
name string
properties
properties AdminFlowWithoutDefinitionProperties

AdminFlowProperties

Name 경로 형식 Description
흐름 표시 이름
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

Name 경로 형식 Description
흐름 표시 이름
displayName string
흐름 상태
state string
흐름 생성 시간
createdTime date-time
흐름 수정 시간
lastModifiedTime date-time

AdminFlowWithConnectionReferences

Name 경로 형식 Description
흐름 이름
name string
properties
properties AdminFlowWithConnectionReferencesProperties

AdminFlowWithConnectionReferencesProperties

Name 경로 형식 Description
흐름 표시 이름
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

Name 경로 형식 Description
흐름 예상 일시 중단 이유
reason string
흐름 예상 일시 중단 시간
time date-time
흐름이 전원 앱 계획인 경우 제외 여부
powerAppPlanExcluded boolean

DefinitionSummary

Name 경로 형식 Description
트리거
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

Name 경로 형식 Description
작성자 테넌트 ID
tenantId string
Creator 개체 ID
objectId string
작성자 사용자 ID
userId string
작성자 사용자 유형
userType string

환경

Name 경로 형식 Description
환경 이름
name string
환경 위치
location string
properties
properties EnvironmentProperties

환경 속성

Name 경로 형식 Description
환경 표시 이름
displayName string
환경 설명
description string
환경 생성 시간
createdTime date-time
환경 마지막으로 수정된 시간
lastModifiedTime date-time
환경 프로비저닝 상태
provisioningState string
환경 만들기 유형
creationType string
환경 Sku
environmentSku string
환경 유형
environmentType string
기본 환경입니다.
isDefault boolean

ConnectionReferencesArray

Name 경로 형식 Description
아이템
ConnectionReference

ConnectionReferencesDictionary

ConnectionReference

Name 경로 형식 Description
연결 이름
connectionName string
연결 표시 이름
displayName string
커넥터 ID
id string
Embedded 또는 Invoker 연결
source string
연결 참조의 논리적 이름
connectionReferenceLogicalName string
API정의
apiDefinition ApiWithoutConnectionParameters

ApiWithoutConnectionParameters

Name 경로 형식 Description
커넥터 이름
name string
properties
properties ApiPropertiesWithoutConnectionParameters

ApiPropertiesWithoutConnectionParameters

Name 경로 형식 Description
커넥터 표시 이름
displayName string
연결 생성 시간
createdTime date-time
커넥터 런타임 URL
primaryRuntimeUrl string
커넥터 아이콘 URL
iconUri string
커넥터는 사용자 지정 API입니다.
isCustomApi boolean
커넥터 계층
tier string

ConnectionWithoutConnectionParameters

Name 경로 형식 Description
연결 이름
name string
properties
properties ConnectionPropertiesWithoutConnectionParameters

ConnectionPropertiesWithoutConnectionParameters

Name 경로 형식 Description
커넥터 표시 이름
displayName string
커넥터 ID
apiId string
연결 생성 시간
createdTime date-time
마지막으로 수정한 연결 시간
lastModifiedTime date-time