ServiceBusAdministrationClient.GetRuleAsync Método

Definição

Namespace:

Azure.Messaging.ServiceBus.Administration

Assembly:

Azure.Messaging.ServiceBus.dll

Pacote:

Azure.Messaging.ServiceBus v7.17.5

Origem:

ServiceBusAdministrationClient.cs

Recupera uma regra do namespace de serviço.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>> GetRuleAsync (string topicName, string subscriptionName, string ruleName, System.Threading.CancellationToken cancellationToken = default);

abstract member GetRuleAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>>
override this.GetRuleAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>>

Public Overridable Function GetRuleAsync (topicName As String, subscriptionName As String, ruleName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of RuleProperties))

Parâmetros

topicName

String

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

subscriptionName

String

O nome da assinatura ao qual a regra pertence.

ruleName

String

O nome da regra a ser recuperada.

cancellationToken

CancellationToken

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

Retornos

Task<Response<RuleProperties>>

RuleProperties que contém informações sobre a regra.

Exceções

ServiceTimeout

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.

MessagingEntityNotFound

Tópico/Assinatura/Regra com esse nome não existe.

ServiceBusy

O servidor está ocupado. Você deve aguardar antes de repetir a operação.

ArgumentNullException

O tópico, assinatura ou nome da regra é nulo ou vazio.

ArgumentOutOfRangeException

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

ArgumentException

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

UnauthorizedAccessException

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

ServiceBusException

• Não foi possível encontrar a entidade especificada. O Reason será definido como MessagingEntityNotFound neste caso.
• A operação atingiu o tempo limite. O Reason será definido como ServiceTimeout 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

Observação – somente os tipos de dados a seguir são desserializados em Filtros e Parâmetros de ação – cadeia de caracteres, int,long,bool,double,DateTime. Outros tipos de dados retornariam seu valor de cadeia de caracteres.