Compartilhar via


ServiceBusAdministrationClient.CreateRuleAsync Método

Definição

Adiciona uma nova regra à assinatura sob determinado tópico.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>> CreateRuleAsync (string topicName, string subscriptionName, Azure.Messaging.ServiceBus.Administration.CreateRuleOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateRuleAsync : string * string * Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>>
override this.CreateRuleAsync : string * string * Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>>
Public Overridable Function CreateRuleAsync (topicName As String, subscriptionName As String, options As CreateRuleOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of RuleProperties))

Parâmetros

topicName
String

O nome do tópico relativo ao endereço base do namespace de serviço.

subscriptionName
String

O nome da assinatura.

options
CreateRuleOptions

Um CreateRuleOptions objeto que descreve os atributos com os quais as mensagens são correspondidas e executadas.

cancellationToken
CancellationToken

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

Retornos

RuleProperties da regra criada recentemente.

Exceções

Existe uma assinatura com o mesmo nome no mesmo namespace de serviço.

A operação atinge o tempo limite. O período de tempo limite é inicializado por meio da ServiceBusAdministrationClientOptions classe (consulte Propriedade Retry). Talvez seja necessário aumentar o valor do tempo limite para evitar essa exceção se o valor do tempo limite for relativamente baixo.

Não há suporte para o tamanho especificado na descrição 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 servidor está ocupado. Você deve aguardar antes de repetir a operação.

O nome do tópico, o nome da assinatura ou a options instância são nulos.

O nome do tópico ou da assinatura excede o comprimento máximo permitido.

O nome do tópico ou da assinatura é inválido.

Permissão insuficiente para executar essa operação. Você deve marcar para garantir que você ServiceBusAdministrationClient tenha as declarações necessárias para executar essa operação. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations

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

Aplica-se a