ServiceBusRuleManager.CreateRuleAsync Método

Definição

Namespace:

Azure.Messaging.ServiceBus

Assembly:

Azure.Messaging.ServiceBus.dll

Pacote:

Azure.Messaging.ServiceBus v7.17.5

Sobrecargas

CreateRuleAsync(CreateRuleOptions, CancellationToken)	Adiciona uma regra à assinatura atual para filtrar as mensagens que chegam do tópico à assinatura.
CreateRuleAsync(String, RuleFilter, CancellationToken)	Adiciona uma regra à assinatura atual para filtrar as mensagens que chegam do tópico à assinatura.

CreateRuleAsync(CreateRuleOptions, CancellationToken)

Origem:

ServiceBusRuleManager.cs

Adiciona uma regra à assinatura atual para filtrar as mensagens que chegam do tópico à assinatura.

public virtual System.Threading.Tasks.Task CreateRuleAsync (Azure.Messaging.ServiceBus.Administration.CreateRuleOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateRuleAsync : Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CreateRuleAsync : Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function CreateRuleAsync (options As CreateRuleOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Parâmetros

options

CreateRuleOptions

As opções para a regra a ser adicionada.

cancellationToken

CancellationToken

Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.

Retornos

Task

Uma instância de tarefa que representa a operação de adicionar regra assíncrona.

Exceções

ServiceBusException

• Existe uma regra com o mesmo nome na assinatura. O Reason será definido como MessagingEntityAlreadyExists neste caso.
• A operação atingiu o tempo limite. O Reason será definido como ServiceTimeout neste caso.
• Não há suporte para o tamanho especificado da entidade ou a cota máxima permitida foi atingida. Você deve especificar um dos valores de tamanho com suporte, excluir entidades existentes ou aumentar o tamanho da cota. O motivo da falha será definido como QuotaExceeded neste caso.
• O servidor está ocupado. Você deve aguardar antes de repetir a operação. O motivo da falha será definido como ServiceBusy neste caso.
• Ocorre um erro interno ou uma exceção inesperada. O motivo da falha será definido como GeneralError neste caso.

Comentários

Você pode adicionar regras à assinatura que decide quais mensagens do tópico devem chegar à assinatura. Uma regra padrão TrueRuleFilter chamada DefaultRuleName sempre é adicionada durante a criação da Assinatura. Você pode adicionar várias regras com nomes distintos à mesma assinatura. Vários filtros se combinam entre si usando a condição OR lógica. Ou seja, se qualquer filtro for bem-sucedido, a mensagem será passada para a assinatura.

CreateRuleAsync(String, RuleFilter, CancellationToken)

Origem:

ServiceBusRuleManager.cs

Adiciona uma regra à assinatura atual para filtrar as mensagens que chegam do tópico à assinatura.

public virtual System.Threading.Tasks.Task CreateRuleAsync (string ruleName, Azure.Messaging.ServiceBus.Administration.RuleFilter filter, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateRuleAsync : string * Azure.Messaging.ServiceBus.Administration.RuleFilter * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CreateRuleAsync : string * Azure.Messaging.ServiceBus.Administration.RuleFilter * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function CreateRuleAsync (ruleName As String, filter As RuleFilter, Optional cancellationToken As CancellationToken = Nothing) As Task

Parâmetros

ruleName

String

Nome da regra

filter

RuleFilter

A expressão de filtro na qual as mensagens serão correspondidas.

cancellationToken

CancellationToken

Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.

Retornos

Task

Uma instância de tarefa que representa a operação de adicionar regra assíncrona.

Exceções

ServiceBusException

• Existe uma regra com o mesmo nome na assinatura. O Reason será definido como MessagingEntityAlreadyExists neste caso.
• A operação atingiu o tempo limite. O Reason será definido como ServiceTimeout neste caso.
• Não há suporte para o tamanho especificado da entidade ou a cota máxima permitida foi atingida. Você deve especificar um dos valores de tamanho com suporte, excluir entidades existentes ou aumentar o tamanho da cota. O motivo da falha será definido como QuotaExceeded neste caso.
• O servidor está ocupado. Você deve aguardar antes de repetir a operação. O motivo da falha será definido como ServiceBusy neste caso.
• Ocorre um erro interno ou uma exceção inesperada. O motivo da falha será definido como GeneralError neste caso.

Comentários

Você pode adicionar regras à assinatura que decide quais mensagens do tópico devem chegar à assinatura. Uma regra padrão TrueRuleFilter chamada DefaultRuleName sempre é adicionada durante a criação da Assinatura. Você pode adicionar várias regras com nomes distintos à mesma assinatura. Vários filtros se combinam entre si usando a condição OR lógica. Ou seja, se qualquer filtro for bem-sucedido, a mensagem será passada para a assinatura.