呼叫ListTopic介面查詢阿里雲帳號下的主題列表，可分頁取得資料。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
mns:ListTopic |
list |
*全部資源。
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| PageNum |
integer |
否 |
分頁頁碼，查詢第幾頁的回傳結果。 取值範圍：1~100000000。 若您設定的參數值小於 1，則系統預設按照參數值為 1 處理；若您設定的參數值大於 100000000，則系統預設按照參數值為 100000000 處理。 |
1 |
| PageSize |
integer |
否 |
分頁大小，每頁最多顯示的回傳結果數量。 取值範圍：10~50。 若您設定的參數值小於 10，則系統預設按照參數值為 10 處理；若您設定的參數值大於 50，則系統預設按照參數值為 50 處理。 |
20 |
| TopicName |
string |
否 |
主題的名稱。 |
test |
| Tag |
array<object> |
否 |
標籤列表。 |
|
|
object |
否 |
標籤鍵對應的標籤值。 |
||
| Key |
string |
否 |
標籤的 key。 |
tag1 |
| Value |
string |
否 |
標籤值。 |
test |
| TopicType |
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 |
| Total |
integer |
總結果數。 |
130 |
| PageData |
array<object> |
當前頁回傳結果。 |
|
|
array<object> |
資料項目。 |
||
| TopicName |
string |
主題的名稱。 |
demo-topic |
| MessageCount |
integer |
當前該主題中訊息數目。 |
0 |
| MaxMessageSize |
integer |
發送到該主題的訊息體最大長度，單位為 Byte。 |
65536 |
| MessageRetentionPeriod |
integer |
訊息在主題中最長存活時間，從發送到該主題開始經過此參數指定的時間後，不論訊息是否被成功推送給使用者都將被刪除，單位為秒。 |
86400 |
| CreateTime |
integer |
主題的建立時間，為 UTC Unix 秒級時間戳記。 |
1449554962 |
| LastModifyTime |
integer |
主題屬性最近一次修改時間，為 UTC Unix 秒級時間戳記。 |
1449554962 |
| LoggingEnabled |
boolean |
是否開啟日誌管理功能。
|
True |
| TopicUrl |
string |
訊息 Topic URL。 |
http:// 111111111****.mns.us-west-1.aliyuncs.com/topics/testTopic |
| TopicInnerUrl |
string |
訊息 Topic URL（內網存取）。 |
http:// 111111111****.mns.us-west-1-internal.aliyuncs.com/topics/testTopic |
| Tags |
array<object> |
資源標籤列表。 |
|
|
object |
標籤鍵對應的標籤值。 |
||
| TagKey |
string |
標籤的 key。 |
tag1 |
| TagValue |
string |
標籤值。 |
test |
| TopicType |
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,
"Total": 130,
"PageData": [
{
"TopicName": "demo-topic",
"MessageCount": 0,
"MaxMessageSize": 65536,
"MessageRetentionPeriod": 86400,
"CreateTime": 1449554962,
"LastModifyTime": 1449554962,
"LoggingEnabled": true,
"TopicUrl": "http:// 111111111****.mns.us-west-1.aliyuncs.com/topics/testTopic",
"TopicInnerUrl": "http:// 111111111****.mns.us-west-1-internal.aliyuncs.com/topics/testTopic",
"Tags": [
{
"TagKey": "tag1",
"TagValue": "test"
}
],
"TopicType": "normal",
"EnableSSE": true,
"SseType": "KMS",
"SseAlgorithm": "AES-256-GCM",
"KmsKeyId": "key-xxx",
"EncryptionEnabled": true
}
]
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。