Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Descripción de cola

 

La descripción de la cola es un XML AtomPub documento que define la semántica deseada de una cola. La descripción de la cola contiene las siguientes propiedades.Para obtener más información, vea el Propiedades QueueDescription tema.

MaxSizeInMegaBytes: Number

Especifica el tamaño máximo de la cola en megabytes. Cualquier intento de poner en cola un mensaje que provoque que la cola supere este valor provocará un error. Solo es posible establecer este parámetro en el momento de creación de la cola, mediante los siguientes valores:

  • Intervalo: 1 – 1024 (los valores válidos son 1024, 2048, 3072, 4096, 5120)

  • Por defecto: 1*1024 (los valores válidos son 1024, 2048, 3072, 4096, 5120)

SizeinBytes: Number

Refleja el número real de bytes que ocupan los mensajes de la cola respecto de la cuota de la cola.

MessageCount: Number

Muestra el número de mensajes que están actualmente en la cola.

DefaultMessageTimeToLive: XML datetime

Dependiendo de si DeadLettering está habilitado, un mensaje se mueve automáticamente a la DeadLetterQueue o se elimina si se ha almacenado en la cola durante más tiempo del especificado. Este valor lo sobrescribe un TTL especificado en el mensaje si y solo si el TTL del mensaje es menor que el TTL establecido en la cola. Este valor es inmutable tras la creación de la cola:

  • Intervalo: 1 segundo – TimeSpan.MaxValue

  • Por defecto: TimeSpan.MaxValue

LockDuration: XML datetime

Determina la cantidad de tiempo en segundos que un mensaje debe estar bloqueado para el procesamiento por parte del receptor. Tras este período, el mensaje se desbloquea y disponibles para su consumo por el siguiente receptor:

  • Intervalo: 0 – 5 minutos. 0 significa que el mensaje no está bloqueado

  • Por defecto: 30 segundos

RequiresSession: True, False

Configurable solo en el momento de la creación de la cola. Si establece en true, la cola será compatible con sesiones y solo SessionReceiver será compatible. Las colas que tienen en cuenta la sesión no se admiten a través de REST.

  • Valor predeterminado para la cola durable: false

RequiresDuplicateDetection: True, False

Configurable solo en el momento de la creación de la cola.

  • Valor predeterminado para la cola durable: false

EnableDeadLetteringOnMessageExpiration: True, False

Este campo controla cómo el CmdLets gestiona un mensaje con un TTL expirado. Si está habilitado y un mensaje expira, CmdLets mueve el mensaje de la cola a la subcola de mensajes no enviados de la cola. Si está desactivado, el mensaje se elimina de forma permanente de la cola. Configurable solo en el momento de la creación de la cola.

  • Valor predeterminado: false

DuplicateDetectionHistoryTimeWindow

Especifica el intervalo de tiempo durante el cual CmdLets detecta la duplicación de mensajes:

  • Intervalo: 1 segundo – 7 días

  • Por defecto: 10 minutos

EnableBatchedOperations

Activa o desactiva el comportamiento de procesamiento por lotes del lado del servicio cuando se realizan operaciones con la cola especificada. Cuando se habilita, CmdLets recopila y lotes varias operaciones en el back-end, para ser más eficiente con la conexión. Si quiere una menor latencia de operación, puede desactivar esta característica.

ForwardTo

La ruta al receptor al que se reenvía el mensaje.

MaxDeliveryCount

El número máximo de veces CmdLets intenta entregar un mensaje antes de ser descartados o no enviados con problemas de entrega.

IsAnonymousAccessible

Recupera si el acceso anónimo está permitido.

AuthorizationRules

Recupera las reglas de autorización para la descripción.

Estado

Recupera o establece el estado actual de la cola (activado o desactivado). Cuando se deshabilita una cola, esa cola no puede enviar o recibir mensajes.

SupportOrdering

Recupera o establece si las colas se pueden ordenar.

Es importante tener en cuenta que a la validación de esquema de la descripción durante la creación de la cola le afecta el orden de sus elementos hijo. Por ejemplo, lo siguiente no se aceptaría como una descripción de cola válida.

<QueueDescription xmlns=\"http://schemas.microsoft.com/netservices/2010/10/servicebus/connect\"> <MaxSizeInMegaBytes>10000</MaxSizeInMegaBytes> <DefaultMessageTimeToLive>PT5M</DefaultMessageTimeToLive> <LockDuration>PT2M</LockDuration> <RequiresGroupedReceives>False</RequiresGroupedReceives> <SupportsDuplicateDetection>False</SupportsDuplicateDetection> </QueueDescription>

Sin embargo, si los elementos aparecen como más abajo, se acepta como una descripción de cola válida:

<QueueDescription xmlns=\"http://schemas.microsoft.com/netservices/2010/10/servicebus/connect\"> <LockDuration>PT2M</LockDuration> <MaxSizeInMegaBytes>1024</MaxSizeInMegaBytes> <SupportsDuplicateDetection>false</SupportsDuplicateDetection> <RequiresGroupedReceives>false</RequiresGroupedReceives> <DefaultMessageTimeToLive>PT5M</DefaultMessageTimeToLive> </QueueDescription>

  • Obtener un listado de todos las colas en una ruta determinada:

    http://<serviceBusAddress>/$Resources/Queues?$filter=startswith(path, ‘/my/test’)
    
  • Obtener un listado de todos las colas actualizadas en los últimos 5 minutos:

    http://<serviceBusAddress>/$Resources/Queues?$filter=lastModifiedTime Gt  2011-08-09T21:44:36.2481552Z
    
  • Obtener un listado de todos las colas que tengan al menos un mensaje:

    http://<serviceBusAddress>/$Resources/Queues?$filter=MessageCount Gt 0
    
Mostrar: