本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

佇列描述

 

佇列描述是 XML AtomPub 定義佇列所需的語意的文件。 佇列描述包含下列屬性。如需詳細資訊,請參閱QueueDescription Properties 主題。

MaxSizeInMegaBytes: Number

指定佇列大小上限,以 MB 為單位。 任何對於將訊息放入佇列而導致佇列超過此值的嘗試都將失敗。 您只能在佇列建立期間,使用下列值來設定此參數:

  • 範圍: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

此欄位控制如何 服務匯流排 處理 TTL 過期的訊息。 如果啟用且訊息過期, 服務匯流排 將訊息從佇列移至佇列的寄不出信件子佇列。 停用時,會永久刪除佇列中的訊息。 只能在佇列建立期間進行設定。

  • 預設值: false

DuplicateDetectionHistoryTimeWindow

指定的時間範圍期間 服務匯流排 偵測訊息重複性:

  • 範圍:1 秒 - 7 天

  • 預設值:10 分鐘

EnableBatchedOperations

執行特定佇列的作業時,啟用或停用服務端批次行為。 啟用時, 服務匯流排 收集/批次處理至後端的多個作業以更有效率地使用連接。 如果您想要降低作業延遲,可以停用此功能。

ForwardTo

要轉寄郵件的收件者路徑。

MaxDeliveryCount

最大次數 服務匯流排 嘗試傳遞訊息之前信件或予以捨棄。

IsAnonymousAccessible

取得是否允許匿名存取。

AuthorizationRules

取得授權規則以查看說明。

狀態

取得或設定佇列的目前狀態 (啟用或停用)。 停用佇列時,該佇列無法傳送或接收訊息。

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
    
顯示: