Compartilhar via


ServiceBusAdministrationClient.CreateSubscriptionAsync Método

Definição

Sobrecargas

CreateSubscriptionAsync(CreateSubscriptionOptions, CancellationToken)

Cria uma nova assinatura dentro de um tópico no namespace de serviço com o nome fornecido.

CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken)

Cria uma nova assinatura dentro de um tópico com a regra padrão fornecida.

CreateSubscriptionAsync(String, String, CancellationToken)

Cria uma nova assinatura dentro de um tópico no namespace de serviço com o nome fornecido.

CreateSubscriptionAsync(CreateSubscriptionOptions, CancellationToken)

Origem:
ServiceBusAdministrationClient.cs
Origem:
ServiceBusAdministrationClient.cs

Cria uma nova assinatura dentro de um tópico no namespace de serviço com o nome fornecido.

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))

Parâmetros

options
CreateSubscriptionOptions

Um SubscriptionProperties objeto que descreve os atributos com os quais a nova assinatura será criada.

cancellationToken
CancellationToken

Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.

Retornos

O SubscriptionProperties da assinatura recém-criada.

Exceções

Existe uma assinatura com o mesmo nome no mesmo namespace de serviço.

A operação atinge o tempo limite. O período de tempo limite é inicializado por meio da ServiceBusAdministrationClientOptions classe (consulte a propriedade Retry). Talvez seja necessário aumentar o valor do tempo limite para evitar essa exceção se o valor de tempo limite for relativamente baixo.

Não há suporte para o tamanho especificado na descrição ou a cota máxima permitida foi atingida. Você deve especificar um dos valores de tamanho com suporte, excluir entidades existentes ou aumentar o tamanho da cota.

O servidor está ocupado. Você deve aguardar antes de repetir a operação.

A options instância é nula.

Permissão insuficiente para executar essa operação. Você deve marcar para garantir que você ServiceBusAdministrationClient tenha as declarações necessárias para executar essa operação. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations

  • Existe uma assinatura com o mesmo nome no mesmo namespace de serviço. O Reason será definido MessagingEntityAlreadyExists como nesse caso.
  • A operação atingiu o tempo limite. O Reason será definido ServiceTimeout como nesse caso.
  • Não há suporte para o tamanho especificado da entidade ou a cota máxima permitida foi atingida. Você deve especificar um dos valores de tamanho com suporte, excluir entidades existentes ou aumentar o tamanho da cota. O motivo da falha será definido QuotaExceeded como nesse caso.
  • O servidor está ocupado. Você deve aguardar antes de repetir a operação. O motivo da falha será definido ServiceBusy como nesse caso.
  • Ocorre um erro interno ou uma exceção inesperada. O motivo da falha será definido GeneralError como nesse caso.

Comentários

Gerará se uma assinatura já existir. Por padrão, um filtro de "passagem" é criado para essa assinatura, o que significa que ele permitirá que todas as mensagens acessem essa assinatura. O nome do filtro é representado por DefaultRuleName. CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) para criar uma assinatura com um filtro diferente.

Aplica-se a

CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken)

Origem:
ServiceBusAdministrationClient.cs
Origem:
ServiceBusAdministrationClient.cs

Cria uma nova assinatura dentro de um tópico com a regra padrão fornecida.

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))

Parâmetros

options
CreateSubscriptionOptions

Um SubscriptionProperties objeto que descreve os atributos com os quais a nova assinatura será criada.

rule
CreateRuleOptions

Um RuleProperties objeto que descreve a regra padrão. Se for nulo, o filtro de passagem com nome DefaultRuleName será criado.

cancellationToken
CancellationToken

Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.

Retornos

O SubscriptionProperties da assinatura recém-criada.

Exceções

Existe uma assinatura com o mesmo nome no mesmo namespace de serviço.

A operação atinge o tempo limite. O período de tempo limite é inicializado por meio da ServiceBusAdministrationClientOptions classe (consulte a propriedade Retry). Talvez seja necessário aumentar o valor do tempo limite para evitar essa exceção se o valor de tempo limite for relativamente baixo.

Não há suporte para o tamanho especificado na descrição ou a cota máxima permitida foi atingida. Você deve especificar um dos valores de tamanho com suporte, excluir entidades existentes ou aumentar o tamanho da cota.

O servidor está ocupado. Você deve aguardar antes de repetir a operação.

A options instância é nula.

Permissão insuficiente para executar essa operação. Você deve marcar para garantir que você ServiceBusAdministrationClient tenha as declarações necessárias para executar essa operação. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations

  • Existe uma assinatura com o mesmo nome no mesmo namespace de serviço. O Reason será definido MessagingEntityAlreadyExists como nesse caso.
  • A operação atingiu o tempo limite. O Reason será definido ServiceTimeout como nesse caso.
  • Não há suporte para o tamanho especificado da entidade ou a cota máxima permitida foi atingida. Você deve especificar um dos valores de tamanho com suporte, excluir entidades existentes ou aumentar o tamanho da cota. O motivo da falha será definido QuotaExceeded como nesse caso.
  • O servidor está ocupado. Você deve aguardar antes de repetir a operação. O motivo da falha será definido ServiceBusy como nesse caso.
  • Ocorre um erro interno ou uma exceção inesperada. O motivo da falha será definido GeneralError como nesse caso.

Comentários

Gerará se uma assinatura já existir.

Aplica-se a

CreateSubscriptionAsync(String, String, CancellationToken)

Origem:
ServiceBusAdministrationClient.cs
Origem:
ServiceBusAdministrationClient.cs

Cria uma nova assinatura dentro de um tópico no namespace de serviço com o nome fornecido.

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))

Parâmetros

topicName
String

O nome do tópico relativo ao endereço base do namespace de serviço.

subscriptionName
String

O nome da assinatura.

cancellationToken
CancellationToken

Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.

Retornos

O SubscriptionProperties da assinatura recém-criada.

Exceções

Existe uma assinatura com o mesmo nome no mesmo namespace de serviço.

A operação atinge o tempo limite. O período de tempo limite é inicializado por meio da ServiceBusAdministrationClientOptions classe (consulte a propriedade Retry). Talvez seja necessário aumentar o valor do tempo limite para evitar essa exceção se o valor de tempo limite for relativamente baixo.

Não há suporte para o tamanho especificado na descrição ou a cota máxima permitida foi atingida. Você deve especificar um dos valores de tamanho com suporte, excluir entidades existentes ou aumentar o tamanho da cota.

O servidor está ocupado. Você deve aguardar antes de repetir a operação.

O nome do tópico ou da assinatura é nulo ou vazio.

O nome do tópico ou da assinatura excede o comprimento máximo permitido.

O nome do tópico ou da assinatura é inválido.

Permissão insuficiente para executar essa operação. Você deve marcar para garantir que você ServiceBusAdministrationClient tenha as declarações necessárias para executar essa operação. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations

  • Existe uma assinatura com o mesmo nome no mesmo namespace de serviço. O Reason será definido MessagingEntityAlreadyExists como nesse caso.
  • A operação atingiu o tempo limite. O Reason será definido ServiceTimeout como nesse caso.
  • Não há suporte para o tamanho especificado da entidade ou a cota máxima permitida foi atingida. Você deve especificar um dos valores de tamanho com suporte, excluir entidades existentes ou aumentar o tamanho da cota. O motivo da falha será definido QuotaExceeded como nesse caso.
  • O servidor está ocupado. Você deve aguardar antes de repetir a operação. O motivo da falha será definido ServiceBusy como nesse caso.
  • Ocorre um erro interno ou uma exceção inesperada. O motivo da falha será definido GeneralError como nesse caso.

Comentários

Gerará se uma assinatura já existir. SubscriptionProperties para valores padrão da descrição da assinatura. Por padrão, um filtro de "passagem" é criado para essa assinatura, o que significa que ele permitirá que todas as mensagens acessem essa assinatura. O nome do filtro é representado por DefaultRuleName. CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) para criar uma assinatura com um filtro diferente.

Aplica-se a