ServiceBusAdministrationClient.CreateQueueAsync 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
| CreateQueueAsync(CreateQueueOptions, CancellationToken) |
Crea una nueva cola en el espacio de nombres del servicio con el nombre especificado. |
| CreateQueueAsync(String, CancellationToken) |
Crea una nueva cola en el espacio de nombres del servicio con el nombre especificado. |
CreateQueueAsync(CreateQueueOptions, CancellationToken)
Crea una nueva cola en el espacio de nombres del servicio con el nombre especificado.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>> CreateQueueAsync (Azure.Messaging.ServiceBus.Administration.CreateQueueOptions options, System.Threading.CancellationToken cancellationToken = default);abstract member CreateQueueAsync : Azure.Messaging.ServiceBus.Administration.CreateQueueOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>
override this.CreateQueueAsync : Azure.Messaging.ServiceBus.Administration.CreateQueueOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>Public Overridable Function CreateQueueAsync (options As CreateQueueOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of QueueProperties))Parámetros
- options
- CreateQueueOptions
Objeto CreateQueueOptions que describe los atributos con los que se creará la nueva cola.
- cancellationToken
- CancellationToken
Una instancia opcional CancellationToken para indicar la solicitud para cancelar la operación.
Devoluciones
del QueueProperties objeto de la cola recién creada.
Excepciones
Existe una entidad 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 una cola 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 una cola.
Se aplica a
CreateQueueAsync(String, CancellationToken)
Crea una nueva cola en el espacio de nombres del servicio con el nombre especificado.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>> CreateQueueAsync (string name, System.Threading.CancellationToken cancellationToken = default);abstract member CreateQueueAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>
override this.CreateQueueAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>Public Overridable Function CreateQueueAsync (name As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of QueueProperties))Parámetros
- name
- String
Nombre de la cola relativa 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 QueueProperties objeto de la cola recién creada.
Excepciones
Existe una entidad 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 de la cola es nulo o está vacío.
El nombre de la cola supera la longitud máxima permitida.
El nombre de la cola 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 una cola 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 una cola. QueueProperties para los valores predeterminados de las propiedades de la cola.
Se aplica a
Azure SDK for .NET