Azure 佇列

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	所有 Power Automate 區域
邏輯應用程式	標準	所有 Logic Apps 區域
Power Apps	進階	所有 Power Apps 區域
Power Automate（自動化服務）	進階	所有 Power Automate 區域

連接器中繼資料
Publisher	Microsoft
網站	https://azure.microsoft.com/services/storage/queues/

若要使用此整合，您必須存取 Azure 儲存體帳戶。 您可以在這裡找到詳細資訊。 嘗試建立連線時，系統會提示您提供儲存體帳戶名稱和儲存體金鑰。 您可以在 URL 中找到儲存體帳戶的名稱，例如，如果您的 URL 是， https://myaccount.queue.core.windows.net 則帳戶名稱會是 “myaccount”。 如果您有多個帳戶，請提供您要使用的帳戶，然後選取 建立。 如果您在建立過程中看到錯誤，請檢查帳戶名稱和金鑰，然後重試。 您現在已準備好開始使用此整合。

已知問題與限制

1. 如果邏輯應用程式都位於相同的區域，則無法直接存取防火牆後方的儲存體帳戶。 因應措施是，您可以在不同的區域中擁有邏輯應用程式和儲存體帳戶。 如需啟用從 Azure Logic Apps 存取防火牆後方儲存體帳戶的詳細資訊，請參閱 存取防火牆後方的儲存體帳戶

Microsoft Entra ID 驗證和 Azure 佇列連接器

若要使用 Microsoft Entra ID 驗證，必須為正在使用的帳戶指派特定角色指派，如需詳細資訊，請瀏覽 指派 Azure 角色以存取 Blob 資料 - Azure 儲存體：

> 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 入口網站中使用該帳戶登入。 2. 流覽至儲存體帳戶中的佇列，並使用該佇列，然後按一下 [驗證方法] 中的 。Switch to Microsoft Entra ID User Account 此選項僅出現在搜尋框的頂部。

如果彈出未經授權的訊息，則必須為使用者指派儲存體帳戶特定的許可權。 若要這樣做，儲存體帳戶管理員應該： 1. 流覽至佇列的 Access Control (IAM) 索引標籤。點擊 Add 3.點擊 Add role assignment 4.將特定 Storage Queue 角色指派給使用者 （例如 Storage Queue Data Contributor）

Microsoft Entra ID 驗證的已知限制

由於目前的驗證管線限制，Microsoft Entra ID 客體使用者不支援與 Azure 佇列的 Microsoft Entra ID 連線。 使用 Microsoft Entra ID 驗證時， 僅支援 V2 動作。 已取代的動作會繼續與驗證搭配 Access Key 使用， 但如果與 Microsoft Entra ID 連線搭配使用，則會失敗。

使用佇列端點連線到 Azure 佇列連接器

建立「存取金鑰」連線或使用 V2 作業時，輸入完整的 Azure 儲存體佇列端點。

• 針對「存取金鑰」驗證，請輸入完整的 Azure 儲存體佇列端點 Azure Storage account name or queue endpoint 參數。

  • 將「V2」作業與「存取金鑰」驗證搭配使用時，也必須在參數中 storageAccountName 提供佇列端點。

• 針對 “V2” 作業，請輸入完整的 Azure 儲存體佇列端點 storageAccountName on 參數。

• 您必須提供完整的端點，包括結構描述，例如：

  • https://account.queue.core.windows.net/
  • https://account-secondary.queue.core.windows.net/ （如果連線到次要端點）
  • 相對路徑 （例如 account.queue.core.windows.net） 將會被拒絕。

取得指定儲存體帳戶的 Azure 儲存體佇列端點

有多種方法可以取得此佇列端點：

• 使用 Azure 入口網站

  1. 在 Microsoft Azure 上，導覽至您要連線的 Azure 儲存體帳戶
  2. 在區段（左邊鋒刀）下 Settings ，按一下 Endpoints
  3. 佇列端點將位於文字方塊上的queue service佇列服務下。

• 使用 儲存體帳戶 - 取得屬性 REST API 呼叫

  1. 取得 Azure 儲存體帳戶 subscription Id 和 resource group name。
  2. 流覽至 [儲存體帳戶 - 取得屬性]
  3. 按一下 Try it HTTP 呼叫右上角的按鈕
  4. 登入 （使用者應該具有儲存體帳戶的存取權）
  5. 選擇 Azure 儲存體帳戶所在的 Azure 租用戶
  6. 輸入 Azure 儲存體的帳戶名稱、資源群組名稱，然後選取儲存體帳戶所在的訂用帳戶。
  7. 滴答聲 Run
  8. 佇列端點會位於回應上物件下的primaryEndpoints屬性上queue

