ServiceBusAdministrationClient.CreateSubscriptionAsync Methode
Definition
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.
Überlädt
| CreateSubscriptionAsync(CreateSubscriptionOptions, CancellationToken) |
Erstellt ein neues Abonnement innerhalb eines Themas im Dienstnamespace mit dem angegebenen Namen. |
| CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) |
Erstellt ein neues Abonnement innerhalb eines Themas mit der bereitgestellten Standardregel. |
| CreateSubscriptionAsync(String, String, CancellationToken) |
Erstellt ein neues Abonnement innerhalb eines Themas im Dienstnamespace mit dem angegebenen Namen. |
CreateSubscriptionAsync(CreateSubscriptionOptions, CancellationToken)
Erstellt ein neues Abonnement innerhalb eines Themas im Dienstnamespace mit dem angegebenen Namen.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>> CreateSubscriptionAsync (Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions options, System.Threading.CancellationToken cancellationToken = default);abstract member CreateSubscriptionAsync : Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>
override this.CreateSubscriptionAsync : Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>Public Overridable Function CreateSubscriptionAsync (options As CreateSubscriptionOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SubscriptionProperties))Parameter
- options
- CreateSubscriptionOptions
Ein SubscriptionProperties -Objekt, das die Attribute beschreibt, mit denen das neue Abonnement erstellt wird.
- cancellationToken
- CancellationToken
Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.
Gibt zurück
Die SubscriptionProperties des neu erstellten Abonnements.
Ausnahmen
Ein Abonnement mit demselben Namen ist unter demselben Dienstnamespace vorhanden.
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.
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.
Die options instance ist NULL.
Unzureichende Berechtigung zum Ausführen dieses Vorgangs. Sie sollten überprüfen, ob Ihre ServiceBusAdministrationClient über die erforderlichen Ansprüche zum Ausführen dieses Vorgangs verfügt. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- Ein Abonnement mit demselben Namen ist unter demselben Dienstnamespace vorhanden. Wird Reason in diesem Fall auf MessagingEntityAlreadyExists festgelegt.
- Timeout des Vorgangs. Wird Reason in diesem Fall 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 die Kontingentgröße erhöhen. Die Fehlerursache wird in diesem Fall auf QuotaExceeded 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
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 gesendet werden können. Der Name des Filters wird durch DefaultRuleNamedargestellt. CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) zum Erstellen eines Abonnements mit einem anderen Filter.
Gilt für:
CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken)
Erstellt ein neues Abonnement innerhalb eines Themas mit der bereitgestellten Standardregel.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>> CreateSubscriptionAsync (Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions options, Azure.Messaging.ServiceBus.Administration.CreateRuleOptions rule, System.Threading.CancellationToken cancellationToken = default);abstract member CreateSubscriptionAsync : Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions * Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>
override this.CreateSubscriptionAsync : Azure.Messaging.ServiceBus.Administration.CreateSubscriptionOptions * Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>Public Overridable Function CreateSubscriptionAsync (options As CreateSubscriptionOptions, rule As CreateRuleOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SubscriptionProperties))Parameter
- options
- CreateSubscriptionOptions
Ein SubscriptionProperties -Objekt, das die Attribute beschreibt, mit denen das neue Abonnement erstellt wird.
- rule
- CreateRuleOptions
Ein RuleProperties Objekt, das die Standardregel beschreibt. Wenn NULL, wird ein Passthroughfilter mit dem Namen DefaultRuleName erstellt.
- cancellationToken
- CancellationToken
Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.
Gibt zurück
Die SubscriptionProperties des neu erstellten Abonnements.
Ausnahmen
Ein Abonnement mit demselben Namen ist unter demselben Dienstnamespace vorhanden.
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.
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.
Die options instance ist NULL.
Unzureichende Berechtigung zum Ausführen dieses Vorgangs. Sie sollten überprüfen, ob Ihre ServiceBusAdministrationClient über die erforderlichen Ansprüche zum Ausführen dieses Vorgangs verfügt. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- Ein Abonnement mit demselben Namen ist unter demselben Dienstnamespace vorhanden. Wird Reason in diesem Fall auf MessagingEntityAlreadyExists festgelegt.
- Timeout des Vorgangs. Wird Reason in diesem Fall 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 die Kontingentgröße erhöhen. Die Fehlerursache wird in diesem Fall auf QuotaExceeded 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
Löst aus, wenn bereits ein Abonnement vorhanden ist.
Gilt für:
CreateSubscriptionAsync(String, String, CancellationToken)
Erstellt ein neues Abonnement innerhalb eines Themas im Dienstnamespace mit dem angegebenen Namen.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>> CreateSubscriptionAsync (string topicName, string subscriptionName, System.Threading.CancellationToken cancellationToken = default);abstract member CreateSubscriptionAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>
override this.CreateSubscriptionAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.SubscriptionProperties>>Public Overridable Function CreateSubscriptionAsync (topicName As String, subscriptionName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SubscriptionProperties))Parameter
- topicName
- String
Der Name des Themas relativ zur Basisadresse des Dienstnamespaces.
- subscriptionName
- String
Der Name des Abonnements.
- cancellationToken
- CancellationToken
Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.
Gibt zurück
Die SubscriptionProperties des neu erstellten Abonnements.
Ausnahmen
Ein Abonnement mit demselben Namen ist unter demselben Dienstnamespace vorhanden.
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.
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.
Der Name des Themas oder Abonnements ist NULL oder leer.
Der Name des Themas oder Abonnements überschreitet die maximal zulässige Länge.
Der Name des Themas oder Abonnements ist andernfalls ungültig.
Unzureichende Berechtigung zum Ausführen dieses Vorgangs. Sie sollten überprüfen, ob Ihre ServiceBusAdministrationClient über die erforderlichen Ansprüche zum Ausführen dieses Vorgangs verfügt. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- Ein Abonnement mit demselben Namen ist unter demselben Dienstnamespace vorhanden. Wird Reason in diesem Fall auf MessagingEntityAlreadyExists festgelegt.
- Timeout des Vorgangs. Wird Reason in diesem Fall 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 die Kontingentgröße erhöhen. Die Fehlerursache wird in diesem Fall auf QuotaExceeded 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
Löst aus, wenn bereits ein Abonnement vorhanden ist. SubscriptionProperties für Standardwerte der Abonnementbeschreibung. Standardmäßig wird ein "Pass-Through"-Filter für dieses Abonnement erstellt, d. h., dass alle Nachrichten an dieses Abonnement gesendet werden können. Der Name des Filters wird durch DefaultRuleNamedargestellt. CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) zum Erstellen eines Abonnements mit einem anderen Filter.
Gilt für:
Azure SDK for .NET