Barramento de Serviço
Conecte-se ao Barramento de Serviço do Azure para enviar e receber mensagens. Você pode executar ações como enviar para a fila, enviar para o tópico, receber da fila, receber da assinatura etc.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) |
| Aplicativos Lógicos | Standard | Todas as regiões de Aplicativos Lógicos |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC High) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Website | https://azure.microsoft.com/services/service-bus/ |
Problemas e limitações gerais conhecidos
Loops infinitos
Tenha cuidado ao selecionar um gatilho e uma ação que tenham o mesmo tipo de conector e usá-los para trabalhar com a mesma entidade, como uma fila ou assinatura de tópico. Essa combinação pode criar um loop infinito, que resulta em um fluxo de trabalho que nunca termina.
Por exemplo, suponha que seu fluxo de trabalho use um gatilho do Barramento de Serviço que retorna uma mensagem recém-recebida em uma fila e siga esse gatilho com uma ação do Barramento de Serviço que envia uma mensagem de volta para a mesma fila. Esse padrão pode criar um loop infinito, causando um fluxo de trabalho sem fim.
Limite de sessões salvas no cache do conector
Por entidade de mensagens do Barramento de Serviço, como uma assinatura ou um tópico, o conector do Barramento de Serviço pode salvar até 1.500 sessões exclusivas por vez no cache do conector. Se a contagem de sessões exceder esse limite, as sessões antigas serão removidas do cache. Para obter mais informações, confira Sessões de mensagem.
Gatilhos de sondagem longa
Para o conector gerenciado do Barramento de Serviço do Azure, todos os gatilhos são de sondagem longa. Esse tipo de gatilho processa todas as mensagens e aguarda 30 segundos para que mais mensagens apareçam na fila ou na assinatura do tópico. Se nenhuma mensagem aparecer em 30 segundos, a execução do gatilho será ignorada. Caso contrário, o gatilho continuará lendo as mensagens até que a fila ou a assinatura do tópico esteja vazia. A próxima sondagem de gatilho é baseada no intervalo de recorrência especificado nas propriedades do gatilho.
Autenticação do Microsoft Entra ID
Para usar a autenticação da ID do Microsoft Entra, a conta de usuário requer uma atribuição de função específica. Para obter mais informações, consulte Atribuir uma função do Azure para direitos de acesso – Barramento de Serviço do Azure.
Autenticação de identidade gerenciada
Atualmente, a autenticação de identidade gerenciada tem suporte apenas para Aplicativos Lógicos do Azure.
Para usar uma identidade gerenciada que autentica o acesso do fluxo de trabalho do aplicativo lógico ao namespace do Barramento de Serviço e à entidade de mensagens, atribua permissões de função nos níveis correspondentes. Por exemplo, para acessar uma fila, a identidade gerenciada requer uma função que tenha as permissões necessárias para essa fila.
Cada identidade gerenciada que acessa uma entidade de mensagens diferente deve ter uma conexão separada com essa entidade. Se você usar ações diferentes do Barramento de Serviço do Azure para enviar e receber mensagens e essas ações exigirem permissões diferentes, use conexões diferentes.
Para habilitar uma identidade gerenciada para uso com o Barramento de Serviço do Azure, siga estas etapas de alto nível:
Habilite ou crie a identidade gerenciada para o recurso de aplicativo lógico. Para obter mais informações, consulte Autenticar o acesso aos recursos do Azure com identidades gerenciadas nos Aplicativos Lógicos do Azure.
Forneça acesso de identidade aos recursos do Barramento de Serviço do Azure. Para obter mais informações, consulte Atribuir uma função do Azure para direitos de acesso – Barramento de Serviço do Azure
Para uma identidade atribuída pelo usuário, adicione a identidade ao recurso do aplicativo lógico. Para obter mais informações sobre identidades gerenciadas nos Aplicativos Lógicos do Azure, consulte Autenticar o acesso aos recursos do Azure usando identidades gerenciadas nos Aplicativos Lógicos do Azure
Conector aprofundado
Este artigo descreve as operações para o conector gerenciado do Barramento de Serviço do Azure, que está disponível para Aplicativos Lógicos do Azure, Power Automate e Power Apps. O conector interno do Barramento de Serviço do Azure está disponível apenas para fluxos de trabalho do aplicativo lógico Standard nos Aplicativos Lógicos do Azure.
Para obter mais informações sobre o conector interno do Barramento de Serviço do Azure e o conector gerenciado nos Aplicativos Lógicos do Azure, consulte Conectar-se ao Barramento de Serviço do Azure a partir de fluxos de trabalho nos Aplicativos Lógicos do Azure.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Chave de Acesso | Forneça uma cadeia de conexão para acessar o Barramento de Serviço 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 |
| Chave de Acesso (Azure Governamental) | Forneça uma cadeia de conexão para acessar o Barramento de Serviço do Azure. | Governo do Azure e Departamento de Defesa (DoD) no Azure Governamental e governo dos EUA (GCC) e governo dos EUA (GCC-High) somente | Não 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 Barramento de Serviço 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 Barramento de Serviço do Azure. | Governo do Azure e Departamento de Defesa (DoD) no Azure Governamental e governo dos EUA (GCC) e governo dos EUA (GCC-High) somente | 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: connectionstringauth
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 uma cadeia de conexão para acessar o Barramento de Serviço 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.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Cadeia de conexão | secureString | Cadeia de conexão do Barramento de Serviço do Azure | Verdade |
Chave de Acesso (Azure Governamental)
ID de autenticação: connectionstringauth
Aplicável: Azure Governamental e Departamento de Defesa (DoD) somente no Azure Governamental e no Governo dos EUA (GCC) e governo dos EUA (GCC-High)
Forneça uma cadeia de conexão para acessar o Barramento de Serviço 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.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Cadeia de conexão | secureString | Cadeia de conexão do Barramento de Serviço do Azure | Verdade |
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 |
| Ponto de extremidade do namespace | cadeia | Fornecer ponto de extremidade do namespace do Barramento de Serviço (por exemplo: sb://testsb.servicebus.windows.net/) | 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 |
| Ponto de extremidade do namespace | cadeia | Fornecer ponto de extremidade do namespace do Barramento de Serviço (por exemplo: sb://testsb.servicebus.windows.net/) | Verdade |
Microsoft Entra ID Integrado
ID de autenticação: aadAuth
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 Barramento de Serviço 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.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Ponto de extremidade do namespace | cadeia | Fornecer ponto de extremidade do namespace do Barramento de Serviço (por exemplo: sb://testsb.servicebus.windows.net/) | Verdade |
Microsoft Entra ID Integrada (Azure Government)
ID de autenticação: aadAuth
Aplicável: Azure Governamental e Departamento de Defesa (DoD) somente no Azure Governamental e no Governo dos EUA (GCC) e governo dos EUA (GCC-High)
Use a ID do Microsoft Entra para acessar o Barramento de Serviço 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.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Ponto de extremidade do namespace | cadeia | Fornecer ponto de extremidade do namespace do Barramento de Serviço (por exemplo: sb://testsb.servicebus.windows.net/) | Verdade |
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 |
|---|---|---|---|
| Cadeia de conexão | secureString | Cadeia de conexão do Barramento de Serviço do Azure | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 6000 | 60 segundos |
Ações
| Abandonar a mensagem em uma assinatura de tópico |
A operação abandona uma mensagem em uma assinatura de tópico. |
| Abandonar a mensagem em uma fila |
A operação abandona uma mensagem em uma fila. |
| Adiar a mensagem em uma assinatura de tópico |
A operação adia uma mensagem em uma assinatura de tópico. |
| Adiar a mensagem em uma fila |
A operação adia uma mensagem em uma fila. |
| Concluir a mensagem em uma assinatura de tópico |
A operação conclui uma mensagem em uma assinatura de tópico. |
| Concluir a mensagem em uma fila |
A operação conclui uma mensagem em uma fila. |
| Criar uma assinatura de tópico |
A operação cria uma assinatura de tópico. |
| Enviar mensagem |
Esta operação envia uma mensagem para uma fila ou tópico. |
| Enviar uma ou mais mensagens |
Esta operação envia uma ou mais mensagens para uma fila ou tópico. |
| Excluir uma assinatura de tópico |
A operação exclui uma assinatura de tópico. |
| Fechar uma sessão em uma fila |
A operação fecha uma sessão em uma fila. |
| Fechar uma sessão no tópico |
A operação fecha uma sessão no tópico. |
| Mensagens mortas na mensagem em uma assinatura de tópico |
A operação move a mensagem para o tópico Dead-Letter Fila. |
| Mensagens mortas na mensagem em uma fila |
A operação move a mensagem para a fila Dead-Letter. |
| Obter mensagem adiada de uma assinatura de tópico |
A operação obtém uma mensagem adiada de uma assinatura de tópico. |
| Obter mensagem adiada de uma fila |
A operação obtém uma mensagem adiada de uma fila. |
| Obter mensagens de uma assinatura de tópico (peek-lock) |
A operação recebe mensagens de uma assinatura de tópico com peek-lock. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens. |
| Obter mensagens de uma fila (peek-lock) |
A operação recebe mensagens de uma fila com peek-lock. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens. |
| Renovar o bloqueio na mensagem em uma assinatura de tópico |
A operação renova o bloqueio em uma mensagem em uma assinatura de tópico. |
| Renovar o bloqueio na mensagem em uma fila |
A operação renova o bloqueio em uma mensagem em uma fila. |
| Renovar o bloqueio na sessão em uma assinatura de tópico |
A operação renova uma sessão em uma assinatura de tópico. |
| Renovar o bloqueio na sessão em uma fila |
A operação renova uma sessão em uma fila. |
Abandonar a mensagem em uma assinatura de tópico
A operação abandona uma mensagem em uma assinatura de tópico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Token de bloqueio da mensagem
|
lockToken | True | string |
Token de bloqueio da mensagem a ser abandonado |
|
Tipo de assinatura
|
subscriptionType | string |
Tipo de assinatura – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão |
Abandonar a mensagem em uma fila
A operação abandona uma mensagem em uma fila.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
Token de bloqueio da mensagem
|
lockToken | True | string |
Token de bloqueio da mensagem a ser abandonado |
|
Tipo de fila
|
queueType | string |
Tipo de fila – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão |
Adiar a mensagem em uma assinatura de tópico
A operação adia uma mensagem em uma assinatura de tópico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Token de bloqueio da mensagem
|
lockToken | True | string |
Token de bloqueio da mensagem a ser adiada |
|
Tipo de assinatura
|
subscriptionType | string |
Tipo de assinatura – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão |
Adiar a mensagem em uma fila
A operação adia uma mensagem em uma fila.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
Token de bloqueio da mensagem
|
lockToken | True | string |
Token de bloqueio da mensagem a ser adiada |
|
Tipo de fila
|
queueType | string |
Tipo de fila – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão |
Concluir a mensagem em uma assinatura de tópico
A operação conclui uma mensagem em uma assinatura de tópico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Token de bloqueio da mensagem
|
lockToken | True | string |
Token de bloqueio da mensagem a ser concluída |
|
Tipo de assinatura
|
subscriptionType | string |
Tipo de assinatura – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão |
Concluir a mensagem em uma fila
A operação conclui uma mensagem em uma fila.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
Token de bloqueio da mensagem
|
lockToken | True | string |
Token de bloqueio da mensagem a ser concluída |
|
Tipo de fila
|
queueType | string |
Tipo de fila – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão |
Criar uma assinatura de tópico
A operação cria uma assinatura de tópico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Filter
|
subscriptionFilter | True | dynamic |
Filtro de assinatura |
|
Tipo de filtro
|
subscriptionFilterType | string |
Tipo de filtro |
Retornos
A assinatura do tópico.
- Corpo
- Subscription
Enviar mensagem
Esta operação envia uma mensagem para uma fila ou tópico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila/tópico
|
entityName | True | string |
Nome da fila ou tópico |
|
Content
|
ContentData | byte |
Conteúdo da mensagem |
|
|
Tipo de conteúdo
|
ContentType | string |
Tipo de conteúdo do conteúdo da mensagem |
|
|
Propriedades
|
Properties | object |
Pares chave-valor para cada propriedade agenciada |
|
|
ID da mensagem
|
MessageId | string |
Esse é um valor definido pelo usuário que o Barramento de Serviço pode usar para identificar mensagens duplicadas, se habilitado. |
|
|
Para
|
To | string |
Enviar para o endereço |
|
|
Responder Para
|
ReplyTo | string |
Endereço da fila para responder |
|
|
Responder à ID da sessão
|
ReplyToSessionId | string |
Identificador da sessão para responder |
|
|
Etiqueta
|
Label | string |
Rótulo específico do aplicativo |
|
|
ScheduledEnqueueTimeUtc
|
ScheduledEnqueueTimeUtc | date-time |
Data e hora, em UTC, quando a mensagem será adicionada à fila |
|
|
Id da Sessão
|
SessionId | string |
Identificador da sessão |
|
|
ID de correlação
|
CorrelationId | string |
Identificador da correlação |
|
|
Número da sequência
|
SequenceNumber | integer |
Identificador do número da sequência |
|
|
Token de bloqueio
|
LockToken | string |
O token de bloqueio da mensagem como uma cadeia de caracteres. |
|
|
Vida útil
|
TimeToLive | integer |
Essa é a duração, em tiques, de que uma mensagem é válida. A duração começa a partir de quando a mensagem é enviada para o Barramento de Serviço. |
|
|
Propriedades do sistema
|
systemProperties | string |
Propriedades do sistema – Nenhum ou Detalhes de Execução. Os Detalhes de Execução adicionarão detalhes da propriedade de metadados de execução como propriedades personalizadas na mensagem. |
Enviar uma ou mais mensagens
Esta operação envia uma ou mais mensagens para uma fila ou tópico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila/tópico
|
entityName | True | string |
Nome da fila ou tópico |
|
Content
|
ContentData | byte |
Conteúdo da mensagem |
|
|
Tipo de conteúdo
|
ContentType | string |
Tipo de conteúdo do conteúdo da mensagem |
|
|
Propriedades
|
Properties | object |
Pares chave-valor para cada propriedade agenciada |
|
|
ID da mensagem
|
MessageId | string |
Esse é um valor definido pelo usuário que o Barramento de Serviço pode usar para identificar mensagens duplicadas, se habilitado. |
|
|
Para
|
To | string |
Enviar para o endereço |
|
|
Responder Para
|
ReplyTo | string |
Endereço da fila para responder |
|
|
Responder à ID da sessão
|
ReplyToSessionId | string |
Identificador da sessão para responder |
|
|
Etiqueta
|
Label | string |
Rótulo específico do aplicativo |
|
|
ScheduledEnqueueTimeUtc
|
ScheduledEnqueueTimeUtc | date-time |
Data e hora, em UTC, quando a mensagem será adicionada à fila |
|
|
Id da Sessão
|
SessionId | string |
Identificador da sessão |
|
|
ID de correlação
|
CorrelationId | string |
Identificador da correlação |
|
|
Número da sequência
|
SequenceNumber | integer |
Identificador do número da sequência |
|
|
Token de bloqueio
|
LockToken | string |
O token de bloqueio da mensagem como uma cadeia de caracteres. |
|
|
Vida útil
|
TimeToLive | integer |
Essa é a duração, em tiques, de que uma mensagem é válida. A duração começa a partir de quando a mensagem é enviada para o Barramento de Serviço. |
|
|
Propriedades do sistema
|
systemProperties | string |
Propriedades do sistema – Nenhum ou Detalhes de Execução. Os Detalhes de Execução adicionarão detalhes da propriedade de metadados de execução como propriedades personalizadas na mensagem. |
Excluir uma assinatura de tópico
A operação exclui uma assinatura de tópico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
Fechar uma sessão em uma fila
A operação fecha uma sessão em uma fila.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome de uma fila |
|
ID da sessão
|
sessionId | True | string |
ID da sessão |
Fechar uma sessão no tópico
A operação fecha uma sessão no tópico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
ID da sessão
|
sessionId | True | string |
ID da sessão |
Mensagens mortas na mensagem em uma assinatura de tópico
A operação move a mensagem para o tópico Dead-Letter Fila.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Token de bloqueio da mensagem
|
lockToken | True | string |
Bloquear o token da mensagem para a letra morta |
|
ID da sessão
|
sessionId | string |
ID da sessão |
|
|
Motivo da carta morta
|
deadLetterReason | string |
Motivo da carta morta |
|
|
Descrição do erro de carta morta
|
deadLetterErrorDescription | string |
Descrição do erro de carta morta |
Mensagens mortas na mensagem em uma fila
A operação move a mensagem para a fila Dead-Letter.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
Token de bloqueio da mensagem
|
lockToken | True | string |
Bloquear o token da mensagem para a letra morta |
|
ID da sessão
|
sessionId | string |
ID da sessão |
|
|
Motivo da carta morta
|
deadLetterReason | string |
Motivo da carta morta |
|
|
Descrição do erro de carta morta
|
deadLetterErrorDescription | string |
Descrição do erro de carta morta |
Obter mensagem adiada de uma assinatura de tópico
A operação obtém uma mensagem adiada de uma assinatura de tópico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Número de sequência de mensagens
|
sequenceNumber | True | integer |
Número de sequência de mensagens |
|
Tipo de assinatura
|
subscriptionType | string |
Tipo de fila – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão |
Retornos
Mensagem do Barramento de Serviço
- Corpo
- ServiceBusMessage
Obter mensagem adiada de uma fila
A operação obtém uma mensagem adiada de uma fila.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
Número de sequência de mensagens
|
sequenceNumber | True | integer |
Número de sequência de mensagens |
|
Tipo de fila
|
queueType | string |
Tipo de fila – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão |
Retornos
Mensagem do Barramento de Serviço
- Corpo
- ServiceBusMessage
Obter mensagens de uma assinatura de tópico (peek-lock)
A operação recebe mensagens de uma assinatura de tópico com peek-lock. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Contagem máxima de mensagens
|
maxMessageCount | integer |
O número máximo de mensagens a serem retornadas no lote |
|
|
Tipo de assinatura
|
subscriptionType | string |
Tipo de assinatura – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão |
Retornos
- response
- array of ServiceBusMessage
Obter mensagens de uma fila (peek-lock)
A operação recebe mensagens de uma fila com peek-lock. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
Contagem máxima de mensagens
|
maxMessageCount | integer |
O número máximo de mensagens a serem retornadas no lote |
|
|
Tipo de fila
|
queueType | string |
Tipo de fila – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão |
Retornos
- response
- array of ServiceBusMessage
Renovar o bloqueio na mensagem em uma assinatura de tópico
A operação renova o bloqueio em uma mensagem em uma assinatura de tópico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Token de bloqueio da mensagem
|
lockToken | True | string |
Token de bloqueio da mensagem para renovar o bloqueio |
|
Tipo de assinatura
|
subscriptionType | string |
Tipo de assinatura – Main ou DeadLetter |
Renovar o bloqueio na mensagem em uma fila
A operação renova o bloqueio em uma mensagem em uma fila.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
Token de bloqueio da mensagem
|
lockToken | True | string |
Token de bloqueio da mensagem para renovar o bloqueio |
|
Tipo de fila
|
queueType | string |
Tipo de fila – Main ou DeadLetter |
Renovar o bloqueio na sessão em uma assinatura de tópico
A operação renova uma sessão em uma assinatura de tópico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
ID da sessão
|
sessionId | True | string |
ID da sessão |
Renovar o bloqueio na sessão em uma fila
A operação renova uma sessão em uma fila.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
ID da sessão
|
sessionId | True | string |
ID da sessão |
Gatilhos
| Quando uma mensagem é recebida em uma assinatura de tópico (peek-lock) |
A operação dispara um fluxo quando uma mensagem recebida em uma assinatura de tópico com o modo peek-lock. |
| Quando uma mensagem é recebida em uma assinatura de tópico (preenchimento automático) |
Essa operação dispara um fluxo quando uma mensagem é recebida em uma assinatura de tópico e conclui automaticamente a mensagem. |
| Quando uma mensagem é recebida em uma fila (peek-lock) |
A operação dispara um fluxo quando uma mensagem recebida em uma fila com modo de bloqueio de espiada. |
| Quando uma mensagem é recebida em uma fila (preenchimento automático) |
Essa operação dispara um fluxo quando uma mensagem é recebida em uma fila e conclui automaticamente a mensagem. |
| Quando uma ou mais mensagens chegam em um tópico (peek-lock) |
A operação recebe uma ou mais mensagens de um tópico com peek-lock. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens. |
| Quando uma ou mais mensagens chegam em um tópico (preenchimento automático) |
A operação recebe uma ou mais mensagens de um tópico. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens. |
| Quando uma ou mais mensagens chegam em uma fila (peek-lock) |
A operação recebe uma ou mais mensagens de uma fila com peek-lock. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens. |
| Quando uma ou mais mensagens chegam em uma fila (preenchimento automático) |
A operação recebe uma ou mais mensagens de uma fila. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens. |
Quando uma mensagem é recebida em uma assinatura de tópico (peek-lock)
A operação dispara um fluxo quando uma mensagem recebida em uma assinatura de tópico com o modo peek-lock.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Tipo de assinatura
|
subscriptionType | string |
Tipo de assinatura – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão – Nenhum ou Próximo Disponível ou fornecer id de sessão |
Retornos
Mensagem do Barramento de Serviço
- Corpo
- ServiceBusMessage
Quando uma mensagem é recebida em uma assinatura de tópico (preenchimento automático)
Essa operação dispara um fluxo quando uma mensagem é recebida em uma assinatura de tópico e conclui automaticamente a mensagem.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Tipo de assinatura
|
subscriptionType | string |
Tipo de assinatura – Main ou DeadLetter |
Retornos
Mensagem do Barramento de Serviço
- Corpo
- ServiceBusMessage
Quando uma mensagem é recebida em uma fila (peek-lock)
A operação dispara um fluxo quando uma mensagem recebida em uma fila com modo de bloqueio de espiada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
Tipo de fila
|
queueType | string |
Tipo de fila – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão – Nenhum ou Próximo Disponível ou fornecer id de sessão |
Retornos
Mensagem do Barramento de Serviço
- Corpo
- ServiceBusMessage
Quando uma mensagem é recebida em uma fila (preenchimento automático)
Essa operação dispara um fluxo quando uma mensagem é recebida em uma fila e conclui automaticamente a mensagem.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
Tipo de fila
|
queueType | string |
Tipo de fila – Main ou DeadLetter |
Retornos
Mensagem do Barramento de Serviço
- Corpo
- ServiceBusMessage
Quando uma ou mais mensagens chegam em um tópico (peek-lock)
A operação recebe uma ou mais mensagens de um tópico com peek-lock. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Contagem máxima de mensagens
|
maxMessageCount | integer |
O número máximo de mensagens a serem retornadas no lote |
|
|
Tipo de assinatura
|
subscriptionType | string |
Tipo de assinatura – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão – Nenhum ou Próximo Disponível ou fornecer id de sessão |
Retornos
Mensagem do Barramento de Serviço
- Corpo
- ServiceBusMessage
Quando uma ou mais mensagens chegam em um tópico (preenchimento automático)
A operação recebe uma ou mais mensagens de um tópico. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
|
Nome da assinatura do tópico
|
subscriptionName | True | string |
Nome da assinatura do tópico |
|
Contagem máxima de mensagens
|
maxMessageCount | integer |
O número máximo de mensagens a serem retornadas no lote |
|
|
Tipo de assinatura
|
subscriptionType | string |
Tipo de assinatura – Main ou DeadLetter |
Retornos
Mensagem do Barramento de Serviço
- Corpo
- ServiceBusMessage
Quando uma ou mais mensagens chegam em uma fila (peek-lock)
A operação recebe uma ou mais mensagens de uma fila com peek-lock. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
Contagem máxima de mensagens
|
maxMessageCount | integer |
O número máximo de mensagens a serem retornadas no lote |
|
|
Tipo de fila
|
queueType | string |
Tipo de fila – Main ou DeadLetter |
|
|
ID da sessão
|
sessionId | string |
ID da sessão – Nenhum ou Próximo Disponível ou fornecer id de sessão |
Retornos
Mensagem do Barramento de Serviço
- Corpo
- ServiceBusMessage
Quando uma ou mais mensagens chegam em uma fila (preenchimento automático)
A operação recebe uma ou mais mensagens de uma fila. Se a contagem máxima de mensagens não for fornecida, ela lerá 20 mensagens.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da fila
|
queueName | True | string |
Nome da fila |
|
Contagem máxima de mensagens
|
maxMessageCount | integer |
O número máximo de mensagens a serem retornadas no lote |
|
|
Tipo de fila
|
queueType | string |
Tipo de fila – Main ou DeadLetter |
Retornos
Mensagem do Barramento de Serviço
- Corpo
- ServiceBusMessage
Definições
ServiceBusMessage
Mensagem do Barramento de Serviço
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Content
|
ContentData | byte |
Conteúdo da mensagem |
|
Tipo de conteúdo
|
ContentType | string |
Tipo de conteúdo do conteúdo da mensagem |
|
Propriedades
|
Properties | object |
Pares chave-valor para cada propriedade agenciada |
|
ID da mensagem
|
MessageId | string |
Esse é um valor definido pelo usuário que o Barramento de Serviço pode usar para identificar mensagens duplicadas, se habilitado. |
|
Para
|
To | string |
Enviar para o endereço |
|
Responder Para
|
ReplyTo | string |
Endereço da fila para responder |
|
Responder à ID da sessão
|
ReplyToSessionId | string |
Identificador da sessão para responder |
|
Etiqueta
|
Label | string |
Rótulo específico do aplicativo |
|
ScheduledEnqueueTimeUtc
|
ScheduledEnqueueTimeUtc | date-time |
Data e hora, em UTC, quando a mensagem será adicionada à fila |
|
Id da Sessão
|
SessionId | string |
Identificador da sessão |
|
ID de correlação
|
CorrelationId | string |
Identificador da correlação |
|
Número da sequência
|
SequenceNumber | integer |
Identificador do número da sequência |
|
Token de bloqueio
|
LockToken | string |
O token de bloqueio da mensagem como uma cadeia de caracteres. |
|
Vida útil
|
TimeToLive | integer |
Essa é a duração, em tiques, de que uma mensagem é válida. A duração começa a partir de quando a mensagem é enviada para o Barramento de Serviço. |
Subscription
A assinatura do tópico.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome da assinatura
|
SubscriptionName | string |
Nome da assinatura. |