ServiceBusAdministrationClient.GetRuleAsync Método

Definición

Espacio de nombres:

Azure.Messaging.ServiceBus.Administration

Ensamblado:

Azure.Messaging.ServiceBus.dll

Paquete:

Azure.Messaging.ServiceBus v7.17.5

Source:

ServiceBusAdministrationClient.cs

Recupera una regla del espacio de nombres del servicio.

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

Nombre del tema relativo al espacio de nombres de Service Bus.

subscriptionName

String

Nombre de suscripción al que pertenece la regla.

ruleName

String

Nombre de la regla que se va a recuperar.

cancellationToken

CancellationToken

Una instancia opcional CancellationToken para indicar la solicitud para cancelar la operación.

Devoluciones

Task<Response<RuleProperties>>

RuleProperties que contiene información sobre la regla.

Excepciones

ServiceTimeout

Se agota el tiempo de espera de la operación. El período de tiempo de espera se inicializa a través de la ServiceBusAdministrationClientOptions clase (consulte la propiedad Retry). Es posible que tenga que aumentar el valor del tiempo de espera para evitar esta excepción si el valor de tiempo de espera es relativamente bajo.

MessagingEntityNotFound

Tema, suscripción o regla con este nombre no existe.

ServiceBusy

El servidor está ocupado. Debe esperar antes de volver a intentar la operación.

ArgumentNullException

El tema, la suscripción o el nombre de la regla son nulos o están vacíos.

ArgumentOutOfRangeException

El nombre de tema, suscripción o regla supera la longitud máxima permitida.

ArgumentException

El tema, la suscripción o el nombre de la regla no son válidos.

UnauthorizedAccessException

Permiso insuficiente para realizar esta operación. Debe comprobar para asegurarse de que ServiceBusAdministrationClient tiene las notificaciones necesarias para realizar esta operación. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations

ServiceBusException

• No se encontró la entidad especificada. Reason Se establecerá MessagingEntityNotFound en en este caso.
• Se agota el tiempo de espera de la operación. Reason Se establecerá ServiceTimeout en en este caso.
• El servidor está ocupado. Debe esperar antes de volver a intentar la operación. El motivo del error se establecerá ServiceBusy en en este caso.
• Se produce un error interno o una excepción inesperada. El motivo del error se establecerá GeneralError en en este caso.

Comentarios

Nota: solo los siguientes tipos de datos se deserializan en los parámetros Filters y Action : string,int,long,bool,double,DateTime. Otros tipos de datos devolverían su valor de cadena.