ServiceBusAdministrationClient.CreateRuleAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute une nouvelle règle à l’abonnement sous une rubrique donnée.
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))Paramètres
- topicName
- String
Nom de la rubrique relative à l’adresse de base de l’espace de noms de service.
- subscriptionName
- String
Nom de l'abonnement.
- options
- CreateRuleOptions
Objet CreateRuleOptions décrivant les attributs avec lesquels les messages sont mis en correspondance et sur lesquels ils sont suivis.
- cancellationToken
- CancellationToken
Une instance facultative CancellationToken pour signaler la demande d’annulation de l’opération.
Retours
RuleProperties de la règle récemment créée.
Exceptions
Un abonnement portant le même nom existe sous le même espace de noms de service.
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.
La taille spécifiée dans la description n’est pas prise en charge ou le quota maximal autorisé a été atteint. Vous devez spécifier l’une des valeurs de taille prises en charge, supprimer des entités existantes ou augmenter la taille de votre quota.
Le serveur est occupé. Vous devez attendre avant de réessayer l’opération.
Le nom de la rubrique, le nom de l’abonnement ou options le instance est null.
Le nom de la rubrique ou de l’abonnement dépasse la longueur maximale autorisée.
Le nom de la rubrique ou de l’abonnement n’est pas valide.
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
- Une règle portant le même nom existe sous l’abonnement. Reason le sera défini sur MessagingEntityAlreadyExists dans ce cas.
- L’opération a expiré. Reason le sera défini sur ServiceTimeout dans ce cas.
- La taille spécifiée de l’entité n’est pas prise en charge ou le quota maximal autorisé a été atteint. Vous devez spécifier l’une des valeurs de taille prises en charge, supprimer des entités existantes ou augmenter la taille de votre quota. La raison de l’échec est définie sur QuotaExceeded 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.
S’applique à
Azure SDK for .NET