Freigeben über


ServiceBusAdministrationClient.GetQueueAsync Methode

Definition

Ruft eine Warteschlange aus dem Dienstnamespace ab.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>> GetQueueAsync (string name, System.Threading.CancellationToken cancellationToken = default);
abstract member GetQueueAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>
override this.GetQueueAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>
Public Overridable Function GetQueueAsync (name As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of QueueProperties))

Parameter

name
String

Der Name der Warteschlange relativ zum Service Bus-Namespace.

cancellationToken
CancellationToken

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

Gibt zurück

QueueProperties enthält Informationen zur Warteschlange.

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.

Die Warteschlange mit diesem Namen ist nicht vorhanden.

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

Der Warteschlangenname ist NULL oder leer.

Der Warteschlangenname überschreitet die maximal zulässige Länge.

Der Warteschlangenname 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.

Gilt für: