Freigeben über


ServiceBusAdministrationClient.CreateQueueAsync Methode

Definition

Überlädt

CreateQueueAsync(CreateQueueOptions, CancellationToken)

Erstellt eine neue Warteschlange im Dienstnamespace mit dem angegebenen Namen.

CreateQueueAsync(String, CancellationToken)

Erstellt eine neue Warteschlange im Dienstnamespace mit dem angegebenen Namen.

CreateQueueAsync(CreateQueueOptions, CancellationToken)

Quelle:
ServiceBusAdministrationClient.cs
Quelle:
ServiceBusAdministrationClient.cs

Erstellt eine neue Warteschlange im Dienstnamespace mit dem angegebenen Namen.

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

Parameter

options
CreateQueueOptions

Ein CreateQueueOptions Objekt, das die Attribute beschreibt, mit denen die neue Warteschlange erstellt wird.

cancellationToken
CancellationToken

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

Gibt zurück

Die QueueProperties der neu erstellten Warteschlange.

Ausnahmen

Eine Entität mit demselben Namen befindet sich unter demselben Dienstnamespace.

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.

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.

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

Der options instance ist NULL.

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

  • Eine Warteschlange mit demselben Namen befindet sich unter demselben Dienstnamespace. 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.

Hinweise

Löst aus, wenn bereits eine Warteschlange vorhanden ist.

Gilt für:

CreateQueueAsync(String, CancellationToken)

Quelle:
ServiceBusAdministrationClient.cs
Quelle:
ServiceBusAdministrationClient.cs

Erstellt eine neue Warteschlange im Dienstnamespace mit dem angegebenen Namen.

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

Parameter

name
String

Der Name der Warteschlange relativ zur Basisadresse des Dienstnamespaces.

cancellationToken
CancellationToken

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

Gibt zurück

Die QueueProperties der neu erstellten Warteschlange.

Ausnahmen

Eine Entität mit demselben Namen befindet sich unter demselben Dienstnamespace.

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.

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.

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.

Andernfalls ist der Warteschlangenname ungültig.

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

  • Eine Warteschlange mit demselben Namen befindet sich unter demselben Dienstnamespace. 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.

Hinweise

Löst aus, wenn bereits eine Warteschlange vorhanden ist. QueueProperties für Standardwerte von Warteschlangeneigenschaften.

Gilt für: