Azure 큐

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

서비스	클래스	Regions
Copilot Studio	Premium	모든 Power Automate 지역
논리 앱	스탠다드	모든 Logic Apps 지역
Power Apps	Premium	모든 Power Apps 지역
Power Automate	Premium	모든 Power Automate 지역

커넥터 메타데이터
게시자	Microsoft
웹 사이트	https://azure.microsoft.com/services/storage/queues/

이 통합을 사용하려면 Azure Storage 계정에 액세스해야 합니다. 자세한 내용은 여기에서 확인할 수 있습니다. 연결을 시도할 때 스토리지 계정 이름 및 스토리지 키를 입력하라는 메시지가 표시됩니다. 스토리지 계정의 이름은 URL에서 찾을 수 있습니다. 예를 들어 URL이면 계정 이름은 "myaccount"입니다 https://myaccount.queue.core.windows.net . 계정이 여러 개 있는 경우 사용하려는 계정을 제공하고 만들기를 선택합니다. 만드는 동안 오류가 표시되면 계정 이름과 키를 확인하고 다시 시도합니다. 이제 이 통합을 사용할 준비가 되었습니다.

알려진 문제 및 제한 사항

1. 논리 앱은 동일한 지역에 있는 경우 방화벽 뒤에 있는 스토리지 계정에 직접 액세스할 수 없습니다. 해결 방법으로 논리 앱과 스토리지 계정을 다른 지역에 둘 수 있습니다. Azure Logic Apps에서 방화벽 뒤의 스토리지 계정으로 액세스를 사용하도록 설정하는 방법에 대한 자세한 내용은 방화벽 뒤에 있는 Access Storage 계정을 참조하세요.

Microsoft Entra ID 인증 및 Azure Queues 커넥터

Microsoft Entra ID 인증을 사용하려면 사용 중인 계정에 특정 역할 할당을 할당해야 합니다. 자세한 내용은 Blob 데이터에 액세스하기 위해 Azure 역할 할당을 참조하세요. - Azure Storage:

> Only roles explicitly defined for data access permit a security principal to access blob or queue data. Built-in roles such as Owner, Contributor, and Storage Account Contributor permit a security principal to manage a storage account, but do not provide access to the blob or queue data within that account via Microsoft Entra ID.

컨테이너에서 작업을 수행하는 데 필요한 역할이 계정에 있는지 확인하는 빠른 테스트는 다음과 같습니다. 1. Azure Portal에서 해당 계정으로 로그인합니다. 2. 스토리지 계정의 큐로 이동하여 사용할 큐로 이동하고 인증 방법을 클릭합니다 Switch to Microsoft Entra ID User Account . 이 옵션은 검색 상자 바로 위에 나타납니다.

권한이 없는 메시지가 팝업되면 사용자에게 스토리지 계정 특정 권한을 할당해야 합니다. 이렇게 하려면 스토리지 계정 관리자가 다음을 수행해야 합니다. 1. 큐의 Access Control (IAM) 탭으로 이동합니다. 2. 3을 Add 클릭합니다. 4를 Add role assignment 클릭합니다. 사용자에게 특정 Storage Queue 역할 할당(예: Storage Queue Data Contributor)

Microsoft Entra ID 인증의 알려진 제한 사항

현재 인증 파이프라인 제한으로 인해 Microsoft Entra ID 게스트 사용자는 Azure Queues에 대한 Microsoft Entra ID 연결에 대해 지원되지 않습니다. Microsoft Entra ID 인증을 사용하는 경우 V2 작업만 지원됩니다. 사용되지 않는 작업은 인증에서 Access Key 계속 작동하지만 Microsoft Entra ID 연결과 함께 사용하면 실패합니다.

큐 엔드포인트를 사용하여 Azure Queues 커넥터에 연결

"액세스 키" 연결을 만들거나 V2 작업을 사용할 때 전체 Azure Storage 큐 엔드포인트를 입력합니다.

• "액세스 키" 인증의 경우 매개 변수에 전체 Azure Storage 큐 엔드포인트를 Azure Storage account name or queue endpoint 입력합니다.

  • "액세스 키" 인증과 함께 "V2" 작업을 사용하는 경우 큐 엔드포인트도 매개 변수에 storageAccountName 제공해야 합니다.

• "V2" 작업의 경우 매개 변수에 전체 Azure Storage 큐 엔드포인트를 storageAccountName 입력합니다.

• 스키마를 포함하여 전체 엔드포인트를 제공해야 합니다. 예를 들면 다음과 같습니다.

  • https://account.queue.core.windows.net/
  • https://account-secondary.queue.core.windows.net/ (보조 엔드포인트에 연결하는 경우)
  • 상대 경로(예: account.queue.core.windows.net)는 거부됩니다.

지정된 스토리지 계정에 대한 Azure Storage 큐 엔드포인트 가져오기

이 큐 엔드포인트를 가져오는 방법에는 여러 가지가 있습니다.

• Azure Portal 사용

  1. Microsoft Azure에서 연결하려는 Azure Storage 계정으로 이동합니다.
  2. 섹션(왼쪽 블레이드)에서 SettingsEndpoints
  3. 큐 엔드포인트는 텍스트 상자의 queue service큐 서비스 아래에 있습니다.

• 스토리지 계정 사용 - 속성 REST API 호출 가져오기

  1. Azure Storage 계정 subscription Id 및 resource group name.
  2. 스토리지 계정으로 이동 - 속성 가져오기
  3. HTTP 호출의 Try it 오른쪽 위 모서리에 있는 단추를 클릭합니다.
  4. 로그인(사용자에게 스토리지 계정에 대한 액세스 권한이 있어야 합니다.)
  5. Azure Storage 계정이 있는 Azure 테넌트 선택
  6. Azure Storage의 계정 이름, 리소스 그룹 이름을 입력하고 스토리지 계정이 있는 구독을 선택합니다.
  7. 클릭 Run
  8. 큐 엔드포인트는 응답의 queue 개체 아래에 primaryEndpoints 있는 속성에 있습니다.

연결을 만드는 중

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

액세스 키	Azure Queue Storage에 액세스하려면 Azure Storage 계정 이름(또는 큐 엔드포인트) 및 액세스 키를 제공합니다.	Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역	공유 가능
액세스 키(Azure Government)	Azure Queue Storage에 액세스하려면 Azure Storage 계정 이름(또는 큐 엔드포인트) 및 액세스 키를 제공합니다.	Azure Government 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)만	공유 가능
액세스 키(Azure Government)	Azure Government에서 Azure Queue Storage에 액세스하려면 Azure Storage 계정 이름(또는 큐 엔드포인트) 및 액세스 키를 제공합니다.	GCC(미국 정부)	공유 가능
클라이언트 인증서 인증	PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공	모든 지역	공유 가능
Logic Apps 앱 관리 ID	LogicApps 관리 ID를 사용하여 연결 만들기	LOGICAPPS만	공유 가능
Microsoft Entra ID 통합	Microsoft Entra ID를 사용하여 Azure Queue Storage에 액세스합니다.	Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역	공유할 수 없음
Microsoft Entra ID 통합(Azure Government)	Microsoft Entra ID를 사용하여 Azure Queue Storage에 액세스합니다.	Azure Government 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)만	공유할 수 없음
Microsoft Entra ID 통합(Azure Government)	Microsoft Entra ID를 사용하여 Azure Government의 Azure Queue Storage에 액세스합니다.	GCC(미국 정부)	공유할 수 없음
기본값 [사용되지 않음]	이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.	모든 지역	공유할 수 없음

액세스 키

인증 ID: keyBasedAuth

적용 가능: Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역

Azure Queue Storage에 액세스하려면 Azure Storage 계정 이름(또는 큐 엔드포인트) 및 액세스 키를 제공합니다.

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

이름	유형	Description	필수
Azure Storage 계정 이름 또는 큐 엔드포인트	문자열	커넥터에서 사용해야 하는 Azure Storage 계정의 이름 또는 큐 엔드포인트입니다.	진실
Azure Storage 계정 액세스 키	시큐어스트링 (보안 문자열)	유효한 기본/보조 스토리지 계정 액세스 키를 지정합니다.

액세스 키(Azure Government)

인증 ID: keyBasedAuth

적용 가능: Azure Government 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)

Azure Queue Storage에 액세스하려면 Azure Storage 계정 이름(또는 큐 엔드포인트) 및 액세스 키를 제공합니다.

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

이름	유형	Description	필수
Azure Storage 계정 이름 또는 큐 엔드포인트	문자열	커넥터에서 사용해야 하는 Azure Storage 계정의 이름 또는 큐 엔드포인트입니다.	진실
Azure Storage 계정 액세스 키	시큐어스트링 (보안 문자열)	유효한 기본/보조 스토리지 계정 액세스 키를 지정합니다.

액세스 키(Azure Government)

인증 ID: keyBasedAuth

적용 가능: GCC(미국 정부) 전용

Azure Government에서 Azure Queue Storage에 액세스하려면 Azure Storage 계정 이름(또는 큐 엔드포인트) 및 액세스 키를 제공합니다.

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

이름	유형	Description	필수
Azure Storage 계정 이름 또는 큐 엔드포인트	문자열	커넥터에서 사용해야 하는 Azure Storage 계정의 이름 또는 큐 엔드포인트입니다.	진실
Azure Storage 계정 액세스 키	시큐어스트링 (보안 문자열)	유효한 기본/보조 스토리지 계정 액세스 키를 지정합니다.

