Compartir a través de


ServiceBusAdministrationClient.GetQueueAsync Método

Definición

Recupera una cola del espacio de nombres del servicio.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>> GetQueueAsync (string name, System.Threading.CancellationToken cancellationToken = default);
abstract member GetQueueAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>
override this.GetQueueAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>
Public Overridable Function GetQueueAsync (name As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of QueueProperties))

Parámetros

name
String

Nombre de la cola relativa al espacio de nombres de Service Bus.

cancellationToken
CancellationToken

Una instancia opcional CancellationToken para indicar la solicitud para cancelar la operación.

Devoluciones

QueueProperties que contiene información sobre la cola.

Excepciones

Se agota el tiempo de espera de la operación. 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 del tiempo de espera para evitar esta excepción si el valor de tiempo de espera es relativamente bajo.

La cola con este nombre no existe.

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

  • No se encontró la entidad especificada. Reason Se establecerá MessagingEntityNotFound en en este caso.
  • Se agota el tiempo de espera de la operación. Reason Se establecerá ServiceTimeout 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.

Se aplica a