匯出 (0) 列印
全部展開

佇列描述

更新日期: 2014年4月

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

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

  • 範圍:1 - 1024 (有效值為 1024、2048、3072、4096、5120)

  • 預設值:1*1024 (有效值為 1024、2048、3072、4096、5120)

SizeinBytesNumber
反映佇列中目前佔用佇列配額之訊息的實際位元組。

  • 範圍:0 –MaxSizeinMegaBytes

MessageCountNumber
顯示目前在佇列中的訊息數目。

DefaultMessageTimeToLiveXML datetime
根據是否啟用 DeadLettering,會自動將訊息移至 DeadLetterQueue 或是在該訊息已儲存在佇列中超過指定的時間時予以刪除。只有在訊息 TTL 小於佇列上設定的 TTL 時,此值才會覆寫為訊息中指定的 TTL。建立佇列之後,此值就會永遠不變:

  • 範圍:1 秒 - TimeSpan.MaxValue

  • 預設值:TimeSpan.MaxValue

LockDurationXML datetime
決定應該鎖定訊息以供接收者處理的時間量 (秒)。在此期間之後,系統會將訊息解除鎖定,並供下一個接收者使用。只能在佇列建立期間進行設定:

  • 範圍:0 - 5 分鐘。0 表示未鎖定訊息

  • 預設值:30 秒

RequiresSessionTrue, False
只能在佇列建立期間進行設定。如果設定為 true,則佇列會具有工作階段感知,而且只支援 SessionReceiver。不支援透過 REST 的工作階段感知佇列。

  • 長期佇列的預設值:false

RequiresDuplicateDetectionTrue, False
只能在佇列建立期間進行設定。

  • 長期佇列的預設值:false

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

  • 預設值:false

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

  • 範圍:1 秒 - 7 天

  • 預設值:10 分鐘

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

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

MaxDeliveryCount
訊息 SB 在變成無法傳送的信件或予以捨棄之前嘗試傳遞的次數上限。

IsAnonymousAccessible
取得是否允許匿名存取。

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

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

SupportOrdering
取得或設定佇列是否支援排序。

請一定要注意,在佇列建立期間,描述的結構描述驗證與其子元素的順序有關。例如,不接受將下列項目作為有效佇列描述。

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

不過,如果元素出現如下,則會接受將它作為有效佇列描述:

<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, ‘/foo/bar’)
    
  • 列出前 5 分鐘更新的所有佇列:

    http://<serviceBusAddress>/$Resources/Queues?$filter=lastModifiedTime Gt  2011-08-09T21:44:36.2481552Z
    
  • 列出具有至少一個訊息的所有佇列:

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

顯示:
© 2014 Microsoft