ListTopic - 查詢阿里雲帳號下的主題列表 - Simple Message Queue (formerly MNS)

調用ListTopic介面查詢阿里雲帳號下的主題列表，可分頁擷取資料。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

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: 普通主題 fifo: FIFO 主題	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	Subscription 的建立時間，從 1970-01-01 00:00:00 到現在的。	1449554962
LastModifyTime	integer	最近一次修改 Subscription 屬性資訊的時間，從 1970-01-01 00:00:00 到現在的秒值。	1449554962
LoggingEnabled	boolean	是否開啟日誌管理功能。 True：啟用。 False：停用。	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: 普通主題 fifo: FIFO 主題	normal

樣本

正常返回樣本

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"
      }
    ]
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。