正在建立連線

連接器支援下列驗證類型：

存取金鑰	提供 Azure 儲存體帳戶名稱 （或佇列端點） 和存取金鑰，以存取您的 Azure 佇列儲存體。	Azure Government 和美國政府 （GCC） 和美國政府 （GCC-High） 中的 Azure Government 和國防部 （DoD） 以外的所有區域	可共用
存取金鑰 （Azure 政府）	提供 Azure 儲存體帳戶名稱 （或佇列端點） 和存取金鑰，以存取您的 Azure 佇列儲存體。	僅限 Azure Government 和美國政府 （GCC-High） 中的 Azure Government 和國防部 （DoD）	可共用
存取金鑰 （Azure 政府）	提供 Azure 儲存體帳戶名稱 （或佇列端點） 和存取金鑰，以存取 Azure 政府中的 Azure 佇列儲存體。	僅限美國政府 （GCC）	可共用
用戶端憑證驗證	使用 PFX 憑證和密碼提供 Microsoft Entra ID 認證	所有區域	可共用
Logic Apps 受控識別	使用 LogicApps 受控識別建立連線	僅限 LOGICAPPS	可共用
Microsoft Entra ID 整合式	使用 Microsoft Entra ID 來存取您的 Azure 佇列儲存體。	Azure Government 和美國政府 （GCC） 和美國政府 （GCC-High） 中的 Azure Government 和國防部 （DoD） 以外的所有區域	不可共享
Microsoft Entra ID 整合式 （Azure 政府）	使用 Microsoft Entra ID 來存取您的 Azure 佇列儲存體。	僅限 Azure Government 和美國政府 （GCC-High） 中的 Azure Government 和國防部 （DoD）	不可共享
Microsoft Entra ID 整合式 （Azure 政府）	使用 Microsoft Entra ID 存取 Azure 政府中的 Azure 佇列儲存體。	僅限美國政府 （GCC）	不可共享
預設值 [已棄用]	此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。	所有區域	不可共享

存取鍵

驗證 ID：keyBasedAuth

適用：Azure Government 和美國政府 （GCC） 和美國政府 （GCC-High） 中的 Azure Government 和國防部 （DoD） 以外的所有區域

提供 Azure 儲存體帳戶名稱 （或佇列端點） 和存取金鑰，以存取您的 Azure 佇列儲存體。

這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱	類型	Description	為必填項目
Azure 儲存體帳戶名稱或佇列端點	字串	連接器應該使用的 Azure 儲存體帳戶的名稱或佇列端點。	對
Azure 儲存體帳戶存取金鑰	securestring	指定有效的主要/次要儲存體帳戶存取金鑰。

存取金鑰 （Azure 政府）

驗證 ID：keyBasedAuth

適用：僅限 Azure Government 和美國政府 （GCC-High） 中的 Azure Government 和國防部 （DoD）

提供 Azure 儲存體帳戶名稱 （或佇列端點） 和存取金鑰，以存取您的 Azure 佇列儲存體。

這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱	類型	Description	為必填項目
Azure 儲存體帳戶名稱或佇列端點	字串	連接器應該使用的 Azure 儲存體帳戶的名稱或佇列端點。	對
Azure 儲存體帳戶存取金鑰	securestring	指定有效的主要/次要儲存體帳戶存取金鑰。

存取金鑰 （Azure 政府）

驗證 ID：keyBasedAuth

適用：僅限美國政府 （GCC）

提供 Azure 儲存體帳戶名稱 （或佇列端點） 和存取金鑰，以存取 Azure 政府中的 Azure 佇列儲存體。

這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱	類型	Description	為必填項目
Azure 儲存體帳戶名稱或佇列端點	字串	連接器應該使用的 Azure 儲存體帳戶的名稱或佇列端點。	對
Azure 儲存體帳戶存取金鑰	securestring	指定有效的主要/次要儲存體帳戶存取金鑰。

用戶端憑證驗證

驗證 ID：certOauth

適用：所有地區

使用 PFX 憑證和密碼提供 Microsoft Entra ID 認證

