ServiceBusAdministrationClient.CreateTopicAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
CreateTopicAsync(CreateTopicOptions, CancellationToken) |
Crée une rubrique dans l’espace de noms de service avec le nom donné. |
CreateTopicAsync(String, CancellationToken) |
Crée une rubrique dans l’espace de noms de service avec le nom donné. |
CreateTopicAsync(CreateTopicOptions, CancellationToken)
Crée une rubrique dans l’espace de noms de service avec le nom donné.
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))
Paramètres
- options
- CreateTopicOptions
Objet TopicProperties décrivant les attributs avec lesquels la nouvelle rubrique sera créée.
- cancellationToken
- CancellationToken
Une instance facultative CancellationToken pour signaler la demande d’annulation de l’opération.
Retours
de TopicProperties la rubrique nouvellement créée.
Exceptions
Une rubrique portant le même nom existe sous le même espace de noms de service.
L’opération expire. Le délai d’attente est initialisé par le biais de la ServiceBusAdministrationClientOptions classe (voir Propriété Réessayer). Vous devrez peut-être augmenter la valeur du délai d’expiration pour éviter cette exception si la valeur du délai d’expiration est relativement faible.
La taille spécifiée dans la description n’est pas prise en charge ou le quota maximal autorisé a été atteint. Vous devez spécifier l’une des valeurs de taille prises en charge, supprimer des entités existantes ou augmenter la taille de votre quota.
Le serveur est occupé. Vous devez attendre avant de réessayer l’opération.
Le options
instance a la valeur Null.
Autorisation insuffisante pour effectuer cette opération. Vous devez case activée pour vous assurer que votre ServiceBusAdministrationClient dispose des revendications nécessaires pour effectuer cette opération. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- Une rubrique portant le même nom existe sous le même espace de noms de service. Reason le sera défini sur MessagingEntityAlreadyExists dans ce cas.
- L’opération a expiré. Reason le sera défini sur ServiceTimeout dans ce cas.
- La taille spécifiée de l’entité n’est pas prise en charge ou le quota maximal autorisé a été atteint. Vous devez spécifier l’une des valeurs de taille prises en charge, supprimer des entités existantes ou augmenter la taille de votre quota. La raison de l’échec est définie sur QuotaExceeded dans ce cas.
- Le serveur est occupé. Vous devez attendre avant de réessayer l’opération. La raison de l’échec est définie sur ServiceBusy dans ce cas.
- Une erreur interne ou une exception inattendue se produit. La raison de l’échec est définie sur GeneralError dans ce cas.
Remarques
Lève si une rubrique existe déjà. TopicProperties pour les valeurs par défaut des propriétés de rubrique.
S’applique à
CreateTopicAsync(String, CancellationToken)
Crée une rubrique dans l’espace de noms de service avec le nom donné.
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))
Paramètres
- name
- String
Nom de la rubrique relative à l’adresse de base de l’espace de noms de service.
- cancellationToken
- CancellationToken
Une instance facultative CancellationToken pour signaler la demande d’annulation de l’opération.
Retours
de TopicProperties la rubrique nouvellement créée.
Exceptions
Une rubrique portant le même nom existe sous le même espace de noms de service.
L’opération expire. Le délai d’attente est initialisé par le biais de la ServiceBusAdministrationClientOptions classe (voir Propriété Réessayer). Vous devrez peut-être augmenter la valeur du délai d’expiration pour éviter cette exception si la valeur du délai d’expiration est relativement faible.
La taille spécifiée dans la description n’est pas prise en charge ou le quota maximal autorisé a été atteint. Vous devez spécifier l’une des valeurs de taille prises en charge, supprimer des entités existantes ou augmenter la taille de votre quota.
Le serveur est occupé. Vous devez attendre avant de réessayer l’opération.
Le nom de la rubrique est null ou vide.
Le nom de la rubrique dépasse la longueur maximale autorisée.
Le nom de la rubrique n’est pas valide.
Autorisation insuffisante pour effectuer cette opération. Vous devez case activée pour vous assurer que votre ServiceBusAdministrationClient dispose des revendications nécessaires pour effectuer cette opération. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- Une rubrique portant le même nom existe sous le même espace de noms de service. Reason le sera défini sur MessagingEntityAlreadyExists dans ce cas.
- L’opération a expiré. Reason le sera défini sur ServiceTimeout dans ce cas.
- La taille spécifiée de l’entité n’est pas prise en charge ou le quota maximal autorisé a été atteint. Vous devez spécifier l’une des valeurs de taille prises en charge, supprimer des entités existantes ou augmenter la taille de votre quota. La raison de l’échec est définie sur QuotaExceeded dans ce cas.
- Le serveur est occupé. Vous devez attendre avant de réessayer l’opération. La raison de l’échec est définie sur ServiceBusy dans ce cas.
- Une erreur interne ou une exception inattendue se produit. La raison de l’échec est définie sur GeneralError dans ce cas.
Remarques
Lève si une rubrique existe déjà. TopicProperties pour les valeurs par défaut des propriétés de rubrique.
S’applique à
Azure SDK for .NET