Service Bus
Azure Service Bus에 연결하여 메시지를 보내고 받습니다. 큐로 보내기, 토픽으로 보내기, 큐에서 수신, 구독에서 받기 등의 작업을 수행할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC High) |
| 논리 앱 | 스탠다드 | 모든 Logic Apps 지역 |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC High) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC High) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL |
Microsoft LogicApps 지원 Microsoft Power Automate 지원 Microsoft Power Apps 지원 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://azure.microsoft.com/services/service-bus/ |
일반적인 알려진 문제 및 제한 사항
무한 루프
커넥터 유형이 동일한 트리거와 작업을 모두 선택하고 큐 또는 토픽 구독과 같은 동일한 엔터티로 작업하는 데 사용할 때는 주의해야 합니다. 이 조합은 무한 루프를 만들 수 있으며, 이로 인해 워크플로가 종료되지 않습니다.
예를 들어 워크플로가 큐에서 새로 받은 메시지를 반환하고 메시지를 동일한 큐로 다시 보내는 Service Bus 작업으로 트리거를 따르는 Service Bus 트리거를 사용한다고 가정합니다. 이 패턴은 무한 루프를 만들 수 있으며, 이로 인해 무한 워크플로가 발생할 수 있습니다.
커넥터 캐시에 저장된 세션의 제한
구독 또는 토픽과 같은 Service Bus 메시징 엔터티당 Service Bus 커넥터는 커넥터 캐시에 한 번에 최대 1,500개의 고유한 세션을 저장할 수 있습니다. 세션 수가 이 한도를 초과하면 오래된 세션이 캐시에서 제거됩니다. 자세한 내용은 메시지 세션을 참조하세요.
긴 폴링 트리거
Azure Service Bus 관리 커넥터의 경우 모든 트리거는 긴 폴링입니다. 이 유형의 트리거는 모든 메시지를 처리한 다음, 더 많은 메시지가 큐 또는 토픽 구독에 나타날 때까지 30초 동안 기다립니다. 30초 동안 표시되는 메시지가 없으면 트리거 실행을 건너뜁니다. 그렇지 않으면 큐 또는 토픽 구독이 빈 상태가 될 때까지 트리거는 메시지를 계속 읽습니다. 다음 트리거 폴링은 트리거의 속성에 지정된 되풀이 간격을 기준으로 합니다.
Microsoft Entra ID 인증
Microsoft Entra ID 인증을 사용하려면 사용자 계정에 특정 역할 할당이 필요합니다. 자세한 내용은 액세스 권한에 대한 Azure 역할 할당 - Azure Service Bus를 참조하세요.
관리 ID 인증
현재 관리 ID 인증 은 Azure Logic Apps에 대해서만 지원됩니다.
논리 앱 워크플로에서 Service Bus 네임스페이스 및 메시징 엔터티로의 액세스를 인증하는 관리 ID를 사용하려면 해당 수준에서 역할 권한을 할당해야 합니다. 예를 들어 큐에 액세스하려면 해당 큐에 필요한 권한을 가진 역할이 관리 ID에 있어야 합니다.
다른 메시징 엔터티에 액세스하는 각 관리 ID에는 해당 엔터티에 대한 별도의 연결이 있어야 합니다. 다른 Azure Service Bus 작업을 사용하여 메시지를 보내고 받는 경우 이러한 작업에 다른 권한이 필요한 경우 다른 연결을 사용해야 합니다.
Azure Service Bus에서 관리 ID를 사용하도록 설정하려면 다음 개략적인 단계를 수행합니다.
논리 앱 리소스에 대한 관리 ID를 사용하거나 만듭니다. 자세한 내용은 Azure Logic Apps에서 관리 ID를 사용하여 Azure 리소스에 대한 액세스 인증을 참조하세요.
ID에 Azure Service Bus 리소스에 대한 액세스 권한을 부여합니다. 자세한 내용은 액세스 권한에 대한 Azure 역할 할당 - Azure Service Bus를 참조하세요.
사용자 할당 ID의 경우 논리 앱 리소스에 ID를 추가합니다. Azure Logic Apps의 관리 ID에 대한 자세한 내용은 Azure Logic Apps에서 관리 ID를 사용하여 Azure 리소스에 대한 액세스 인증을 참조하세요.
커넥터 심층 분석
이 문서에서는 Azure Logic Apps, Power Automate 및 Power Apps에 사용할 수 있는 Azure Service Bus 관리 커넥터에 대한 작업을 설명합니다. Azure Service Bus 기본 제공 커넥터는 Azure Logic Apps의 표준 논리 앱 워크플로에만 사용할 수 있습니다.
Azure Logic Apps의 Azure Service Bus 기본 제공 커넥터 및 관리형 커넥터에 대한 자세한 내용은 Azure Logic Apps의 워크플로에서 Azure Service Bus에 연결을 참조하세요.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 액세스 키 | Azure Service Bus에 액세스하기 위한 연결 문자열을 제공합니다. | Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역 | 공유할 수 없음 |
| 액세스 키(Azure Government) | Azure Service Bus에 액세스하기 위한 연결 문자열을 제공합니다. | Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure 정부 및 국방부(DoD)만 | 공유할 수 없음 |
| 클라이언트 인증서 인증 | PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공 | 모든 지역 | 공유 가능 |
| Logic Apps 앱 관리 ID | LogicApps 관리 ID를 사용하여 연결 만들기 | LOGICAPPS만 | 공유 가능 |
| Microsoft Entra ID 통합 | Microsoft Entra ID를 사용하여 Azure Service Bus에 액세스합니다. | Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역 | 공유할 수 없음 |
| Microsoft Entra ID 통합(Azure Government) | Microsoft Entra ID를 사용하여 Azure Service Bus에 액세스합니다. | Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure 정부 및 국방부(DoD)만 | 공유할 수 없음 |
| 기본값 [사용되지 않음] | 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. | 모든 지역 | 공유할 수 없음 |
액세스 키
인증 ID: connectionstringauth
적용 가능: Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역
Azure Service Bus에 액세스하기 위한 연결 문자열을 제공합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 연결 문자열 | 시큐어스트링 (보안 문자열) | Azure Service Bus 연결 문자열 | 진실 |
액세스 키(Azure Government)
인증 ID: connectionstringauth
적용 가능: Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)
Azure Service Bus에 액세스하기 위한 연결 문자열을 제공합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 연결 문자열 | 시큐어스트링 (보안 문자열) | Azure Service Bus 연결 문자열 | 진실 |
클라이언트 인증서 인증
인증 ID: CertOauth
적용 가능: 모든 지역
PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공
공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 임차인 | 문자열 | 진실 | |
| 클라이언트 ID | 문자열 | Microsoft Entra ID 애플리케이션의 클라이언트 ID | 진실 |
| 클라이언트 인증서 비밀 | 클라이언트 인증서 | 이 애플리케이션에서 허용하는 클라이언트 인증서 비밀 | 진실 |
| 네임스페이스 엔드포인트 | 문자열 | Service Bus 네임스페이스 엔드포인트 제공(예: sb://testsb.servicebus.windows.net/) | 진실 |
Logic Apps 관리 ID
인증 ID: managedIdentityAuth
적용 가능: LOGICAPPS만 해당
LogicApps 관리 ID를 사용하여 연결 만들기
공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| LogicApps 관리 ID | 관리되는 ID | Logic Apps 관리 ID로 로그인 | 진실 |
| 네임스페이스 엔드포인트 | 문자열 | Service Bus 네임스페이스 엔드포인트 제공(예: sb://testsb.servicebus.windows.net/) | 진실 |
Microsoft Entra ID 통합
인증 ID: aadAuth
적용 가능: Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역
Microsoft Entra ID를 사용하여 Azure Service Bus에 액세스합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 네임스페이스 엔드포인트 | 문자열 | Service Bus 네임스페이스 엔드포인트 제공(예: sb://testsb.servicebus.windows.net/) | 진실 |
Microsoft Entra ID 통합(Azure Government)
인증 ID: aadAuth
적용 가능: Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)
Microsoft Entra ID를 사용하여 Azure Service Bus에 액세스합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 네임스페이스 엔드포인트 | 문자열 | Service Bus 네임스페이스 엔드포인트 제공(예: sb://testsb.servicebus.windows.net/) | 진실 |
기본값 [사용되지 않음]
적용 가능: 모든 지역
이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 연결 문자열 | 시큐어스트링 (보안 문자열) | Azure Service Bus 연결 문자열 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 6000 | 60초 |
동작
| 메시지 보내기 |
이 작업은 큐 또는 토픽에 메시지를 보냅니다. |
| 큐에서 메시지 가져오기(peek-lock) |
이 작업은 피킹 잠금이 있는 큐에서 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다. |
| 큐에서 메시지 연기 |
이 작업은 큐의 메시지를 연기합니다. |
| 큐에서 메시지 완료 |
작업이 큐의 메시지를 완료합니다. |
| 큐에서 메시지 중단 |
이 작업은 큐에서 메시지를 중단합니다. |
| 큐에서 세션 닫기 |
작업은 큐의 세션을 닫습니다. |
| 큐에서 지연된 메시지 가져오기 |
작업은 큐에서 지연된 메시지를 가져옵니다. |
| 큐의 메시지 배달 못 한 편지 |
이 작업은 메시지를 Dead-Letter 큐로 이동합니다. |
| 큐의 메시지 잠금 갱신 |
작업은 큐의 메시지에 대한 잠금을 갱신합니다. |
| 큐의 세션에 대한 잠금 갱신 |
작업은 큐에서 세션을 갱신합니다. |
| 토픽 구독 만들기 |
작업에서 토픽 구독을 만듭니다. |
| 토픽 구독 삭제 |
작업에서 토픽 구독을 삭제합니다. |
| 토픽 구독에서 메시지 가져오기(피킹 잠금) |
작업은 피킹 잠금을 사용하여 토픽 구독에서 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다. |
| 토픽 구독에서 메시지 연기 |
이 작업은 토픽 구독의 메시지를 연기합니다. |
| 토픽 구독에서 메시지 완료 |
작업은 토픽 구독의 메시지를 완료합니다. |
| 토픽 구독에서 메시지 잠금 갱신 |
작업은 토픽 구독의 메시지에 대한 잠금을 갱신합니다. |
| 토픽 구독에서 메시지 중단 |
토픽 구독에서 메시지가 중단됩니다. |
| 토픽 구독에서 세션 잠금 갱신 |
작업은 토픽 구독에서 세션을 갱신합니다. |
| 토픽 구독에서 지연된 메시지 가져오기 |
작업은 토픽 구독에서 지연된 메시지를 가져옵니다. |
| 토픽 구독의 메시지 배달 못 한 편지 |
이 작업은 메시지를 큐에 Dead-Letter 토픽으로 이동합니다. |
| 토픽의 세션 닫기 |
이 작업은 토픽의 세션을 닫습니다. |
| 하나 이상의 메시지 보내기 |
이 작업은 큐 또는 토픽에 하나 이상의 메시지를 보냅니다. |
메시지 보내기
이 작업은 큐 또는 토픽에 메시지를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐/토픽 이름
|
entityName | True | string |
큐 또는 토픽의 이름 |
|
Content
|
ContentData | byte |
메시지의 내용 |
|
|
콘텐츠 형식
|
ContentType | string |
메시지 콘텐츠의 콘텐츠 형식 |
|
|
속성
|
Properties | object |
조정된 각 속성에 대한 키-값 쌍 |
|
|
메시지 ID
|
MessageId | string |
이 값은 Service Bus가 중복 메시지를 식별하는 데 사용할 수 있는 사용자 정의 값입니다(사용하도록 설정된 경우). |
|
|
에게
|
To | string |
주소로 보내기 |
|
|
회신
|
ReplyTo | string |
회신할 큐의 주소 |
|
|
세션 ID에 회신
|
ReplyToSessionId | string |
회신할 세션의 식별자 |
|
|
라벨
|
Label | string |
애플리케이션별 레이블 |
|
|
ScheduledEnqueueTimeUtc
|
ScheduledEnqueueTimeUtc | date-time |
메시지가 큐에 추가될 날짜 및 시간(UTC)입니다. |
|
|
세션 ID
|
SessionId | string |
세션의 식별자 |
|
|
상관 관계 ID
|
CorrelationId | string |
상관 관계 식별자 |
|
|
시퀀스 번호
|
SequenceNumber | integer |
시퀀스 번호의 식별자 |
|
|
잠금 토큰
|
LockToken | string |
메시지의 잠금 토큰을 문자열로 사용합니다. |
|
|
Time To Live
|
TimeToLive | integer |
메시지가 유효한 기간(틱 단위)입니다. 기간은 메시지가 Service Bus로 전송되는 시점부터 시작됩니다. |
|
|
시스템 속성
|
systemProperties | string |
시스템 속성 - 없음 또는 실행 세부 정보입니다. 실행 세부 정보는 메시지에 사용자 지정 속성으로 실행 메타데이터 속성 세부 정보를 추가합니다. |
큐에서 메시지 가져오기(peek-lock)
이 작업은 피킹 잠금이 있는 큐에서 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
최대 메시지 수
|
maxMessageCount | integer |
일괄 처리에서 반환할 최대 메시지 수 |
|
|
큐 유형
|
queueType | string |
큐 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID |
반환
- response
- array of ServiceBusMessage
큐에서 메시지 연기
이 작업은 큐의 메시지를 연기합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
메시지의 잠금 토큰
|
lockToken | True | string |
지연할 메시지의 잠금 토큰 |
|
큐 유형
|
queueType | string |
큐 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID |
큐에서 메시지 완료
작업이 큐의 메시지를 완료합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
메시지의 잠금 토큰
|
lockToken | True | string |
완료할 메시지의 잠금 토큰 |
|
큐 유형
|
queueType | string |
큐 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID |
큐에서 메시지 중단
이 작업은 큐에서 메시지를 중단합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
메시지의 잠금 토큰
|
lockToken | True | string |
중단할 메시지의 잠금 토큰 |
|
큐 유형
|
queueType | string |
큐 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID |
큐에서 세션 닫기
작업은 큐의 세션을 닫습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
세션 ID
|
sessionId | True | string |
세션 ID |
큐에서 지연된 메시지 가져오기
작업은 큐에서 지연된 메시지를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
메시지 시퀀스 번호
|
sequenceNumber | True | integer |
메시지 시퀀스 번호 |
|
큐 유형
|
queueType | string |
큐 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID |
반환
Service Bus 메시지
큐의 메시지 배달 못 한 편지
이 작업은 메시지를 Dead-Letter 큐로 이동합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
메시지의 잠금 토큰
|
lockToken | True | string |
메시지의 토큰을 배달 못 한 편지로 잠금 |
|
세션 ID
|
sessionId | string |
세션 ID |
|
|
배달 못한 편지 이유
|
deadLetterReason | string |
배달 못한 편지 이유 |
|
|
배달 못한 편지 오류 설명
|
deadLetterErrorDescription | string |
배달 못한 편지 오류 설명 |
큐의 메시지 잠금 갱신
작업은 큐의 메시지에 대한 잠금을 갱신합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
메시지의 잠금 토큰
|
lockToken | True | string |
잠금을 갱신하는 메시지의 잠금 토큰 |
|
큐 유형
|
queueType | string |
큐 유형 - Main 또는 DeadLetter |
큐의 세션에 대한 잠금 갱신
작업은 큐에서 세션을 갱신합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
세션 ID
|
sessionId | True | string |
세션 ID |
토픽 구독 만들기
작업에서 토픽 구독을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
Filter
|
subscriptionFilter | True | dynamic |
구독 필터 |
|
필터 형식
|
subscriptionFilterType | string |
필터 형식 |
반환
토픽 구독입니다.
토픽 구독 삭제
작업에서 토픽 구독을 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
토픽 구독에서 메시지 가져오기(피킹 잠금)
작업은 피킹 잠금을 사용하여 토픽 구독에서 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
최대 메시지 수
|
maxMessageCount | integer |
일괄 처리에서 반환할 최대 메시지 수 |
|
|
구독 유형
|
subscriptionType | string |
구독 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID |
반환
- response
- array of ServiceBusMessage
토픽 구독에서 메시지 연기
이 작업은 토픽 구독의 메시지를 연기합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
메시지의 잠금 토큰
|
lockToken | True | string |
지연할 메시지의 잠금 토큰 |
|
구독 유형
|
subscriptionType | string |
구독 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID |
토픽 구독에서 메시지 완료
작업은 토픽 구독의 메시지를 완료합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
메시지의 잠금 토큰
|
lockToken | True | string |
완료할 메시지의 잠금 토큰 |
|
구독 유형
|
subscriptionType | string |
구독 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID |
토픽 구독에서 메시지 잠금 갱신
작업은 토픽 구독의 메시지에 대한 잠금을 갱신합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
메시지의 잠금 토큰
|
lockToken | True | string |
잠금을 갱신하는 메시지의 잠금 토큰 |
|
구독 유형
|
subscriptionType | string |
구독 유형 - Main 또는 DeadLetter |
토픽 구독에서 메시지 중단
토픽 구독에서 메시지가 중단됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
메시지의 잠금 토큰
|
lockToken | True | string |
중단할 메시지의 잠금 토큰 |
|
구독 유형
|
subscriptionType | string |
구독 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID |
토픽 구독에서 세션 잠금 갱신
작업은 토픽 구독에서 세션을 갱신합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
세션 ID
|
sessionId | True | string |
세션 ID |
토픽 구독에서 지연된 메시지 가져오기
작업은 토픽 구독에서 지연된 메시지를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
메시지 시퀀스 번호
|
sequenceNumber | True | integer |
메시지 시퀀스 번호 |
|
구독 유형
|
subscriptionType | string |
큐 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID |
반환
Service Bus 메시지
토픽 구독의 메시지 배달 못 한 편지
이 작업은 메시지를 큐에 Dead-Letter 토픽으로 이동합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
메시지의 잠금 토큰
|
lockToken | True | string |
메시지의 토큰을 배달 못 한 편지로 잠금 |
|
세션 ID
|
sessionId | string |
세션 ID |
|
|
배달 못한 편지 이유
|
deadLetterReason | string |
배달 못한 편지 이유 |
|
|
배달 못한 편지 오류 설명
|
deadLetterErrorDescription | string |
배달 못한 편지 오류 설명 |
토픽의 세션 닫기
이 작업은 토픽의 세션을 닫습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
세션 ID
|
sessionId | True | string |
세션 ID |
하나 이상의 메시지 보내기
이 작업은 큐 또는 토픽에 하나 이상의 메시지를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐/토픽 이름
|
entityName | True | string |
큐 또는 토픽의 이름 |
|
Content
|
ContentData | byte |
메시지의 내용 |
|
|
콘텐츠 형식
|
ContentType | string |
메시지 콘텐츠의 콘텐츠 형식 |
|
|
속성
|
Properties | object |
조정된 각 속성에 대한 키-값 쌍 |
|
|
메시지 ID
|
MessageId | string |
이 값은 Service Bus가 중복 메시지를 식별하는 데 사용할 수 있는 사용자 정의 값입니다(사용하도록 설정된 경우). |
|
|
에게
|
To | string |
주소로 보내기 |
|
|
회신
|
ReplyTo | string |
회신할 큐의 주소 |
|
|
세션 ID에 회신
|
ReplyToSessionId | string |
회신할 세션의 식별자 |
|
|
라벨
|
Label | string |
애플리케이션별 레이블 |
|
|
ScheduledEnqueueTimeUtc
|
ScheduledEnqueueTimeUtc | date-time |
메시지가 큐에 추가될 날짜 및 시간(UTC)입니다. |
|
|
세션 ID
|
SessionId | string |
세션의 식별자 |
|
|
상관 관계 ID
|
CorrelationId | string |
상관 관계 식별자 |
|
|
시퀀스 번호
|
SequenceNumber | integer |
시퀀스 번호의 식별자 |
|
|
잠금 토큰
|
LockToken | string |
메시지의 잠금 토큰을 문자열로 사용합니다. |
|
|
Time To Live
|
TimeToLive | integer |
메시지가 유효한 기간(틱 단위)입니다. 기간은 메시지가 Service Bus로 전송되는 시점부터 시작됩니다. |
|
|
시스템 속성
|
systemProperties | string |
시스템 속성 - 없음 또는 실행 세부 정보입니다. 실행 세부 정보는 메시지에 사용자 지정 속성으로 실행 메타데이터 속성 세부 정보를 추가합니다. |
트리거
| 큐에 메시지가 수신되는 경우(자동 완성) |
이 작업은 큐에서 메시지를 수신하고 메시지를 자동으로 완료할 때 흐름을 트리거합니다. |
| 큐에 메시지가 수신되는 경우(피킹 잠금) |
피킹 잠금 모드의 큐에서 메시지를 받으면 작업이 흐름을 트리거합니다. |
| 토픽 구독에서 메시지가 수신되는 경우(피킹 잠금) |
피킹 잠금 모드의 토픽 구독에서 메시지를 받으면 작업이 흐름을 트리거합니다. |
| 토픽 구독에서 메시지를 받는 경우(자동 완성) |
이 작업은 토픽 구독에서 메시지를 수신하고 메시지를 자동으로 완료할 때 흐름을 트리거합니다. |
| 하나 이상의 메시지가 큐에 도착하는 경우(자동 완성) |
작업은 큐에서 하나 이상의 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다. |
| 하나 이상의 메시지가 큐에 도착하는 경우(피킹 잠금) |
작업은 피킹 잠금이 있는 큐에서 하나 이상의 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다. |
| 하나 이상의 메시지가 토픽에 도착하는 경우(자동 완성) |
작업은 토픽에서 하나 이상의 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다. |
| 하나 이상의 메시지가 토픽에 도착하는 경우(피킹 잠금) |
작업은 피킹 잠금이 있는 토픽에서 하나 이상의 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다. |
큐에 메시지가 수신되는 경우(자동 완성)
이 작업은 큐에서 메시지를 수신하고 메시지를 자동으로 완료할 때 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
큐 유형
|
queueType | string |
큐 유형 - Main 또는 DeadLetter |
반환
Service Bus 메시지
큐에 메시지가 수신되는 경우(피킹 잠금)
피킹 잠금 모드의 큐에서 메시지를 받으면 작업이 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
큐 유형
|
queueType | string |
큐 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID - 없음 또는 다음 사용 가능 또는 세션 ID 제공 |
반환
Service Bus 메시지
토픽 구독에서 메시지가 수신되는 경우(피킹 잠금)
피킹 잠금 모드의 토픽 구독에서 메시지를 받으면 작업이 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
구독 유형
|
subscriptionType | string |
구독 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID - 없음 또는 다음 사용 가능 또는 세션 ID 제공 |
반환
Service Bus 메시지
토픽 구독에서 메시지를 받는 경우(자동 완성)
이 작업은 토픽 구독에서 메시지를 수신하고 메시지를 자동으로 완료할 때 흐름을 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
구독 유형
|
subscriptionType | string |
구독 유형 - Main 또는 DeadLetter |
반환
Service Bus 메시지
하나 이상의 메시지가 큐에 도착하는 경우(자동 완성)
작업은 큐에서 하나 이상의 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
최대 메시지 수
|
maxMessageCount | integer |
일괄 처리에서 반환할 최대 메시지 수 |
|
|
큐 유형
|
queueType | string |
큐 유형 - Main 또는 DeadLetter |
반환
Service Bus 메시지
하나 이상의 메시지가 큐에 도착하는 경우(피킹 잠금)
작업은 피킹 잠금이 있는 큐에서 하나 이상의 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
큐 이름
|
queueName | True | string |
큐의 이름 |
|
최대 메시지 수
|
maxMessageCount | integer |
일괄 처리에서 반환할 최대 메시지 수 |
|
|
큐 유형
|
queueType | string |
큐 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID - 없음 또는 다음 사용 가능 또는 세션 ID 제공 |
반환
Service Bus 메시지
하나 이상의 메시지가 토픽에 도착하는 경우(자동 완성)
작업은 토픽에서 하나 이상의 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
최대 메시지 수
|
maxMessageCount | integer |
일괄 처리에서 반환할 최대 메시지 수 |
|
|
구독 유형
|
subscriptionType | string |
구독 유형 - Main 또는 DeadLetter |
반환
Service Bus 메시지
하나 이상의 메시지가 토픽에 도착하는 경우(피킹 잠금)
작업은 피킹 잠금이 있는 토픽에서 하나 이상의 메시지를 받습니다. 최대 메시지 수가 제공되지 않으면 20개의 메시지를 읽습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제 이름
|
topicName | True | string |
토픽의 이름 |
|
토픽 구독 이름
|
subscriptionName | True | string |
토픽 구독의 이름 |
|
최대 메시지 수
|
maxMessageCount | integer |
일괄 처리에서 반환할 최대 메시지 수 |
|
|
구독 유형
|
subscriptionType | string |
구독 유형 - Main 또는 DeadLetter |
|
|
세션 ID
|
sessionId | string |
세션 ID - 없음 또는 다음 사용 가능 또는 세션 ID 제공 |
반환
Service Bus 메시지
정의
ServiceBusMessage
Service Bus 메시지
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Content
|
ContentData | byte |
메시지의 내용 |
|
콘텐츠 형식
|
ContentType | string |
메시지 콘텐츠의 콘텐츠 형식 |
|
속성
|
Properties | object |
조정된 각 속성에 대한 키-값 쌍 |
|
메시지 ID
|
MessageId | string |
이 값은 Service Bus가 중복 메시지를 식별하는 데 사용할 수 있는 사용자 정의 값입니다(사용하도록 설정된 경우). |
|
에게
|
To | string |
주소로 보내기 |
|
회신
|
ReplyTo | string |
회신할 큐의 주소 |
|
세션 ID에 회신
|
ReplyToSessionId | string |
회신할 세션의 식별자 |
|
라벨
|
Label | string |
애플리케이션별 레이블 |
|
ScheduledEnqueueTimeUtc
|
ScheduledEnqueueTimeUtc | date-time |
메시지가 큐에 추가될 날짜 및 시간(UTC)입니다. |
|
세션 ID
|
SessionId | string |
세션의 식별자 |
|
상관 관계 ID
|
CorrelationId | string |
상관 관계 식별자 |
|
시퀀스 번호
|
SequenceNumber | integer |
시퀀스 번호의 식별자 |
|
잠금 토큰
|
LockToken | string |
메시지의 잠금 토큰을 문자열로 사용합니다. |
|
Time To Live
|
TimeToLive | integer |
메시지가 유효한 기간(틱 단위)입니다. 기간은 메시지가 Service Bus로 전송되는 시점부터 시작됩니다. |
Subscription
토픽 구독입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
구독 이름
|
SubscriptionName | string |
구독 이름입니다. |