ServiceBusAdministrationClient.CreateTopicAsync 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
| CreateTopicAsync(CreateTopicOptions, CancellationToken) |
Erstellt ein neues Thema im Dienstnamespace mit dem angegebenen Namen. |
| CreateTopicAsync(String, CancellationToken) |
Erstellt ein neues Thema im Dienstnamespace mit dem angegebenen Namen. |
CreateTopicAsync(CreateTopicOptions, CancellationToken)
Erstellt ein neues Thema im Dienstnamespace mit dem angegebenen Namen.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.TopicProperties>> CreateTopicAsync (Azure.Messaging.ServiceBus.Administration.CreateTopicOptions options, System.Threading.CancellationToken cancellationToken = default);abstract member CreateTopicAsync : Azure.Messaging.ServiceBus.Administration.CreateTopicOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.TopicProperties>>
override this.CreateTopicAsync : Azure.Messaging.ServiceBus.Administration.CreateTopicOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.TopicProperties>>Public Overridable Function CreateTopicAsync (options As CreateTopicOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of TopicProperties))Parameter
- options
- CreateTopicOptions
Ein TopicProperties Objekt, das die Attribute beschreibt, mit denen das neue Thema erstellt wird.
- cancellationToken
- CancellationToken
Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.
Gibt zurück
Die TopicProperties des neu erstellten Themas.
Ausnahmen
Ein Thema mit demselben Namen befindet sich unter demselben Dienstnamespace.
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 ihre 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 verfügt, um diesen Vorgang auszuführen. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- Ein Thema mit demselben Namen befindet sich unter demselben Dienstnamespace. 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 ihre 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 Thema vorhanden ist. TopicProperties für Standardwerte von Themeneigenschaften.
Gilt für:
CreateTopicAsync(String, CancellationToken)
Erstellt ein neues Thema im Dienstnamespace mit dem angegebenen Namen.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.TopicProperties>> CreateTopicAsync (string name, System.Threading.CancellationToken cancellationToken = default);abstract member CreateTopicAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.TopicProperties>>
override this.CreateTopicAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.TopicProperties>>Public Overridable Function CreateTopicAsync (name As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of TopicProperties))Parameter
- name
- String
Der Name des Themas relativ zur Basisadresse des Dienstnamespaces.
- cancellationToken
- CancellationToken
Ein optionaler CancellationToken instance, um der Anforderung zu signalisieren, den Vorgang abzubrechen.
Gibt zurück
Die TopicProperties des neu erstellten Themas.
Ausnahmen
Ein Thema mit demselben Namen befindet sich unter demselben Dienstnamespace.
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 ihre Kontingentgröße erhöhen.
Der Server ist ausgelastet. Sie sollten warten, bevor Sie den Vorgang wiederholen.
Der Themenname ist NULL oder leer.
Der Themenname überschreitet die maximal zulässige Länge.
Der Themenname 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
- Ein Thema mit demselben Namen befindet sich unter demselben Dienstnamespace. 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 ihre 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 Thema vorhanden ist. TopicProperties für Standardwerte von Themeneigenschaften.
Gilt für:
Azure SDK for .NET