ServiceBusAdministrationClient.GetRuleAsync Méthode

Définition

Espace de noms:

Azure.Messaging.ServiceBus.Administration

Assembly:

Azure.Messaging.ServiceBus.dll

Paquet:

Azure.Messaging.ServiceBus v7.17.5

Source:

ServiceBusAdministrationClient.cs

Récupère une règle à partir de l’espace de noms de service.

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))

Paramètres

topicName

String

Nom de la rubrique relative à l’espace de noms Service Bus.

subscriptionName

String

Nom de l’abonnement auquel appartient la règle.

ruleName

String

Nom de la règle à récupérer.

cancellationToken

CancellationToken

Une instance facultative CancellationToken pour signaler la demande d’annulation de l’opération.

Retours

Task<Response<RuleProperties>>

RuleProperties contenant des informations sur la règle.

Exceptions

ServiceTimeout

L’opération expire. Le délai d’attente est initialisé par le biais de la ServiceBusAdministrationClientOptions classe (voir Propriété Réessayer). Vous devrez peut-être augmenter la valeur du délai d’expiration pour éviter cette exception si la valeur du délai d’expiration est relativement faible.

MessagingEntityNotFound

La rubrique/l’abonnement/la règle portant ce nom n’existe pas.

ServiceBusy

Le serveur est occupé. Vous devez attendre avant de réessayer l’opération.

ArgumentNullException

Le nom de la rubrique, de l’abonnement ou de la règle est null ou vide.

ArgumentOutOfRangeException

La rubrique, l’abonnement ou le nom de règle dépasse la longueur maximale autorisée.

ArgumentException

Le nom de la rubrique, de l’abonnement ou de la règle n’est pas valide.

UnauthorizedAccessException

Autorisation insuffisante pour effectuer cette opération. Vous devez case activée pour vous assurer que votre ServiceBusAdministrationClient dispose des revendications nécessaires pour effectuer cette opération. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations

ServiceBusException

• L’entité spécifiée est introuvable. Reason le sera défini sur MessagingEntityNotFound dans ce cas.
• L’opération a expiré. Reason le sera défini sur ServiceTimeout dans ce cas.
• Le serveur est occupé. Vous devez attendre avant de réessayer l’opération. La raison de l’échec est définie sur ServiceBusy dans ce cas.
• Une erreur interne ou une exception inattendue se produit. La raison de l’échec est définie sur GeneralError dans ce cas.

Remarques

Remarque : seuls les types de données suivants sont désérialisés dans filtres et paramètres d’action - string,int,long,bool,double,DateTime. D’autres types de données retournent sa valeur de chaîne.