Filas do Azure

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automate
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps
Aplicações Power	Premium	Todas as regiões do Power Apps
Automatize o poder	Premium	Todas as regiões do Power Automate

Metadados do conector
Editora	Microsoft
Sítio Web	https://azure.microsoft.com/services/storage/queues/

Para usar essa integração, você precisará acessar uma conta de armazenamento do Azure. Mais informações podem ser encontradas aqui. Ao tentar estabelecer uma ligação, ser-lhe-á pedido que forneça o nome da sua conta de armazenamento e a sua chave de armazenamento. O nome da sua conta de armazenamento pode ser encontrado no URL, por exemplo, se o seu URL for https://myaccount.queue.core.windows.net então o nome da conta será "myaccount". Se você tiver várias contas, forneça a que deseja usar e selecione Criar. Se vir um erro durante a criação, verifique o nome da conta e a chave e tente novamente. Agora você está pronto para começar a usar essa integração.

Problemas conhecidos e limitações

1. Os aplicativos lógicos não podem acessar diretamente contas de armazenamento que estão atrás de firewalls se ambos estiverem na mesma região. Como solução alternativa, você pode ter seus aplicativos lógicos e conta de armazenamento em diferentes regiões. Para obter mais informações sobre como habilitar o acesso dos Aplicativos Lógicos do Azure a contas de armazenamento atrás de firewalls, consulte Acessar contas de armazenamento atrás de firewalls

Autenticação do Microsoft Entra ID e conector de filas do Azure

Para usar a autenticação do Microsoft Entra ID, a conta que está sendo usada precisa receber uma atribuição de função específica, para obter mais informações, visite Atribuir uma função do Azure para acesso a dados de blob - Armazenamento do 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.

Aqui está um teste rápido para verificar se uma conta tem a função necessária para executar operações em um contêiner: 1. Entre com essa conta no Portal do Azure. 2. Navegue até a fila na conta de armazenamento e que será usada e clique Switch to Microsoft Entra ID User Account no método de autenticação. Esta opção aparece logo na parte superior da caixa de pesquisa.

Se uma mensagem não autorizada aparecer, o usuário precisará receber permissões específicas da Conta de Armazenamento. Para fazer isso, o gerente de conta de armazenamento deve: 1. Navegue até a guia 2 da Access Control (IAM) fila. Clique em Add 3. Clique em Add role assignment 4. Atribuir uma função específica Storage Queue ao usuário (por exemplo, Storage Queue Data Contributor)

Limitações conhecidas com a autenticação do Microsoft Entra ID

Devido às limitações atuais do pipeline de autenticação, os usuários convidados do Microsoft Entra ID não têm suporte para conexões do Microsoft Entra ID com as Filas do Azure. Ao usar a autenticação do Microsoft Entra ID , apenas as ações V2 são suportadas. As ações preteridas continuarão a funcionar com Access Key autenticação, mas falharão se usadas com uma conexão de ID do Microsoft Entra.

Conectar-se ao conector de filas do Azure usando o ponto de extremidade da fila

Insira o ponto de extremidade completo da fila do Armazenamento do Azure ao criar uma conexão "Chave de Acesso" ou usar operações V2.

• Para autenticações de "Chave de Acesso", insira o ponto de extremidade completo da fila do Armazenamento do Azure no Azure Storage account name or queue endpoint parâmetro.

  • Ao usar operações "V2" com autenticação de "Chave de Acesso", o ponto de extremidade da fila storageAccountName também deve ser fornecido no parâmetro.

• Para operações "V2", insira o ponto de extremidade completo da fila do Armazenamento do Azure no storageAccountName parâmetro.

• Você deve fornecer o ponto de extremidade completo, incluindo o esquema, por exemplo:

  • https://account.queue.core.windows.net/
  • https://account-secondary.queue.core.windows.net/ (se estiver a ligar ao parâmetro de avaliação secundário)
  • Os caminhos relativos (por exemplo, account.queue.core.windows.net) serão rejeitados.

Obter o ponto de extremidade da fila do Armazenamento do Azure para uma determinada conta de armazenamento

Há várias maneiras de obter esse ponto de extremidade de fila:

• Através do portal do Azure

  1. No Microsoft Azure, navegue até a conta de Armazenamento do Azure que você deseja conectar
  2. Na Settings secção (folha esquerda), clique em Endpoints
  3. O ponto de extremidade da fila estará em Serviço de fila, na caixa de queue service texto.

