全部產品
Search

搜尋本產品

    ApsaraMQ for RocketMQ：ListTraces - 查詢軌跡訊息列表

    文件中心

    ApsaraMQ for RocketMQ：ListTraces - 查詢軌跡訊息列表

    更新時間：Nov 06, 2025

    查詢指定主題下的軌跡訊息列表。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    rocketmq:ListTraces

    get

    *Topic

    acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}

    		 無 無

    請求文法

    GET /instances/{instanceId}/topics/{topicName}/traces HTTP/1.1

    路徑參數

    名稱

    類型

    必填

    描述

    樣本值
    instanceId

    string

    是

    執行個體 ID。

    rmq-cn-tl32upjeb08
    topicName

    string

    是

    主題名稱。

    topic_hpms_product_price_change

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    startTime

    string

    是

    開始時間。

    2023-05-10 10:42:11
    endTime

    string

    是

    結束時間。

    2023-05-19 10:10:09
    pageNumber

    integer

    是

    分頁頁碼，查詢第幾頁的返回結果。

    1
    pageSize

    integer

    是

    分頁大小，每頁做多顯示的返回結果數量。

    10
    queryType

    string

    是

    查詢類型。

    枚舉值：

    • MESSAGE_ID :

      MESSAGE_ID

    • MESSAGE_KEY :

      MESSAGE_KEY

    • TOPIC :

      TOPIC

    MESSAGE_ID
    messageId

    string

    否

    訊息 ID。

    queryType 選擇 MESSAGE_ID 時必填。

    0100163E0EC1F1965C04C7906700000000
    messageKey

    string

    否

    訊息 key。

    queryType 選擇 MESSAGE_KEY 時必填。

    order_ceating
    liteTopicName

    string

    否

    輕量主題名稱

    abc

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    requestId

    string

    Id of the request

    EDFF77E1-1ED1-5389-B6A8-651D9433BBE5
    success

    boolean

    執行結果是否成功。

    true
    code

    string

    錯誤碼。

    Topic.NotFound
    message

    string

    錯誤資訊。

    Parameter instanceId is mandatory for this action .
    data

    object

    返回結果。

    pageNumber

    integer

    當前頁碼。

    1
    pageSize

    integer

    分頁大小。

    10
    totalCount

    integer

    返回結果的總數量。

    1
    list

    array<object>

    分頁資料。

    object

    分頁資料。

    regionId

    string

    地區 ID。

    cn-hangzhou
    instanceId

    string

    執行個體 ID。

    rmq-cn-7e22ody****
    topicName

    string

    主題名稱。

    topic_test
    messageId

    string

    訊息 ID。

    7F00000100207A4F0F294A938F7807AE
    bornTime

    string

    產生時間。

    2023-03-22 12:17:08
    messageTag

    string

    標籤列表。

    xx
    messageKeys

    array

    業務標識。

    string

    業務標識。

    xx
    httpStatusCode

    integer

    HTTP 狀態代碼。

    200
    dynamicCode

    string

    動態錯誤碼。

    InstanceId
    dynamicMessage

    string

    動態錯誤資訊。

    InstanceId

    樣本

    正常返回樣本

    JSON格式

    {
  "requestId": "EDFF77E1-1ED1-5389-B6A8-651D9433BBE5",
  "success": true,
  "code": "Topic.NotFound",
  "message": "Parameter instanceId is mandatory for this action .",
  "data": {
    "pageNumber": 1,
    "pageSize": 10,
    "totalCount": 1,
    "list": [
      {
        "regionId": "cn-hangzhou",
        "instanceId": "rmq-cn-7e22ody****",
        "topicName": "topic_test",
        "messageId": "7F00000100207A4F0F294A938F7807AE",
        "bornTime": "2023-03-22 12:17:08",
        "messageTag": "xx",
        "messageKeys": [
          "xx"
        ]
      }
    ]
  },
  "httpStatusCode": 200,
  "dynamicCode": "InstanceId",
  "dynamicMessage": "InstanceId"
}

    錯誤碼

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

    變更歷史

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