ServiceBusAdministrationClient.CreateSubscriptionAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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)
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)
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)
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
Azure SDK for .NET