클라이언트 인증서 인증

인증 ID: certOauth

적용 가능: 모든 지역

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

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

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

Logic Apps 관리 ID

인증 ID: managedIdentityAuth

적용 가능: LOGICAPPS만 해당

LogicApps 관리 ID를 사용하여 연결 만들기

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

이름	유형	Description	필수
LogicApps 관리 ID	관리되는 ID	Logic Apps 관리 ID로 로그인	진실

Microsoft Entra ID 통합

인증 ID: tokenBasedAuth

적용 가능: Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역

Microsoft Entra ID를 사용하여 Azure Queue Storage에 액세스합니다.

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

Microsoft Entra ID 통합(Azure Government)

인증 ID: tokenBasedAuth

적용 가능: Azure Government 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)

Microsoft Entra ID를 사용하여 Azure Queue Storage에 액세스합니다.

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

Microsoft Entra ID 통합(Azure Government)

인증 ID: tokenBasedAuth

적용 가능: GCC(미국 정부) 전용

Microsoft Entra ID를 사용하여 Azure Government의 Azure Queue Storage에 액세스합니다.

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

기본값 [사용되지 않음]

적용 가능: 모든 지역

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

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

이름	유형	Description	필수
Azure Storage 계정 이름 또는 큐 엔드포인트	문자열	Azure Storage 계정의 이름 또는 큐 엔드포인트	진실
공유 스토리지 키	시큐어스트링 (보안 문자열)	스토리지 계정의 공유 스토리지 키	진실

제한 한도

Name	호출	갱신 기간
연결당 API 호출	1200	60초
트리거 폴링 빈도	1	60초

동작

메시지 가져오기(V2)	큐에서 특정 메시지 집합을 가져옵니다. 메시지는 숨겨지지만 삭제 작업이 사용될 때까지 큐에 남아 있습니다.
메시지 가져오기 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 메시지 가져오기(V2)를 사용하세요. 큐에서 특정 메시지 집합을 가져옵니다. 메시지는 숨겨지지만 삭제 작업이 사용될 때까지 큐에 남아 있습니다.
메시지 삭제(V2)	큐에서 특정 메시지를 삭제합니다.
메시지 삭제 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 메시지 삭제(V2) 를 사용하세요. 큐에서 특정 메시지를 삭제합니다.
새 큐 만들기(V2)	계정에 큐를 추가합니다.
새 큐 만들기 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 새 큐 만들기(V2) 를 사용하세요. 계정에 큐를 추가합니다.
큐 나열(V2)	스토리지 계정에 대한 모든 큐를 나열합니다.
큐 나열 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 목록 큐(V2) 를 사용하세요. 스토리지 계정에 대한 모든 큐를 나열합니다.
큐에 메시지 배치(V2)	지정된 큐에 메시지를 추가합니다.
큐에 메시지 배치[사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 큐에 메시지 배치(V2) 를 사용하세요. 지정된 큐에 메시지를 추가합니다.

메시지 가져오기(V2)

메시지 가져오기 [사용되지 않음]

메시지 삭제(V2)

메시지 삭제 [사용되지 않음]

새 큐 만들기(V2)

새 큐 만들기 [사용되지 않음]

큐 나열(V2)

큐 나열 [사용되지 않음]

큐에 메시지 배치(V2)

큐에 메시지 배치[사용되지 않음]

트리거

지정된 수의 메시지가 지정된 큐에 있는 경우(V2)	지정된 수의 메시지가 지정된 큐에 있는 경우 트리거됩니다.
지정된 수의 메시지가 지정된 큐에 있는 경우 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 지정된 수의 메시지가 지정된 큐(V2)에 있는 경우 대신 사용하세요. 지정된 수의 메시지가 지정된 큐에 있는 경우 트리거됩니다.
큐에 메시지가 있는 경우(V2)	큐에 메시지가 있을 때마다 트리거되어 최대 32개의 메시지를 반환합니다. 메시지는 숨겨지지만 삭제 작업이 사용될 때까지 큐에 남아 있습니다.
큐에 메시지가 있는 경우 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 큐에 메시지가 있는 경우(V2) 대신 사용하세요. 큐에 메시지가 있을 때마다 트리거되어 최대 32개의 메시지를 반환합니다. 메시지는 숨겨지지만 삭제 작업이 사용될 때까지 큐에 남아 있습니다.

지정된 수의 메시지가 지정된 큐에 있는 경우(V2)

지정된 수의 메시지가 지정된 큐에 있는 경우 [사용되지 않음]

큐에 메시지가 있는 경우(V2)

큐에 메시지가 있는 경우 [사용되지 않음]

정의

큐

QueueArray

Messages

문자열