ServiceBusRuleManager.CreateRuleAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| CreateRuleAsync(CreateRuleOptions, CancellationToken) |
Adiciona uma regra à subscrição atual para filtrar as mensagens que chegam do tópico à subscrição. |
| CreateRuleAsync(String, RuleFilter, CancellationToken) |
Adiciona uma regra à subscrição atual para filtrar as mensagens que chegam do tópico à subscrição. |
CreateRuleAsync(CreateRuleOptions, CancellationToken)
Adiciona uma regra à subscrição atual para filtrar as mensagens que chegam do tópico à subscrição.
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.TaskPublic Overridable Function CreateRuleAsync (options As CreateRuleOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- options
- CreateRuleOptions
As opções para adicionar a regra.
- cancellationToken
- CancellationToken
Uma instância opcional CancellationToken para sinalizar o pedido para cancelar a operação.
Devoluções
Uma instância de tarefa que representa a operação de adicionar regra assíncrona.
Exceções
- Existe uma regra com o mesmo nome na subscrição. O Reason será definido como MessagingEntityAlreadyExists neste caso.
- A operação excedeu o limite de tempo. O Reason será definido como ServiceTimeout neste caso.
- O tamanho especificado da entidade não é suportado ou a quota máxima permitido foi atingida. Tem de especificar um dos valores de tamanho suportados, eliminar entidades existentes ou aumentar o tamanho da quota. O motivo da falha será definido como QuotaExceeded neste caso.
- O servidor está ocupado. 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.
Observações
Pode adicionar regras à subscrição que decide que mensagens do tópico devem chegar à subscrição. Uma regra predefinida TrueRuleFilter com o nome DefaultRuleName é sempre adicionada durante a criação da Subscrição. Pode adicionar várias regras com nomes distintos à mesma subscrição. Vários filtros combinam-se uns com os outros através da condição LÓGICA OU. Ou seja, se algum filtro for bem-sucedido, a mensagem é transmitida para a subscrição.
Aplica-se a
CreateRuleAsync(String, RuleFilter, CancellationToken)
Adiciona uma regra à subscrição atual para filtrar as mensagens que chegam do tópico à subscrição.
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.TaskPublic Overridable Function CreateRuleAsync (ruleName As String, filter As RuleFilter, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- ruleName
- String
Nome da regra
- filter
- RuleFilter
A expressão de filtro em relação à qual as mensagens serão correspondidas.
- cancellationToken
- CancellationToken
Uma instância opcional CancellationToken para sinalizar o pedido para cancelar a operação.
Devoluções
Uma instância de tarefa que representa a operação de adicionar regra assíncrona.
Exceções
- Existe uma regra com o mesmo nome na subscrição. O Reason será definido como MessagingEntityAlreadyExists neste caso.
- A operação excedeu o limite de tempo. O Reason será definido como ServiceTimeout neste caso.
- O tamanho especificado da entidade não é suportado ou a quota máxima permitido foi atingida. Tem de especificar um dos valores de tamanho suportados, eliminar entidades existentes ou aumentar o tamanho da quota. O motivo da falha será definido como QuotaExceeded neste caso.
- O servidor está ocupado. 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.
Observações
Pode adicionar regras à subscrição que decide que mensagens do tópico devem chegar à subscrição. Uma regra predefinida TrueRuleFilter com o nome DefaultRuleName é sempre adicionada durante a criação da Subscrição. Pode adicionar várias regras com nomes distintos à mesma subscrição. Vários filtros combinam-se uns com os outros através da condição LÓGICA OU. Ou seja, se algum filtro for bem-sucedido, a mensagem é transmitida para a subscrição.