Azure 队列

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	所有 Power Automate 区域
逻辑应用程序	标准	所有 逻辑应用区域
Power Apps	高级	所有 Power Apps 区域
Power Automate	高级	所有 Power Automate 区域

连接器元数据
发布者	Microsoft
Website	https://azure.microsoft.com/services/storage/queues/

若要使用此集成，需要访问 Azure 存储帐户。 可在此处找到详细信息。 尝试建立连接时，系统会提示你提供存储帐户名称和存储密钥。 可以在 URL 中找到存储帐户的名称，例如，如果 URL 是 https://myaccount.queue.core.windows.net 帐户名称，则帐户名称将为“myaccount”。 如果你有多个帐户，请提供要使用的帐户并选择“ 创建”。 如果在创建过程中看到错误，请检查帐户名称和密钥，然后重试。 现在，你已准备好开始使用此集成。

已知问题和限制

1. 如果逻辑应用位于同一区域中，则无法直接访问防火墙后面的存储帐户。 解决方法是，可以在不同的区域中设置逻辑应用和存储帐户。 有关启用从 Azure 逻辑应用访问防火墙后面的存储帐户的详细信息，请参阅 防火墙后面的访问存储帐户

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)选项卡。2。Add单击 3。Add role assignment单击 4。向用户分配特定Storage Queue角色（例如） Storage Queue Data Contributor

Microsoft Entra ID 身份验证的已知限制

由于当前的身份验证管道限制，Microsoft与 Azure 队列的 Entra ID 连接不支持Microsoft Entra ID 来宾用户。 使用 Microsoft Entra ID 身份验证 时，仅支持 V2作。 弃用的作将继续使用 Access Key 身份验证，但如果 与 Microsoft Entra ID 连接一起使用，将失败。

使用队列终结点连接到 Azure 队列连接器

创建“访问密钥”连接或使用 V2作时输入完整的 Azure 存储队列终结点。

• 对于“访问密钥”身份验证，请在参数上 Azure Storage account name or queue endpoint 输入完整的 Azure 存储队列终结点。

  • 将“V2”作与“访问密钥”身份验证结合使用时，还必须在 storageAccountName 参数中提供队列终结点。

• 对于“V2”作，请在参数上 storageAccountName 输入完整的 Azure 存储队列终结点。

• 必须提供完整的终结点，包括架构，例如：

  • https://account.queue.core.windows.net/
  • https://account-secondary.queue.core.windows.net/ （如果连接到辅助终结点）
  • 相对路径（例如， account.queue.core.windows.net）将被拒绝。

获取给定存储帐户的 Azure 存储队列终结点

可通过多种方式获取此队列终结点：

• 使用 Azure 门户

  1. 在 azure Microsoft，导航到要连接的 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. 队列终结点将位于 queue 响应对象下 primaryEndpoints 的属性上

正在创建连接

连接器支持以下身份验证类型：

访问密钥	提供 Azure 存储帐户名称（或队列终结点）和访问密钥以访问 Azure 队列存储。	除 Azure 政府和国防部（DoD）以外的所有区域（Azure 政府和美国政府（GCC）和美国政府（GCC-High）	可共享
访问密钥 （Azure 政府版）	提供 Azure 存储帐户名称（或队列终结点）和访问密钥以访问 Azure 队列存储。	Azure 政府和国防部（DoD）仅在 Azure 政府和美国政府（GCC-High）	可共享
访问密钥 （Azure 政府版）	提供 Azure 存储帐户名称（或队列终结点）和访问密钥，以访问 Azure 政府中的 Azure 队列存储。	仅限美国政府（GCC）	可共享
客户端证书身份验证	使用 PFX 证书和密码提供Microsoft Entra ID 凭据	所有区域	可共享
逻辑应用托管标识	使用 LogicApps 托管标识创建连接	仅限 LOGICAPPS	可共享
Microsoft Entra ID 集成	使用 Microsoft Entra ID 访问 Azure 队列存储。	除 Azure 政府和国防部（DoD）以外的所有区域（Azure 政府和美国政府（GCC）和美国政府（GCC-High）	不可共享
Microsoft Entra ID 集成（Azure 政府版）	使用 Microsoft Entra ID 访问 Azure 队列存储。	Azure 政府和国防部（DoD）仅在 Azure 政府和美国政府（GCC-High）	不可共享
Microsoft Entra ID 集成（Azure 政府版）	使用 Microsoft Entra ID 访问 Azure 政府中的 Azure 队列存储。	仅限美国政府（GCC）	不可共享
默认值 [已弃用]	此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。	所有区域	不可共享

