¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Descripción de cola

Descripción de cola

Actualizado: junio de 2015

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

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
Según si DeadLettering está activado, se mueve un mensaje 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. Después de este período, el mensaje se desbloquea y está disponible para que el siguiente receptor lo consuma. Configurable solo en el momento de la creación de la cola:

  • 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 está establecido en true, la cola tendrá en cuenta la sesión y solo soportará SessionReceiver. Las colas que tienen en cuenta la sesión no se admiten a través de REST.

  • Por defecto para colas duraderas: false

RequiresDuplicateDetection: True, False
Configurable solo en el momento de la creación de la cola.

  • Por defecto para colas duraderas: false

EnableDeadLetteringOnMessageExpiration: True, False
Este campo controla la forma en que CmdLets gestiona un mensaje con un TTL expirado. Si está activado y el mensaje expira, CmdLets mueve el mensaje desde la cola a la subcola de mensajes fallidos 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.

  • Por defecto: 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 está activo, CmdLets recopila/procesa en lotes operaciones múltiples en el back end para ser más eficiente respecto a 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 que CmdLets intenta entregar un mensaje antes de considerarlo un mensaje fallido o descartarlo.

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 desactiva una cola, esa cola no puede enviar ni 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\">
<MaxSizeInBytes>10000</MaxSizeInBytes>
<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:
© 2015 Microsoft