Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Описание очереди

 

Описание очереди — это XML- AtomPub документ, определяющий семантику очереди. Это описание содержит следующие свойства. Автоматизация пользовательского интерфейса также позволяет скриптам автоматических тестов взаимодействовать с UI.

MaxSizeInMegaBytes: Number

задает максимальный размер очереди в мегабайтах. Любая попытка постановки сообщения в очередь, которая вызывает превышение очереди, приведет к сбою. Этот параметр можно задавать только при создании очереди с использованием следующих значений:

  • Диапазон: 1 – 1024 (допустимые значения: 1024, 2048, 3072, 4096, 5120)

  • По умолчанию: 1*1024 (допустимые значения: 1024, 2048, 3072, 4096, 5120)

SizeinBytes: Number

отражает фактическое количество байтов, которые в настоящее время заняты сообщениями в очереди, для учета в квоте очереди.

MessageCount: Number

отражает число сообщений в очереди в настоящее время.

DefaultMessageTimeToLive: XML datetime

В зависимости от того, следует ли DeadLettering будет включена, сообщение автоматически перемещается DeadLetterQueue или удаляется, если он был сохранен в очереди дольше указанного времени. Это значение перезаписывается значением TTL, заданным в сообщении, тогда и только тогда, когда TTL сообщения меньше TTL, заданного в очереди. После создания очереди это значение изменить нельзя:

  • Диапазон: 1 секунда – TimeSpan.MaxValue

  • По умолчанию: TimeSpan.MaxValue

LockDuration: XML datetime

определяет время в секундах, в течение которого сообщение должно быть блокировано для обработки получателем. По истечении этого периода сообщение разблокированным и доступным для использования получателем далее:

  • Диапазон: 0 – 5 минут. 0 означает, что сообщение не блокировано

  • По умолчанию: 30 секунд

RequiresSession: True, False

Настраивается только при создании очереди. Если значение true, очередь будет поддерживать сеансы и только SessionReceiver будут поддерживаться. Очереди с учетом сеансов не поддерживаются через REST.

  • По умолчанию для устойчивой очереди: false

RequiresDuplicateDetection: True, False

Настраивается только при создании очереди.

  • По умолчанию для устойчивой очереди: false

EnableDeadLetteringOnMessageExpiration: True, False

Это поле определяет как Служебная шина обрабатывает сообщения с истекшим сроком ЖИЗНИ. Если оно включено и срок жизни сообщения истек, Служебная шина перемещает сообщение из очереди в подочередь недоставленных сообщений очереди. Если выключено, сообщение окончательно удаляется из очереди. Настраивается только при создании очереди.

  • По умолчанию: false

DuplicateDetectionHistoryTimeWindow

Задает интервал времени, во время которого Служебная шина определяет наличие повторяющихся сообщений:

  • Диапазон: 1 секунда – 7 дней

  • По умолчанию: 10 минут

EnableBatchedOperations

Включает и выключает пакетную обработку на стороне службы при выполнении операций для определенной очереди. При включении Служебная шина собирает и пакетов несколько операций в серверной части для более эффективно с соединением. Если необходимо уменьшить задержку выполнения операции, можно выключить эту функцию.

ForwardTo

Путь к получателю, которому адресуется сообщение.

MaxDeliveryCount

Максимальное число Служебная шина пытается доставить сообщение, прежде чем очередь недоставленных сообщений или удалено.

IsAnonymousAccessible

Получает разрешение на анонимный доступ.

AuthorizationRules

Получает правила авторизации для описания.

Status

Получает или задает текущее состояние очереди (включен или выключен). При выключении очереди она не может отправлять или получать сообщения.

SupportOrdering

Получает или задает поддержку порядка в очереди.

Важно отметить, что проверка схемы описания во время создания очереди зависит от порядка ее дочерних элементов. Например, следующее описание не принимается как допустимое описание очереди.

<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>

Однако, если элементы появляются, как указано ниже, оно принимается как допустимое описание очереди.

<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>

  • Перечисление всех очередей по заданному пути:

    http://<serviceBusAddress>/$Resources/Queues?$filter=startswith(path, ‘/my/test’)
    
  • Перечисление всех очередей, обновленных в последние 5 минут:

    http://<serviceBusAddress>/$Resources/Queues?$filter=lastModifiedTime Gt  2011-08-09T21:44:36.2481552Z
    
  • Перечисление всех очередей с хотя бы одним сообщением:

    http://<serviceBusAddress>/$Resources/Queues?$filter=MessageCount Gt 0
    
Показ: