Freigeben über


ManagementClient.CreateSubscriptionAsync Methode

Definition

Überlädt

CreateSubscriptionAsync(String, String, CancellationToken)

Erstellt ein neues Abonnement innerhalb eines Themas im Dienstnamespace mit dem angegebenen Namen.

CreateSubscriptionAsync(SubscriptionDescription, RuleDescription, CancellationToken)

Erstellt ein neues Abonnement innerhalb eines Themas mit der bereitgestellten Standardregel.

CreateSubscriptionAsync(SubscriptionDescription, CancellationToken)

Erstellt ein neues Abonnement innerhalb eines Themas im Dienstnamespace mit dem angegebenen Namen.

CreateSubscriptionAsync(String, String, CancellationToken)

Quelle:
ManagementClient.cs

Erstellt ein neues Abonnement innerhalb eines Themas im Dienstnamespace mit dem angegebenen Namen.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription> CreateSubscriptionAsync (string topicPath, string subscriptionName, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateSubscriptionAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>
override this.CreateSubscriptionAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>
Public Overridable Function CreateSubscriptionAsync (topicPath As String, subscriptionName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of SubscriptionDescription)

Parameter

topicPath
String

Der Pfad des Themas relativ zur Basisadresse des Dienstnamespaces.

subscriptionName
String

Der Name des Abonnements.

cancellationToken
CancellationToken

Gibt zurück

Die SubscriptionDescription des neu erstellten Abonnements.

Ausnahmen

Der Themenpfad oder Abonnementname ist NULL oder leer.

Die Länge von topicPath ist größer als 260 Zeichen oder subscriptionName ist größer als 50 Zeichen.

Ein Abonnement mit demselben Namen ist unter demselben Dienstnamespace vorhanden.

Das Zeitüberschreitungsout des Vorgangs. Der Timeoutzeitraum wird über die ServiceBusConnection -Klasse initialisiert. Möglicherweise müssen Sie den Wert des Timeouts erhöhen, um diese Ausnahme zu vermeiden, wenn der Timeoutwert relativ niedrig ist.

Keine ausreichende Berechtigung zum Ausführen dieses Vorgangs. Sie sollten überprüfen, ob Sie ManagementClient über die richtigen TokenProvider Anmeldeinformationen verfügen, um diesen Vorgang auszuführen.

Entweder wird die in der Beschreibung angegebene Größe 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 die Kontingentgröße erhöhen.

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

Ein interner Fehler oder eine unerwartete Ausnahme tritt auf.

Hinweise

Löst aus, wenn bereits ein Abonnement vorhanden ist. SubscriptionDescription für Standardwerte von Abonnementeigenschaften. Standardmäßig wird ein "Pass-Through"-Filter für dieses Abonnement erstellt, d. h., dass alle Nachrichten an dieses Abonnement weitergeleitet werden können. Der Name des Filters wird durch DefaultRuleNamedargestellt. CreateSubscriptionAsync(SubscriptionDescription, RuleDescription, CancellationToken) zum Erstellen eines Abonnements mit einem anderen Filter.

Gilt für:

CreateSubscriptionAsync(SubscriptionDescription, RuleDescription, CancellationToken)

Quelle:
ManagementClient.cs

Erstellt ein neues Abonnement innerhalb eines Themas mit der bereitgestellten Standardregel.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription> CreateSubscriptionAsync (Microsoft.Azure.ServiceBus.Management.SubscriptionDescription subscriptionDescription, Microsoft.Azure.ServiceBus.RuleDescription defaultRule, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateSubscriptionAsync : Microsoft.Azure.ServiceBus.Management.SubscriptionDescription * Microsoft.Azure.ServiceBus.RuleDescription * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>
override this.CreateSubscriptionAsync : Microsoft.Azure.ServiceBus.Management.SubscriptionDescription * Microsoft.Azure.ServiceBus.RuleDescription * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>
Public Overridable Function CreateSubscriptionAsync (subscriptionDescription As SubscriptionDescription, defaultRule As RuleDescription, Optional cancellationToken As CancellationToken = Nothing) As Task(Of SubscriptionDescription)

Parameter

subscriptionDescription
SubscriptionDescription

Ein SubscriptionDescription -Objekt, das die Attribute beschreibt, mit denen das neue Abonnement erstellt wird.

defaultRule
RuleDescription

Ein RuleDescription Objekt, das die Standardregel beschreibt. Wenn NULL, wird ein Passthroughfilter mit dem Namen DefaultRuleName erstellt.

cancellationToken
CancellationToken

Gibt zurück

Die SubscriptionDescription des neu erstellten Abonnements.

Ausnahmen

Die Abonnementbeschreibung ist NULL.

Ein Abonnement mit demselben Namen ist unter demselben Dienstnamespace vorhanden.

Das Zeitüberschreitungsout des Vorgangs. Der Timeoutzeitraum wird über die ServiceBusConnection -Klasse initialisiert. Möglicherweise müssen Sie den Wert des Timeouts erhöhen, um diese Ausnahme zu vermeiden, wenn der Timeoutwert relativ niedrig ist.

Keine ausreichende Berechtigung zum Ausführen dieses Vorgangs. Sie sollten überprüfen, ob Sie ManagementClient über die richtigen TokenProvider Anmeldeinformationen verfügen, um diesen Vorgang auszuführen.

Entweder wird die in der Beschreibung angegebene Größe 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 die Kontingentgröße erhöhen.

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

Ein interner Fehler oder eine unerwartete Ausnahme tritt auf.

Hinweise

Löst aus, wenn bereits ein Abonnement vorhanden ist.

Gilt für:

CreateSubscriptionAsync(SubscriptionDescription, CancellationToken)

Quelle:
ManagementClient.cs

Erstellt ein neues Abonnement innerhalb eines Themas im Dienstnamespace mit dem angegebenen Namen.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription> CreateSubscriptionAsync (Microsoft.Azure.ServiceBus.Management.SubscriptionDescription subscriptionDescription, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateSubscriptionAsync : Microsoft.Azure.ServiceBus.Management.SubscriptionDescription * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>
override this.CreateSubscriptionAsync : Microsoft.Azure.ServiceBus.Management.SubscriptionDescription * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>
Public Overridable Function CreateSubscriptionAsync (subscriptionDescription As SubscriptionDescription, Optional cancellationToken As CancellationToken = Nothing) As Task(Of SubscriptionDescription)

Parameter

subscriptionDescription
SubscriptionDescription

Ein SubscriptionDescription -Objekt, das die Attribute beschreibt, mit denen das neue Abonnement erstellt wird.

cancellationToken
CancellationToken

Gibt zurück

Die SubscriptionDescription des neu erstellten Abonnements.

Ausnahmen

Die Abonnementbeschreibung ist NULL.

Ein Abonnement mit demselben Namen ist unter demselben Dienstnamespace vorhanden.

Das Zeitüberschreitungsout des Vorgangs. Der Timeoutzeitraum wird über die ServiceBusConnection -Klasse initialisiert. Möglicherweise müssen Sie den Wert des Timeouts erhöhen, um diese Ausnahme zu vermeiden, wenn der Timeoutwert relativ niedrig ist.

Keine ausreichende Berechtigung zum Ausführen dieses Vorgangs. Sie sollten überprüfen, ob Sie ManagementClient über die richtigen TokenProvider Anmeldeinformationen verfügen, um diesen Vorgang auszuführen.

Entweder wird die in der Beschreibung angegebene Größe 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 die Kontingentgröße erhöhen.

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

Ein interner Fehler oder eine unerwartete Ausnahme tritt auf.

Hinweise

Löst aus, wenn bereits ein Abonnement vorhanden ist. Standardmäßig wird ein "Pass-Through"-Filter für dieses Abonnement erstellt, d. h., dass alle Nachrichten an dieses Abonnement weitergeleitet werden können. Der Name des Filters wird durch DefaultRuleNamedargestellt. CreateSubscriptionAsync(SubscriptionDescription, RuleDescription, CancellationToken) zum Erstellen eines Abonnements mit einem anderen Filter.

Gilt für: