全部產品
Search

搜尋本產品

    Simple Message Queue (formerly MNS)：ListSubscriptionByTopic - 列出主題下的Subscription列表

    文件中心

    Simple Message Queue (formerly MNS)：ListSubscriptionByTopic - 列出主題下的Subscription列表

    更新時間：Jan 30, 2026

    調用ListSubscriptionByTopic介面列出某個主題下的Subscription列表，可分頁擷取資料。

    調試

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

    調試

    授權資訊

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

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    mns:ListSubscriptionByTopic

    list

    *Subscription

    acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    TopicName

    string

    否

    主題的名稱。

    test
    PageNum

    integer

    否

    分頁頁碼，查詢第幾頁的返回結果。 取值範圍：1~100000000。 若您設定的參數值小於 1，則系統預設按照參數值為 1 處理；若您設定的參數值大於 100000000，則系統預設按照參數值為 100000000 處理。

    1
    PageSize

    integer

    否

    分頁大小，每頁最多顯示的返回結果數量。 取值範圍：10~50。 若您設定的參數值小於 10，則系統預設按照參數值為 10 處理；若您設定的參數值大於 50，則系統預設按照參數值為 50 處理。

    20
    SubscriptionName

    string

    否

    Subscription 的名稱。

    demo-subscription
    EndpointType

    string

    否

    EndpointValue

    string

    否

    返回參數

    名稱

    類型

    描述

    樣本值

    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>

    資料項目

    SubscriptionName

    string

    Subscription 的名稱。

    MySubscription
    TopicOwner

    string

    Subscription 訂閱的主題所有者的 AccountId。

    123456789098****
    TopicName

    string

    Subscription 訂閱的主題名稱。

    MyTopic
    Endpoint

    string

    訂閱的終端地址。

    http://example.com
    FilterTag

    string

    描述了該訂閱中訊息過濾的標籤（僅標籤一致的訊息才會被推送）。

    important

    CreateTime

    integer

    Subscription 的建立時間，從 1970-01-01 00:00:00 到現在的。

    1449554806

    LastModifyTime

    integer

    最近一次修改 Subscription 屬性資訊的時間，從 1970-01-01 00:00:00 到現在的秒值。

    1449554806

    NotifyStrategy

    string

    向 Endpoint 推送訊息錯誤時的重試策略。取值說明如下：

    • BACKOFF_RETRY：退避重試。

    • EXPONENTIAL_DECAY_RETRY：指數衰減重試。

    BACKOFF_RETRY
    NotifyContentFormat

    string

    向 Endpoint 推送的訊息內容格式。 取值說明如下：

    • XML

    • JSON

    • SIMPLIFIED

    XML
    DlqPolicy

    object

    死信策略

    Enabled

    boolean

    是否開啟死信訊息投遞

    true
    DeadLetterTargetQueue

    string

    死信訊息投遞目標隊列

    dead-letter-queue

    樣本

    正常返回樣本

    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": [
      {
        "SubscriptionName": "MySubscription",
        "TopicOwner": "123456789098****",
        "TopicName": "MyTopic",
        "Endpoint": "http://example.com",
        "FilterTag": "important\n",
        "CreateTime": 1449554806,
        "LastModifyTime": 1449554806,
        "NotifyStrategy": "BACKOFF_RETRY",
        "NotifyContentFormat": "XML",
        "DlqPolicy": {
          "Enabled": true,
          "DeadLetterTargetQueue": "dead-letter-queue"
        }
      }
    ]
  }
}

    錯誤碼

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

    變更歷史

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