ServiceBusAdministrationClient.CreateRuleAsync Methode

Referenz

Definition

Namespace:: Azure.Messaging.ServiceBus.Administration

Assembly:: Azure.Messaging.ServiceBus.dll

Paket:: Azure.Messaging.ServiceBus v7.17.5

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

Quelle:: ServiceBusAdministrationClient.cs

Quelle:: ServiceBusAdministrationClient.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt dem Abonnement unter dem angegebenen Thema eine neue Regel hinzu.

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

Parameter

topicName: String

Der Themenname relativ zur Basisadresse des Dienstnamespaces.

subscriptionName: String

Der Name des Abonnements.

options: CreateRuleOptions

Ein CreateRuleOptions Objekt, das die Attribute beschreibt, mit denen die Nachrichten abgeglichen und verarbeitet werden.

cancellationToken: CancellationToken

Ein optionaler CancellationToken instance, um die Anforderung zum Abbrechen des Vorgangs zu signalisieren.

Gibt zurück

Task<Response<RuleProperties>>

RuleProperties der kürzlich erstellten Regel.

Ausnahmen

MessagingEntityAlreadyExists

Ein Abonnement mit demselben Namen ist unter demselben Dienstnamespace vorhanden.

ServiceTimeout

Für den Vorgang ist ein Zeitüberschreitungsvorgang aufgetreten. Der Timeoutzeitraum wird über die ServiceBusAdministrationClientOptions -Klasse initialisiert (siehe Retry-Eigenschaft). Möglicherweise müssen Sie den Wert des Timeouts erhöhen, um diese Ausnahme zu vermeiden, wenn der Timeoutwert relativ niedrig ist.

QuotaExceeded

Entweder wird die angegebene Größe in der Beschreibung nicht unterstützt, oder das maximal zulässige Kontingent wurde erreicht. Sie müssen einen der unterstützten Größenwerte angeben, vorhandene Entitäten löschen oder Ihre Kontingentgröße erhöhen.

ServiceBusy

Der Server ist ausgelastet. Sie sollten warten, bevor Sie den Vorgang wiederholen.

ArgumentNullException

Der Themenname, Abonnementname oder options instance ist NULL.

ArgumentOutOfRangeException

Der Name des Themas oder Abonnements überschreitet die maximal zulässige Länge.

ArgumentException

Andernfalls ist der Name des Themas oder Abonnements ungültig.

UnauthorizedAccessException

Unzureichende Berechtigung zum Ausführen dieses Vorgangs. Sie sollten überprüfen, ob Sie ServiceBusAdministrationClient über die erforderlichen Ansprüche zum Ausführen dieses Vorgangs verfügen. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations

ServiceBusException

Unter dem Abonnement ist eine Regel mit demselben Namen vorhanden. In Reason diesem Fall wird auf MessagingEntityAlreadyExists festgelegt.
Für den Vorgang wurde ein Timeout ausgeführt. In Reason diesem Fall wird auf ServiceTimeout festgelegt.
Entweder wird die angegebene Größe der Entität nicht unterstützt, oder das maximal zulässige Kontingent wurde erreicht. Sie müssen einen der unterstützten Größenwerte angeben, vorhandene Entitäten löschen oder Ihre Kontingentgröße erhöhen. Der Fehlergrund wird in diesem Fall auf QuotaExceeded festgelegt.
Der Server ist ausgelastet. Sie sollten warten, bevor Sie den Vorgang wiederholen. Der Fehlergrund wird in diesem Fall auf ServiceBusy festgelegt.
Es tritt ein interner Fehler oder eine unerwartete Ausnahme auf. Der Fehlergrund wird in diesem Fall auf GeneralError festgelegt.

Gilt für:

Freigeben über