ServiceBusAdministrationClient.CreateRuleAsync Método

Referencia

Definición

Espacio de nombres:: Azure.Messaging.ServiceBus.Administration

Ensamblado:: Azure.Messaging.ServiceBus.dll

Paquete:: Azure.Messaging.ServiceBus v7.17.5

Paquete:: Azure.Messaging.ServiceBus v7.18.0-beta.1

Source:: ServiceBusAdministrationClient.cs

Source:: ServiceBusAdministrationClient.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Agrega una nueva regla a la suscripción en un tema determinado.

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

Nombre del tema relativo a la dirección base del espacio de nombres del servicio.

subscriptionName: String

Nombre de la suscripción.

options: CreateRuleOptions

Objeto CreateRuleOptions en el que se describen los atributos con los que coinciden los mensajes y se actúan sobre ellos.

cancellationToken: CancellationToken

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

Devoluciones

Task<Response<RuleProperties>>

RuleProperties de la regla creada recientemente.

Excepciones

MessagingEntityAlreadyExists

Existe una suscripción con el mismo nombre en el mismo espacio de nombres de servicio.

ServiceTimeout

La operación agota el tiempo de espera. 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 de tiempo de espera para evitar esta excepción si el valor de tiempo de espera es relativamente bajo.

QuotaExceeded

No se admite el tamaño especificado en la descripción o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota.

ServiceBusy

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

ArgumentNullException

El nombre del tema, el nombre de la suscripción o options la instancia es null.

ArgumentOutOfRangeException

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

ArgumentException

El nombre del tema o la suscripción no es válido.

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

Existe una regla con el mismo nombre en la suscripción. Reason Se establecerá MessagingEntityAlreadyExists en en este caso.
Se agota el tiempo de espera de la operación. Reason Se establecerá ServiceTimeout en en este caso.
No se admite el tamaño especificado de la entidad o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota. El motivo del error se establecerá QuotaExceeded 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.

Se aplica a

Compartir a través de