• Usando contas de armazenamento - Obter chamadas de API REST de propriedades

  1. Obtenha a conta subscription Id de Armazenamento do Azure e resource group nameo .
  2. Navegue até Contas de armazenamento - Obter propriedades
  3. Clique no Try it botão no canto superior direito da chamada HTTP
  4. Entrar (o usuário deve ter acesso à conta de armazenamento)
  5. Escolha o locatário do Azure em que a conta de Armazenamento do Azure está localizada
  6. Insira o nome da conta do Armazenamento do Azure, o nome do grupo de recursos e selecione a assinatura na qual a conta de armazenamento está localizada.
  7. Clique em Run
  8. O ponto de extremidade da fila estará na queue propriedade sob primaryEndpoints objeto na resposta

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Chave de Acesso	Forneça o nome da conta do Armazenamento do Azure (ou ponto de extremidade da fila) e a Chave de Acesso para acessar o armazenamento da Fila do Azure.	Todas as regiões, exceto o Azure Government e o Department of Defense (DoD) no Azure Government e no US Government (GCC) e no US Government (GCC-High)	Compartilhável
Chave de Acesso (Azure Government)	Forneça o nome da conta do Armazenamento do Azure (ou ponto de extremidade da fila) e a Chave de Acesso para acessar o armazenamento da Fila do Azure.	Azure Government and Department of Defense (DoD) no Azure Government e US Government (GCC-High) apenas	Compartilhável
Chave de Acesso (Azure Government)	Forneça o nome da conta do Armazenamento do Azure (ou ponto de extremidade da fila) e a Chave de Acesso para acessar o armazenamento da Fila do Azure no Azure Government.	Apenas Governo dos EUA (CCG)	Compartilhável
Autenticação de certificado de cliente	Forneça credenciais do Microsoft Entra ID usando certificado PFX e senha	Todas as regiões	Compartilhável
Identidade gerenciada de aplicativos lógicos	Criar uma conexão usando uma identidade gerenciada do LogicApps	Apenas LOGICAPPS	Compartilhável
Microsoft Entra ID Integrado	Use a ID do Microsoft Entra para acessar seu armazenamento de fila do Azure.	Todas as regiões, exceto o Azure Government e o Department of Defense (DoD) no Azure Government e no US Government (GCC) e no US Government (GCC-High)	Não compartilhável
Microsoft Entra ID Integrated (Azure Government)	Use a ID do Microsoft Entra para acessar seu armazenamento de fila do Azure.	Azure Government and Department of Defense (DoD) no Azure Government e US Government (GCC-High) apenas	Não compartilhável
Microsoft Entra ID Integrated (Azure Government)	Use a ID do Microsoft Entra para acessar seu armazenamento de fila do Azure no Azure Government.	Apenas Governo dos EUA (CCG)	Não compartilhável
Padrão [DEPRECATED]	Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.	Todas as regiões	Não compartilhável

Tecla de Acesso

ID de autenticação: keyBasedAuth

Aplicável: Todas as regiões, exceto o Azure Government e o Department of Defense (DoD) no Azure Government e no US Government (GCC) e no US Government (GCC-High)

Forneça o nome da conta do Armazenamento do Azure (ou ponto de extremidade da fila) e a Chave de Acesso para acessar o armazenamento da Fila do Azure.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome	Tipo	Description	Obrigatório
Nome da conta de Armazenamento do Azure ou ponto de extremidade da fila	cadeia (de caracteres)	Nome ou ponto de extremidade de fila da conta de Armazenamento do Azure que o conector deve usar.	Verdade
Chave de Acesso da Conta de Armazenamento do Azure	securestring	Especifique uma chave de acesso de conta de armazenamento primário/secundário válida.

Chave de Acesso (Azure Government)

ID de autenticação: keyBasedAuth

Aplicável: Azure Government e Department of Defense (DoD) apenas no Azure Government e no US Government (GCC-High)

Forneça o nome da conta do Armazenamento do Azure (ou ponto de extremidade da fila) e a Chave de Acesso para acessar o armazenamento da Fila do Azure.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome	Tipo	Description	Obrigatório
Nome da conta de Armazenamento do Azure ou ponto de extremidade da fila	cadeia (de caracteres)	Nome ou ponto de extremidade de fila da conta de Armazenamento do Azure que o conector deve usar.	Verdade
Chave de Acesso da Conta de Armazenamento do Azure	securestring	Especifique uma chave de acesso de conta de armazenamento primário/secundário válida.

Chave de Acesso (Azure Government)

ID de autenticação: keyBasedAuth

Aplicável: apenas Governo dos EUA (GCC)

Forneça o nome da conta do Armazenamento do Azure (ou ponto de extremidade da fila) e a Chave de Acesso para acessar o armazenamento da Fila do Azure no Azure Government.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome	Tipo	Description	Obrigatório
Nome da conta de Armazenamento do Azure ou ponto de extremidade da fila	cadeia (de caracteres)	Nome ou ponto de extremidade de fila da conta de Armazenamento do Azure que o conector deve usar.	Verdade
Chave de Acesso da Conta de Armazenamento do Azure	securestring	Especifique uma chave de acesso de conta de armazenamento primário/secundário válida.

Autenticação de certificado de cliente

ID de autenticação: certOauth

Aplicável: Todas as regiões

