ServiceBusAdministrationClient.CreateTopicAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
CreateTopicAsync(CreateTopicOptions, CancellationToken) |
Crea un nuevo tema en el espacio de nombres del servicio con el nombre especificado. |
CreateTopicAsync(String, CancellationToken) |
Crea un nuevo tema en el espacio de nombres del servicio con el nombre especificado. |
CreateTopicAsync(CreateTopicOptions, CancellationToken)
Crea un nuevo tema en el espacio de nombres del servicio con el nombre especificado.
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
Objeto TopicProperties que describe los atributos con los que se creará el nuevo tema.
- cancellationToken
- CancellationToken
Una instancia opcional CancellationToken para indicar la solicitud para cancelar la operación.
Devoluciones
del TopicProperties tema recién creado.
Excepciones
Existe un tema con el mismo nombre en el mismo espacio de nombres de servicio.
La operación agota el tiempo de espera. El período de tiempo de espera se inicializa a través de la ServiceBusAdministrationClientOptions clase (consulte la propiedad Retry). Es posible que tenga que aumentar el valor de tiempo de espera para evitar esta excepción si el valor de tiempo de espera es relativamente bajo.
No se admite el tamaño especificado en la descripción o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota.
El servidor está ocupado. Debe esperar antes de volver a intentar la operación.
La options
instancia es null.
Permiso insuficiente para realizar esta operación. Debe comprobar para asegurarse de que ServiceBusAdministrationClient tiene las notificaciones necesarias para realizar esta operación. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- Existe un tema con el mismo nombre en el mismo espacio de nombres de servicio. Reason Se establecerá MessagingEntityAlreadyExists en en este caso.
- Se agota el tiempo de espera de la operación. Reason Se establecerá ServiceTimeout en en este caso.
- No se admite el tamaño especificado de la entidad o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota. El motivo del error se establecerá QuotaExceeded en en este caso.
- El servidor está ocupado. Debe esperar antes de volver a intentar la operación. El motivo del error se establecerá ServiceBusy en en este caso.
- Se produce un error interno o una excepción inesperada. El motivo del error se establecerá GeneralError en en este caso.
Comentarios
Produce si ya existe un tema. TopicProperties para los valores predeterminados de las propiedades del tema.
Se aplica a
CreateTopicAsync(String, CancellationToken)
Crea un nuevo tema en el espacio de nombres del servicio con el nombre especificado.
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
Nombre del tema relativo a la dirección base del espacio de nombres del servicio.
- cancellationToken
- CancellationToken
Una instancia opcional CancellationToken para indicar la solicitud para cancelar la operación.
Devoluciones
del TopicProperties tema recién creado.
Excepciones
Existe un tema con el mismo nombre en el mismo espacio de nombres de servicio.
La operación agota el tiempo de espera. El período de tiempo de espera se inicializa a través de la ServiceBusAdministrationClientOptions clase (consulte la propiedad Retry). Es posible que tenga que aumentar el valor de tiempo de espera para evitar esta excepción si el valor de tiempo de espera es relativamente bajo.
No se admite el tamaño especificado en la descripción o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota.
El servidor está ocupado. Debe esperar antes de volver a intentar la operación.
El nombre del tema es nulo o está vacío.
El nombre del tema supera la longitud máxima permitida.
El nombre del tema no es válido.
Permiso insuficiente para realizar esta operación. Debe comprobar para asegurarse de que ServiceBusAdministrationClient tiene las notificaciones necesarias para realizar esta operación. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- Existe un tema con el mismo nombre en el mismo espacio de nombres de servicio. Reason Se establecerá MessagingEntityAlreadyExists en en este caso.
- Se agota el tiempo de espera de la operación. Reason Se establecerá ServiceTimeout en en este caso.
- No se admite el tamaño especificado de la entidad o se ha alcanzado la cuota máxima permitida. Debe especificar uno de los valores de tamaño admitidos, eliminar entidades existentes o aumentar el tamaño de la cuota. El motivo del error se establecerá QuotaExceeded en en este caso.
- El servidor está ocupado. Debe esperar antes de volver a intentar la operación. El motivo del error se establecerá ServiceBusy en en este caso.
- Se produce un error interno o una excepción inesperada. El motivo del error se establecerá GeneralError en en este caso.
Comentarios
Produce si ya existe un tema. TopicProperties para los valores predeterminados de las propiedades del tema.
Se aplica a
Azure SDK for .NET