Filas do Azure

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

Service	Class	Regions
Copilot Studio	Premium	Todas as regiões do Power Automate
Aplicativos Lógicos	Standard	Todas as regiões de Aplicativos Lógicos
Power Apps	Premium	Todas as regiões do Power Apps
Power Automate	Premium	Todas as regiões do Power Automate

Metadados do conector
Publicador	Microsoft
Site	https://azure.microsoft.com/services/storage/queues/

Para usar essa integração, você precisará de acesso a uma conta de armazenamento do Azure. Encontre mais informações aqui. Ao tentar fazer uma conexão, você será solicitado a fornecer o nome da conta de armazenamento e a chave de armazenamento. O nome da sua conta de armazenamento pode ser encontrado na URL, por exemplo, se a URL for https://myaccount.queue.core.windows.net , o nome da conta será "myaccount". Se você tiver várias contas, forneça a que deseja usar e selecione Criar. Se você 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 e limitações conhecidos

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

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

Para usar a autenticação da ID do Microsoft Entra, a conta que está sendo usada precisa ser atribuída a uma atribuição de função específica, para obter mais informações, visite Atribuir uma função do Azure para acesso aos 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 isso será usado e clique no Switch to Microsoft Entra ID User Account método autenticação. Essa opção aparece apenas na parte superior da caixa de pesquisa.

Se uma mensagem não autorizada for exibida, o usuário precisará receber permissões específicas da Conta de Armazenamento. Para fazer isso, o gerenciador de contas de armazenamento deve: 1. Navegue até a guia da Access Control (IAM) fila. 2. 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 da ID do Microsoft Entra

Devido às limitações atuais do pipeline de autenticação, os usuários convidados da ID do Microsoft Entra não têm suporte para conexões de ID do Microsoft Entra para Filas do Azure. Ao usar a autenticação do Microsoft Entra ID , há suporte apenas para ações V2. As ações preteridas continuarão a funcionar com Access Key a autenticação, mas falharão se forem 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 a autenticação "Chave de Acesso", o ponto de extremidade da fila também deve ser fornecido no storageAccountName 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 se conectando ao ponto de extremidade secundário)
  • 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:

• Usando o Portal do Azure

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

• Usando contas de armazenamento – obter chamada à API REST de propriedades

  1. Obtenha a conta subscription Id de Armazenamento do Azure e resource group name.
  2. Navegar 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 no qual 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 Run
  8. O ponto de extremidade da fila estará na queue propriedade em primaryEndpoints objeto na resposta

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Chave de Acesso	Forneça o nome da conta de Armazenamento do Azure (ou ponto de extremidade da fila) e a Chave de Acesso para acessar o armazenamento de Filas do Azure.	Todas as regiões, exceto o Governo do Azure e o Departamento de Defesa (DoD) no Azure Governamental e no Governo dos EUA (GCC) e no Governo dos EUA (GCC-High)	Compartilhável
Chave de Acesso (Azure Governamental)	Forneça o nome da conta de Armazenamento do Azure (ou ponto de extremidade da fila) e a Chave de Acesso para acessar o armazenamento de Filas do Azure.	Governo do Azure e Departamento de Defesa (DoD) somente no Azure Governamental e no Governo dos EUA (GCC-High)	Compartilhável
Chave de Acesso (Azure Governamental)	Forneça o nome da conta de Armazenamento do Azure (ou ponto de extremidade da fila) e a Chave de Acesso para acessar o armazenamento de Filas do Azure no Azure Governamental.	Somente governo dos EUA (GCC)	Compartilhável
Autenticação de Certificado do Cliente	Fornecer credenciais de ID do Microsoft Entra usando certificado PFX e senha	Todas as regiões	Compartilhável
Identidades gerenciadas de Aplicativos Lógicos	Criar uma conexão usando uma Identidade Gerenciada do LogicApps	Somente LOGICAPPS	Compartilhável
Microsoft Entra ID Integrado	Use a ID do Microsoft Entra para acessar o armazenamento de Filas do Azure.	Todas as regiões, exceto o Governo do Azure e o Departamento de Defesa (DoD) no Azure Governamental e no Governo dos EUA (GCC) e no Governo dos EUA (GCC-High)	Não compartilhável
Microsoft Entra ID Integrada (Azure Government)	Use a ID do Microsoft Entra para acessar o armazenamento de Filas do Azure.	Governo do Azure e Departamento de Defesa (DoD) somente no Azure Governamental e no Governo dos EUA (GCC-High)	Não compartilhável
Microsoft Entra ID Integrada (Azure Government)	Use a ID do Microsoft Entra para acessar o armazenamento de Filas do Azure no Azure Governamental.	Somente governo dos EUA (GCC)	Não compartilhável
Padrão [PRETERIDO]	Essa 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

Chave de Acesso

ID de autenticação: keyBasedAuth

Aplicável: todas as regiões, exceto o Governo do Azure e o Departamento de Defesa (DoD) no Azure Governamental e no Governo dos EUA (GCC) e no Governo dos EUA (GCC-High)

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

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome	Tipo	Description	Obrigatório
Nome da conta de Armazenamento do Azure ou ponto de extremidade da fila	cadeia	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ária/secundária válida.

Chave de Acesso (Azure Governamental)

ID de autenticação: keyBasedAuth

Aplicável: Azure Governamental e Departamento de Defesa (DoD) somente no Azure Governamental e no Governo dos EUA (GCC-High)

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

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome	Tipo	Description	Obrigatório
Nome da conta de Armazenamento do Azure ou ponto de extremidade da fila	cadeia	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ária/secundária válida.

Chave de Acesso (Azure Governamental)

ID de autenticação: keyBasedAuth

Aplicável: somente governo dos EUA (GCC)

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

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome	Tipo	Description	Obrigatório
Nome da conta de Armazenamento do Azure ou ponto de extremidade da fila	cadeia	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ária/secundária válida.

Autenticação de Certificado do Cliente

ID de autenticação: certOauth

Aplicável: todas as regiões

Fornecer credenciais de ID do Microsoft Entra usando certificado PFX e senha

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome	Tipo	Description	Obrigatório
Inquilino	cadeia		Verdade
ID do cliente	cadeia	A ID do cliente do aplicativo Microsoft Entra ID	Verdade
Segredo do certificado do cliente	clientCertificate	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	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: somente LOGICAPPS

Criar uma conexão usando uma Identidade Gerenciada do LogicApps

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

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

Microsoft Entra ID Integrado

ID de autenticação: tokenBasedAuth

Aplicável: todas as regiões, exceto o Governo do Azure e o Departamento de Defesa (DoD) no Azure Governamental e no Governo dos EUA (GCC) e no Governo dos EUA (GCC-High)

Use a ID do Microsoft Entra para acessar o armazenamento de Filas do Azure.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Microsoft Entra ID Integrada (Azure Government)

ID de autenticação: tokenBasedAuth

Aplicável: Azure Governamental e Departamento de Defesa (DoD) somente no Azure Governamental e no Governo dos EUA (GCC-High)

Use a ID do Microsoft Entra para acessar o armazenamento de Filas do Azure.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Microsoft Entra ID Integrada (Azure Government)

ID de autenticação: tokenBasedAuth

Aplicável: somente governo dos EUA (GCC)

Use a ID do Microsoft Entra para acessar o armazenamento de Filas do Azure no Azure Governamental.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Padrão [PRETERIDO]

Aplicável: todas as regiões

Essa 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.

Essa não é uma conexão compartilhável. Se o aplicativo de energia 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	O nome ou ponto de extremidade da fila da sua conta de Armazenamento do Azure	Verdade
Chave de Armazenamento Compartilhado	secureString	A chave de armazenamento compartilhada da sua conta de armazenamento	Verdade

Limitações

Nome	Chamadas	Período de renovação
Chamadas à API por conexão	1200	60 segundos
Frequência das pesquisas de gatilho	1	60 segundos

Ações

Colocar uma mensagem em uma fila (V2)	Adiciona uma mensagem à fila fornecida.
Colocar uma mensagem em uma fila [PRETERIDO]	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 [PRETERIDA]	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 [PRETERIDO]	Esta ação foi preterida. Em vez disso, use a mensagem Excluir (V2 ). Exclua uma mensagem específica da fila.
Listar filas (V2)	Liste todas as filas para sua conta de armazenamento.
Listar filas [PRETERIDO]	Esta ação foi preterida. Em vez disso, use filas de lista (V2 ). Liste todas as filas para 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 [PRETERIDAS]	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 [PRETERIDO]

Criar uma nova fila (V2)

Criar uma nova fila [PRETERIDA]

Excluir mensagem (V2)

Excluir mensagem [PRETERIDO]

Listar filas (V2)

Listar filas [PRETERIDO]

Obter mensagens (V2)

Obter mensagens [PRETERIDAS]

Gatilhos

Quando há mensagens em uma fila (V2)	Dispara 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 [PRETERIDO]	Esta ação foi preterida. Use quando houver mensagens em uma fila (V2). Dispara 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)	Dispara quando um número especificado de mensagens está na fila fornecida.
Quando um número especificado de mensagens está em uma determinada fila [PRETERIDO]	Esta ação foi preterida. Use quando um número especificado de mensagens estiver em uma determinada fila (V2). Dispara quando um número especificado de mensagens está na fila fornecida.

Quando há mensagens em uma fila (V2)

Quando há mensagens em uma fila [PRETERIDO]

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 [PRETERIDO]

Definições

Fila

QueueArray

Messages

cadeia