Freigeben über


ServiceBusAdministrationClient.GetRuleAsync Methode

Definition

Ruft eine Regel aus dem Dienstnamespace ab.

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

Parameter

topicName
String

Der Name des Themas relativ zum Service Bus-Namespace.

subscriptionName
String

Der Abonnementname, zu dem die Regel gehört.

ruleName
String

Der Name der abzurufenden Regel.

cancellationToken
CancellationToken

Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.

Gibt zurück

RuleProperties enthält Informationen zur Regel.

Ausnahmen

Das Zeitüberschreitungsout des Vorgangs. 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.

Thema/Abonnement/Regel mit diesem Namen ist nicht vorhanden.

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

Der Name des Themas, des Abonnements oder der Regel ist NULL oder leer.

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

Der Name des Themas, des Abonnements oder der Regel ist andernfalls ungültig.

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

  • Die angegebene Entität konnte nicht gefunden werden. Wird Reason in diesem Fall auf MessagingEntityNotFound festgelegt.
  • Timeout des Vorgangs. Wird Reason in diesem Fall auf ServiceTimeout festgelegt.
  • Der Server ist ausgelastet. Sie sollten warten, bevor Sie den Vorgang wiederholen. Die Fehlerursache wird in diesem Fall auf ServiceBusy festgelegt.
  • Ein interner Fehler oder eine unerwartete Ausnahme tritt auf. Die Fehlerursache wird in diesem Fall auf GeneralError festgelegt.

Hinweise

Hinweis: Nur die folgenden Datentypen werden in den Parametern Filter und Action deserialisiert: string,int,long,bool,double,DateTime. Andere Datentypen geben den Zeichenfolgenwert zurück.

Gilt für: