ServiceBusAdministrationClient.CreateTopicAsync 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
| CreateTopicAsync(CreateTopicOptions, CancellationToken) |
Cria um novo tópico no namespace de serviço com o nome fornecido. |
| CreateTopicAsync(String, CancellationToken) |
Cria um novo tópico no namespace de serviço com o nome fornecido. |
CreateTopicAsync(CreateTopicOptions, CancellationToken)
Cria um novo tópico no namespace de serviço com o nome fornecido.
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))Parâmetros
- options
- CreateTopicOptions
Um TopicProperties objeto que descreve os atributos com os quais o novo tópico será criado.
- cancellationToken
- CancellationToken
Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.
Retornos
O TopicProperties do tópico recém-criado.
Exceções
Um tópico com o mesmo nome existe 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 Propriedade Retry). Talvez seja necessário aumentar o valor do tempo limite para evitar essa exceção se o valor do 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
- Um tópico com o mesmo nome existe no mesmo namespace de serviço. O Reason será definido como MessagingEntityAlreadyExists neste caso.
- A operação atingiu o tempo limite. O Reason será definido como ServiceTimeout neste 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 como QuotaExceeded neste caso.
- O servidor está ocupado. Você deve aguardar antes de repetir a operação. O motivo da falha será definido como ServiceBusy neste caso.
- Ocorre um erro interno ou uma exceção inesperada. O motivo da falha será definido como GeneralError neste caso.
Comentários
Gerará se já existir um tópico. TopicProperties para valores padrão de propriedades de tópico.
Aplica-se a
CreateTopicAsync(String, CancellationToken)
Cria um novo tópico no namespace de serviço com o nome fornecido.
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))Parâmetros
- name
- String
O nome do tópico relativo ao endereço base do namespace de serviço.
- cancellationToken
- CancellationToken
Uma instância opcional CancellationToken para sinalizar a solicitação para cancelar a operação.
Retornos
O TopicProperties do tópico recém-criado.
Exceções
Um tópico com o mesmo nome existe 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 Propriedade Retry). Talvez seja necessário aumentar o valor do tempo limite para evitar essa exceção se o valor do 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 é nulo ou vazio.
O nome do tópico excede o comprimento máximo permitido.
O nome do tópico é 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
- Um tópico com o mesmo nome existe no mesmo namespace de serviço. O Reason será definido como MessagingEntityAlreadyExists neste caso.
- A operação atingiu o tempo limite. O Reason será definido como ServiceTimeout neste 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 como QuotaExceeded neste caso.
- O servidor está ocupado. Você deve aguardar antes de repetir a operação. O motivo da falha será definido como ServiceBusy neste caso.
- Ocorre um erro interno ou uma exceção inesperada. O motivo da falha será definido como GeneralError neste caso.
Comentários
Gerará se já existir um tópico. TopicProperties para valores padrão de propriedades de tópico.
Aplica-se a
Azure SDK for .NET