访问密钥

身份验证 ID：keyBasedAuth

适用：除 Azure 政府和国防部（DoD）以外的所有区域（Azure 政府和美国政府（GCC）和美国政府（GCC-High）

提供 Azure 存储帐户名称（或队列终结点）和访问密钥以访问 Azure 队列存储。

这是可共享的连接。 如果 Power App 与其他用户共享，则连接也会共享。 有关详细信息，请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name	类型	Description	必选
Azure 存储帐户名称或队列终结点	字符串	连接器应使用的 Azure 存储帐户的名称或队列终结点。	True
Azure 存储帐户访问密钥	securestring	指定有效的主/辅助存储帐户访问密钥。

访问密钥 （Azure 政府版）

身份验证 ID：keyBasedAuth

适用：Azure 政府和国防部（DoD）仅在 Azure 政府和美国政府（GCC-High）

提供 Azure 存储帐户名称（或队列终结点）和访问密钥以访问 Azure 队列存储。

这是可共享的连接。 如果 Power App 与其他用户共享，则连接也会共享。 有关详细信息，请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name	类型	Description	必选
Azure 存储帐户名称或队列终结点	字符串	连接器应使用的 Azure 存储帐户的名称或队列终结点。	True
Azure 存储帐户访问密钥	securestring	指定有效的主/辅助存储帐户访问密钥。

访问密钥 （Azure 政府版）

身份验证 ID：keyBasedAuth

适用：仅限美国政府（GCC）

提供 Azure 存储帐户名称（或队列终结点）和访问密钥，以访问 Azure 政府中的 Azure 队列存储。

这是可共享的连接。 如果 Power App 与其他用户共享，则连接也会共享。 有关详细信息，请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name	类型	Description	必选
Azure 存储帐户名称或队列终结点	字符串	连接器应使用的 Azure 存储帐户的名称或队列终结点。	True
Azure 存储帐户访问密钥	securestring	指定有效的主/辅助存储帐户访问密钥。

客户端证书身份验证

身份验证 ID：certOauth

适用：所有区域

使用 PFX 证书和密码提供Microsoft Entra ID 凭据

这是可共享的连接。 如果 Power App 与其他用户共享，则连接也会共享。 有关详细信息，请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name	类型	Description	必选
租户	字符串		True
客户 ID	字符串	Microsoft Entra ID 应用程序的客户端 ID	True
客户端证书机密	clientCertificate	此应用程序允许的客户端证书机密	True
Azure 存储帐户名称或队列终结点	字符串	Azure 存储帐户的名称或队列终结点	True

逻辑应用托管标识

身份验证 ID：managedIdentityAuth

适用：仅限 LOGICAPPS

使用 LogicApps 托管标识创建连接

这是可共享的连接。 如果 Power App 与其他用户共享，则连接也会共享。 有关详细信息，请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name	类型	Description	必选
LogicApps 托管标识	managedIdentity	使用逻辑应用托管标识登录	True

已集成 Microsoft Entra ID

身份验证 ID：tokenBasedAuth

适用：除 Azure 政府和国防部（DoD）以外的所有区域（Azure 政府和美国政府（GCC）和美国政府（GCC-High）

使用 Microsoft Entra ID 访问 Azure 队列存储。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Microsoft Entra ID 集成（Azure 政府版）

身份验证 ID：tokenBasedAuth

适用：Azure 政府和国防部（DoD）仅在 Azure 政府和美国政府（GCC-High）

使用 Microsoft Entra ID 访问 Azure 队列存储。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Microsoft Entra ID 集成（Azure 政府版）

身份验证 ID：tokenBasedAuth

适用：仅限美国政府（GCC）

使用 Microsoft Entra ID 访问 Azure 政府中的 Azure 队列存储。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

默认值 [已弃用]

适用：所有区域

此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
Azure 存储帐户名称或队列终结点	字符串	Azure 存储帐户的名称或队列终结点	True
共享存储密钥	securestring	存储帐户的共享存储密钥	True

限制

名称	调用	续订期
每个连接的 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

字符串