這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱	類型	Description	為必填項目
租戶	字串		對
用戶端識別碼	字串	Microsoft Entra ID 應用程式的用戶端識別碼	對
用戶端憑證密碼	客戶憑證	此應用程式允許的用戶端憑證密碼	對
Azure 儲存體帳戶名稱或佇列端點	字串	Azure 儲存體帳戶的名稱或佇列端點	對

Logic Apps 受控識別

驗證 ID：managedIdentityAuth

適用：僅限 LOGICAPPS

使用 LogicApps 受控識別建立連線

這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱	類型	Description	為必填項目
LogicApps 受控識別	managedIdentity	使用 Logic Apps 受控識別登入	對

Microsoft Entra ID 整合

驗證識別碼：tokenBasedAuth

適用：Azure Government 和美國政府 （GCC） 和美國政府 （GCC-High） 中的 Azure Government 和國防部 （DoD） 以外的所有區域

使用 Microsoft Entra ID 來存取您的 Azure 佇列儲存體。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

Microsoft Entra ID 整合式 （Azure 政府）

驗證識別碼：tokenBasedAuth

適用：僅限 Azure Government 和美國政府 （GCC-High） 中的 Azure Government 和國防部 （DoD）

使用 Microsoft Entra ID 來存取您的 Azure 佇列儲存體。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

Microsoft Entra ID 整合式 （Azure 政府）

驗證識別碼：tokenBasedAuth

適用：僅限美國政府 （GCC）

使用 Microsoft Entra ID 存取 Azure 政府中的 Azure 佇列儲存體。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

預設值 [已棄用]

適用：所有地區

此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
Azure 儲存體帳戶名稱或佇列端點	字串	Azure 儲存體帳戶的名稱或佇列端點	對
共用儲存金鑰	securestring	儲存體帳戶的共用儲存體金鑰	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	1200	60 秒
觸發輪詢的頻率	1	60 秒

動作

列出佇列 [已棄用]	此動作已被取代。 請改用列出佇列 （V2）。 列出儲存體帳戶的所有佇列。
列出佇列 （V2）	列出儲存體帳戶的所有佇列。
刪除訊息 [已棄用]	此動作已被取代。 請改用刪除訊息 （V2）。 從佇列中刪除特定訊息。
刪除訊息 （V2）	從佇列中刪除特定訊息。
取得訊息 [已淘汰]	此動作已被取代。 請改用 [取得訊息 （V2）]。 從佇列中取得一組特定的訊息。 訊息將被隱藏，但會保留在佇列上，直到使用刪除動作為止。
取得訊息 （V2）	從佇列中取得一組特定的訊息。 訊息將被隱藏，但會保留在佇列上，直到使用刪除動作為止。
將訊息放在佇列 （V2）	將訊息新增至指定的佇列。
將訊息放在佇列上 [已淘汰]	此動作已被取代。 請改用 將訊息放在佇列 （V2） 上。 將訊息新增至指定的佇列。
建立新佇列 （V2）	將佇列新增至您的帳戶。
建立新的佇列 [已棄用]	此動作已被取代。 請改用建立新佇列 （V2）。 將佇列新增至您的帳戶。

列出佇列 [已棄用]

列出佇列 （V2）

刪除訊息 [已棄用]

刪除訊息 （V2）

取得訊息 [已淘汰]

取得訊息 （V2）

將訊息放在佇列 （V2）

將訊息放在佇列上 [已淘汰]

建立新佇列 （V2）

建立新的佇列 [已棄用]

觸發程序

佇列中有訊息時 （V2）	每當佇列中有訊息時觸發，最多傳回 32 則訊息。 訊息將被隱藏，但會保留在佇列上，直到使用刪除動作為止。
當佇列中有訊息時 [已棄用]	此動作已被取代。 請改用佇列中有訊息時 （V2）。 每當佇列中有訊息時觸發，最多傳回 32 則訊息。 訊息將被隱藏，但會保留在佇列上，直到使用刪除動作為止。
當指定數目的訊息位於給定佇列 （V2） 中時	當指定數目的訊息在給定佇列中時觸發。
當指定數目的訊息位於給定佇列中時 [已淘汰]	此動作已被取代。 請改用 當 指定數量的訊息出現在給定佇列 （V2） 中時 。 當指定數目的訊息在給定佇列中時觸發。

佇列中有訊息時 （V2）

當佇列中有訊息時 [已棄用]

當指定數目的訊息位於給定佇列 （V2） 中時

當指定數目的訊息位於給定佇列中時 [已淘汰]

定義

佇列

佇列陣列

Messages

字串