ServiceBusAdministrationClient.CreateSubscriptionAsync 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
| CreateSubscriptionAsync(CreateSubscriptionOptions, CancellationToken) |
Crée un abonnement dans une rubrique de l’espace de noms de service avec le nom donné. |
| CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) |
Crée un abonnement dans une rubrique avec la règle par défaut fournie. |
| CreateSubscriptionAsync(String, String, CancellationToken) |
Crée un abonnement dans une rubrique de l’espace de noms de service avec le nom donné. |
CreateSubscriptionAsync(CreateSubscriptionOptions, CancellationToken)
Crée un abonnement dans une rubrique de l’espace de noms de service avec le nom donné.
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))Paramètres
- options
- CreateSubscriptionOptions
Objet SubscriptionProperties décrivant les attributs avec lesquels le nouvel abonnement sera créé.
- cancellationToken
- CancellationToken
Une instance facultative CancellationToken pour signaler la demande d’annulation de l’opération.
Retours
de SubscriptionProperties l’abonnement nouvellement créé.
Exceptions
Un abonnement 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é Retry). 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 est 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
- Un abonnement portant le même nom existe sous le même espace de noms de service. Dans Reason ce cas, la valeur est définie MessagingEntityAlreadyExists sur .
- L’opération a expiré. Dans Reason ce cas, la valeur est définie ServiceTimeout sur .
- 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 QuotaExceeded sur 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 ServiceBusy sur dans ce cas.
- Une erreur interne ou une exception inattendue se produit. La raison de l’échec est définie GeneralError sur dans ce cas.
Remarques
Lève si un abonnement existe déjà. Par défaut, un filtre « pass-through » est créé pour cet abonnement, ce qui signifie qu’il autorise tous les messages à accéder à cet abonnement. Le nom du filtre est représenté par DefaultRuleName. CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) pour créer un abonnement avec un filtre différent.
S’applique à
CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken)
Crée un abonnement dans une rubrique avec la règle par défaut fournie.
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))Paramètres
- options
- CreateSubscriptionOptions
Objet SubscriptionProperties décrivant les attributs avec lesquels le nouvel abonnement sera créé.
- rule
- CreateRuleOptions
Objet RuleProperties décrivant la règle par défaut. Si la valeur est null, le filtre direct avec le nom DefaultRuleName est créé.
- cancellationToken
- CancellationToken
Une instance facultative CancellationToken pour signaler la demande d’annulation de l’opération.
Retours
de SubscriptionProperties l’abonnement nouvellement créé.
Exceptions
Un abonnement 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é Retry). 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 est 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
- Un abonnement portant le même nom existe sous le même espace de noms de service. Dans Reason ce cas, la valeur est définie MessagingEntityAlreadyExists sur .
- L’opération a expiré. Dans Reason ce cas, la valeur est définie ServiceTimeout sur .
- 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 QuotaExceeded sur 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 ServiceBusy sur dans ce cas.
- Une erreur interne ou une exception inattendue se produit. La raison de l’échec est définie GeneralError sur dans ce cas.
Remarques
Lève si un abonnement existe déjà.
S’applique à
CreateSubscriptionAsync(String, String, CancellationToken)
Crée un abonnement dans une rubrique de l’espace de noms de service avec le nom donné.
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))Paramètres
- topicName
- String
Nom de la rubrique relative à l’adresse de base de l’espace de noms de service.
- subscriptionName
- String
Nom de l'abonnement.
- cancellationToken
- CancellationToken
Une instance facultative CancellationToken pour signaler la demande d’annulation de l’opération.
Retours
de SubscriptionProperties l’abonnement nouvellement créé.
Exceptions
Un abonnement 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é Retry). 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 ou de l’abonnement est null ou vide.
Le nom de la rubrique ou de l’abonnement dépasse la longueur maximale autorisée.
Le nom de la rubrique ou de l’abonnement 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
- Un abonnement portant le même nom existe sous le même espace de noms de service. Dans Reason ce cas, la valeur est définie MessagingEntityAlreadyExists sur .
- L’opération a expiré. Dans Reason ce cas, la valeur est définie ServiceTimeout sur .
- 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 QuotaExceeded sur 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 ServiceBusy sur dans ce cas.
- Une erreur interne ou une exception inattendue se produit. La raison de l’échec est définie GeneralError sur dans ce cas.
Remarques
Lève si un abonnement existe déjà. SubscriptionProperties pour les valeurs par défaut de la description de l’abonnement. Par défaut, un filtre « pass-through » est créé pour cet abonnement, ce qui signifie qu’il autorise tous les messages à accéder à cet abonnement. Le nom du filtre est représenté par DefaultRuleName. CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) pour créer un abonnement avec un filtre différent.
S’applique à
Azure SDK for .NET