Forneça credenciais do Microsoft Entra ID usando certificado PFX e senha

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome	Tipo	Description	Obrigatório
Tenant	cadeia (de caracteres)		Verdade
ID do Cliente	cadeia (de caracteres)	A ID do cliente do aplicativo Microsoft Entra ID	Verdade
Segredo do certificado do cliente	certificado do cliente	O segredo do certificado do cliente permitido por este aplicativo	Verdade
Nome da conta de Armazenamento do Azure ou ponto de extremidade da fila	cadeia (de caracteres)	O nome ou ponto de extremidade da fila da sua conta de Armazenamento do Azure	Verdade

Identidade gerenciada de aplicativos lógicos

ID de autenticação: managedIdentityAuth

Aplicável: apenas LOGICAPPS

Criar uma conexão usando uma identidade gerenciada do LogicApps

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome	Tipo	Description	Obrigatório
Identidade gerenciada do LogicApps	managedIdentity	Entrar com uma identidade gerenciada de aplicativos lógicos	Verdade

ID do Microsoft Entra Integrado

ID de autenticação: tokenBasedAuth

Aplicável: Todas as regiões, exceto o Azure Government e o Department of Defense (DoD) no Azure Government e no US Government (GCC) e no US Government (GCC-High)

Use a ID do Microsoft Entra para acessar seu armazenamento de fila do Azure.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Microsoft Entra ID Integrated (Azure Government)

ID de autenticação: tokenBasedAuth

Aplicável: Azure Government e Department of Defense (DoD) apenas no Azure Government e no US Government (GCC-High)

Use a ID do Microsoft Entra para acessar seu armazenamento de fila do Azure.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Microsoft Entra ID Integrated (Azure Government)

ID de autenticação: tokenBasedAuth

Aplicável: apenas Governo dos EUA (GCC)

Use a ID do Microsoft Entra para acessar seu armazenamento de fila do Azure no Azure Government.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Nome da conta de Armazenamento do Azure ou ponto de extremidade da fila	cadeia (de caracteres)	O nome ou ponto de extremidade da fila da sua conta de Armazenamento do Azure	Verdade
Chave de armazenamento compartilhada	securestring	A chave de armazenamento partilhada da sua conta de armazenamento	Verdade

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	1200	60 segundos
Frequência das sondagens de desencadeamento	1	60 segundos

Ações

Colocar uma mensagem em uma fila (V2)	Adiciona uma mensagem à fila fornecida.
Colocar uma mensagem em uma fila [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Colocar uma mensagem em uma fila (V2). Adiciona uma mensagem à fila fornecida.
Criar uma nova fila (V2)	Adiciona uma fila à sua conta.
Criar uma nova fila [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Criar uma nova fila (V2). Adiciona uma fila à sua conta.
Excluir mensagem (V2)	Exclua uma mensagem específica da fila.
Excluir mensagem [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Excluir mensagem (V2). Exclua uma mensagem específica da fila.
Listar filas (V2)	Liste todas as filas da sua conta de armazenamento.
Listar filas [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Listar filas (V2). Liste todas as filas da sua conta de armazenamento.
Obter mensagens (V2)	Obtenha um conjunto específico de mensagens da fila. As mensagens ficarão ocultas, mas permanecerão na fila até que a ação de exclusão seja usada.
Obter mensagens [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Obter mensagens (V2). Obtenha um conjunto específico de mensagens da fila. As mensagens ficarão ocultas, mas permanecerão na fila até que a ação de exclusão seja usada.

Colocar uma mensagem em uma fila (V2)

Colocar uma mensagem em uma fila [DEPRECATED]

Criar uma nova fila (V2)

Criar uma nova fila [DEPRECATED]

Excluir mensagem (V2)

Excluir mensagem [DEPRECATED]

Listar filas (V2)

Listar filas [DEPRECATED]

Obter mensagens (V2)

Obter mensagens [DEPRECATED]

Acionadores

Quando há mensagens em uma fila (V2)	Aciona sempre que há mensagens na fila, retornando até 32 mensagens. As mensagens ficarão ocultas, mas permanecerão na fila até que a ação de exclusão seja usada.
Quando há mensagens em uma fila [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Quando houver mensagens em uma fila (V2). Aciona sempre que há mensagens na fila, retornando até 32 mensagens. As mensagens ficarão ocultas, mas permanecerão na fila até que a ação de exclusão seja usada.
Quando um número especificado de mensagens está em uma determinada fila (V2)	Aciona quando um número especificado de mensagens está na fila determinada.
Quando um número especificado de mensagens está em uma determinada fila [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Quando um número especificado de mensagens estiver em uma determinada fila (V2). Aciona quando um número especificado de mensagens está na fila determinada.

Quando há mensagens em uma fila (V2)

Quando há mensagens em uma fila [DEPRECATED]

Quando um número especificado de mensagens está em uma determinada fila (V2)

Quando um número especificado de mensagens está em uma determinada fila [DEPRECATED]

Definições

Fila

QueueArray

Messages

cadeia (de caracteres)