全部產品
Search
文件中心

:Queue

更新時間:Sep 03, 2024

隊列是訊息儲存的目的地,隊列可以分成普通隊列和延時隊列。 如果發送訊息時不指定訊息延時,被發送到普通隊列的訊息立刻可以被消費,而發送到延時隊列需要經過設定的延時時間後才能被消費。

  • QueueURL

    • 格式:http://$AccountId.mns.<Region>.aliyuncs.com/queues/$QueueName

    • mns.<Region>.aliyuncs.com輕量訊息佇列(原 MNS)訪問網域名稱,Region輕量訊息佇列(原 MNS)部署的地區,您可以根據應用需要選擇不同的地區。

    • AccountId:隊列所有者的帳號ID。

    • QueueName:隊列名稱,同一個AccountId在同地區中的隊列名不能重名。

隊列屬性

  • DelaySeconds

    • 訊息延遲時間,單位:秒。

    • 取值範圍:0 ~ 604800秒(7天)。

    • 當該屬性大於0時,發送到隊列的所有訊息是延遲訊息,經過該屬性指定的時間後變為可消費訊息。

    • 如果發送訊息請求指定了DelaySeconds,以請求指定的DelaySeconds為準。

  • MaximumMessageSize

    • 訊息體最大長度,單位:Byte。

    • 取值範圍:1024 ~ 65536 Byte (64 KB)。

    • 該屬性用於限制發送到隊列的訊息體的最大長度,超過該長度發送訊息失敗。

  • MessageRetentionPeriod

    • 訊息最長保留時間,單位:秒。

    • 取值範圍:60 ~ 604800秒(7天)。

    • 發送到隊列的訊息最長保留該時間長度,超過指定時間,無論訊息是否被消費都將被刪除。

  • VisibilityTimeout

    • 訊息被receive後的隱藏時間長度,單位:秒。

    • 取值範圍:1 ~ 43200秒(12小時)。

    • 訊息被receive後,在該屬性指定的這段時間內訊息處於隱藏狀態。在這段時間內,可以刪除訊息或者修改訊息隱藏時間長度;超過這段時間,訊息可以再次被receive。

  • PollingWaitSeconds

    (batch)receive message請求最長等待時間,單位:秒。

    取值範圍:0 ~ 30秒。

    當隊列中沒有訊息時,(batch)receive message請求將運行在輕量訊息佇列(原 MNS)伺服器端。在該屬性指定的時間範圍內,如果有訊息發送到隊列中,立即返回訊息給使用者;如果超過該時間,仍然沒有訊息,返回MessageNotExist。

    如果(batch)receive message請求指定了wait seconds,以請求指定的時間為準。

  • LoggingEnabled

    是否開啟日誌管理功能。

    取值範圍:True/False。

    當該屬性為True時,輕量訊息佇列(原 MNS)將收集隊列的訊息作業日誌按照指定的方式進行推送,日誌管理請參見日誌管理概述

  • CreateTime

    • 隊列建立時間,從1970-1-1 00:00:00到現在的秒值。

  • LastModifyTime

    • 修改隊列屬性資訊的最近時間,從1970-1-1 00:00:00到現在的秒值。

  • ActiveMessages

    • 隊列中處於Active狀態的訊息總數,為近似值。

  • InactiveMessages

    • 隊列中處於Inactive狀態的訊息總數,為近似值。

  • DelayMessages

    • 隊列中處於Delayed狀態的訊息總數,為近似值。