呼叫ListQueue介面,列出指定阿里雲帳號下的所有佇列,可分頁獲取資料。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
mns:ListQueue |
list |
*全部資源。
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| PageNum |
integer |
否 |
分頁頁碼,查詢第幾頁的返回結果。 取值範圍:1~100000000。 若您設定的參數值小於 1,則系統預設按照參數值為 1 處理;若您設定的參數值大於 100000000,則系統預設按照參數值為 100000000 處理。 |
1 |
| PageSize |
integer |
否 |
分頁大小,每頁最多顯示的返回結果數量。 取值範圍:10~50。 若您設定的參數值小於 10,則系統預設按照參數值為 10 處理;若您設定的參數值大於 50,則系統預設按照參數值為 50 處理。 |
20 |
| QueueName |
string |
否 |
Queue 名稱。 |
demo-queue |
| Tag |
array<object> |
否 |
資源標籤清單。 |
|
|
object |
否 |
標籤鍵對應的標籤值。 |
||
| Key |
string |
否 |
標籤的 key。 |
tag1 |
| Value |
string |
否 |
標籤值。 |
test |
| QueueType |
string |
否 |
佇列類型。可取值如下:
|
normal |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求的 ID。 |
06273500-249F-5863-121D-74D51123**** |
| Code |
integer |
回應 code。 |
200 |
| Status |
string |
回應的狀態。 |
Success |
| Message |
string |
回應資訊。 |
operation success |
| Success |
boolean |
請求是否成功。 |
true |
| Data |
object |
回應資料。 |
|
| PageNum |
integer |
分頁頁碼,查詢第幾頁的返回結果。 |
1 |
| PageSize |
integer |
分頁大小,每頁最多顯示的返回結果數量。 |
50 |
| Size |
integer |
當前頁結果數量。 |
20 |
| Pages |
integer |
總頁數。 |
3 |
| Total |
integer |
總結果數。 |
130 |
| PageData |
array<object> |
當前頁返回結果。 |
|
|
array<object> |
資料項。 |
||
| QueueName |
string |
佇列名稱。 |
demo-queue |
| CreateTime |
integer |
Queue 的建立時間,為 UTC Unix 秒級時間戳記。 |
1250700999 |
| LastModifyTime |
integer |
Queue 屬性最近一次修改時間,為 UTC Unix 秒級時間戳記。 |
1250700999 |
| DelaySeconds |
integer |
傳送到該 Queue 的所有訊息的延遲時間,傳送到佇列的訊息經過此參數設定的延時時間後,才能被消費,單位為秒。 |
30 |
| MaximumMessageSize |
integer |
傳送到該 Queue 的訊息主體的最大長度,單位為 Byte。 |
65536 |
| MessageRetentionPeriod |
integer |
訊息在該 Queue 中最長的存活時間,從傳送到該佇列開始經過此參數指定的時間後,不論訊息是否被取出過都將被刪除,單位為秒。 |
65536 |
| VisibilityTimeout |
integer |
訊息從該 Queue 中取出後從 Active 狀態變成 Inactive 狀態後的持續時間。 取值範圍:1~43200,單位為秒。 預設值:30。 |
60 |
| PollingWaitSeconds |
integer |
當 Queue 訊息量為空時,針對該 Queue 的 ReceiveMessage 請求最長的等待時間,單位為秒。 |
0 |
| ActiveMessages |
integer |
在該 Queue 中處於 Active 狀態的訊息總數,為近似值。 後續會預設為 0,不推薦使用,請使用雲端監控 API 獲取指標。 |
0 |
| InactiveMessages |
integer |
在該 Queue 中處於 Inactive 狀態的訊息總數,為近似值。 後續會預設為 0,不推薦使用,請使用雲端監控 API 獲取指標。 |
0 |
| DelayMessages |
integer |
在該 Queue 中處於 Delayed 狀態的訊息總數,為近似值。 後續會預設為 0,不推薦使用,請使用雲端監控 API 獲取指標。 |
0 |
| LoggingEnabled |
boolean |
是否啟用日誌管理功能。
|
True |
| Tags |
array<object> |
資源標籤清單。 |
|
|
object |
標籤鍵對應的標籤值。 |
||
| TagKey |
string |
標籤的 key。 |
tag1 |
| TagValue |
string |
標籤值。 |
test |
| DlqPolicy |
object |
死信佇列策略。 |
|
| Enabled |
boolean |
是否啟用死信訊息投遞。 |
true |
| DeadLetterTargetQueue |
string |
死信訊息投遞目標佇列。 |
deadLetterTargetQueue |
| MaxReceiveCount |
string |
訊息最大投遞次數。 |
3 |
| QueueType |
string |
佇列類型。可取值如下:
|
normal |
| EnableSSE |
boolean |
是否啟用儲存加密。取值:true 或 false。 |
true |
| SseType |
string |
儲存加密方式。取值:SMQ 或 KMS。 |
KMS |
| SseAlgorithm |
string |
儲存加密演算法,當前支援 AES-256-GCM;未指定時使用預設演算法。 |
AES-256-GCM |
| KmsKeyId |
string |
KMS 金鑰 ID。 |
key-xxx |
| EncryptionEnabled |
boolean |
是否已啟用儲存加密。 |
true |
樣本
正常返回樣本
JSON格式
{
"RequestId": "06273500-249F-5863-121D-74D51123****",
"Code": 200,
"Status": "Success",
"Message": "operation success",
"Success": true,
"Data": {
"PageNum": 1,
"PageSize": 50,
"Size": 20,
"Pages": 3,
"Total": 130,
"PageData": [
{
"QueueName": "demo-queue",
"CreateTime": 1250700999,
"LastModifyTime": 1250700999,
"DelaySeconds": 30,
"MaximumMessageSize": 65536,
"MessageRetentionPeriod": 65536,
"VisibilityTimeout": 60,
"PollingWaitSeconds": 0,
"ActiveMessages": 0,
"InactiveMessages": 0,
"DelayMessages": 0,
"LoggingEnabled": true,
"Tags": [
{
"TagKey": "tag1",
"TagValue": "test"
}
],
"DlqPolicy": {
"Enabled": true,
"DeadLetterTargetQueue": "deadLetterTargetQueue",
"MaxReceiveCount": "3"
},
"QueueType": "normal",
"EnableSSE": true,
"SseType": "KMS",
"SseAlgorithm": "AES-256-GCM",
"KmsKeyId": "key-xxx",
"EncryptionEnabled": true
}
]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。