ServiceBusAdministrationClient.GetRulesAsync 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 o conjunto de regras para uma determinada assinatura em um tópico.

public virtual Azure.AsyncPageable<Azure.Messaging.ServiceBus.Administration.RuleProperties> GetRulesAsync (string topicName, string subscriptionName, System.Threading.CancellationToken cancellationToken = default);

abstract member GetRulesAsync : string * string * System.Threading.CancellationToken -> Azure.AsyncPageable<Azure.Messaging.ServiceBus.Administration.RuleProperties>
override this.GetRulesAsync : string * string * System.Threading.CancellationToken -> Azure.AsyncPageable<Azure.Messaging.ServiceBus.Administration.RuleProperties>

Public Overridable Function GetRulesAsync (topicName As String, subscriptionName As String, Optional cancellationToken As CancellationToken = Nothing) As AsyncPageable(Of RuleProperties)

Parâmetros

topicName

String

O nome do tópico.

subscriptionName

String

A assinatura para a qual todas as regras precisam ser recuperadas.

cancellationToken

CancellationToken

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

Retornos

AsyncPageable<RuleProperties>

Um AsyncPageable<T> que descreve as regras.

Exceções

ServiceTimeout

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

ServiceBusy

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

ArgumentNullException

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

ArgumentOutOfRangeException

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

ArgumentException

O nome do tópico ou da assinatura é 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 MessagingEntityNotFound como nesse caso.
• A operação atingiu o tempo limite. O Reason será definido ServiceTimeout como nesse caso.
• O servidor está ocupado. Você deve aguardar antes de repetir a operação. O motivo da falha será definido ServiceBusy como nesse caso.
• Ocorre um erro interno ou uma exceção inesperada. O motivo da falha será definido GeneralError como nesse caso.

Comentários

O valor máximo permitido é 100 por página.