全部產品
Search
文件中心

ApsaraVideo Live:ListRtcMPUEventSubRecord

更新時間:Jul 16, 2026

查詢混流轉推事件訂閱記錄。

介面說明

本介面用於查詢混流轉推事件訂閱記錄,查詢範圍為近 7 天的資料。

QPS 限制

本介面的單使用者 QPS 限制為 100 次/秒。超過限制,API 呼叫會被限流,這可能會影響您的業務,請合理呼叫。

調試

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

調試

授權資訊

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

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

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

live:ListRtcMPUEventSubRecord

list

*全部資源。

*

請求參數

名稱

類型

必填

描述

樣本值

AppId

string

訂閱的應用程式 ID。透過存取 影片直播>直播+>即時音影片>應用程式管理 可以查看擁有的應用程式 ID。

說明
  • 應用程式 ID 由大小寫字母、數字、底線、短劃線(-)組成,最大 64 字元。

  • 需要先呼叫 CreateRtcMPUEventSub 建立該應用程式 ID 的混流轉推事件訂閱。

yourAppId

SubId

string

訂閱的回呼 ID。

yourSubId

StartTime

string

查詢記錄的開始時間。 格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間),不得早於目前時間 7 天前。

1970-01-01T00:00:00Z

EndTime

string

查詢記錄的結束時間。 格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間),不得晚於目前時間。

1970-01-01T00:00:00Z

PageSize

integer

單頁顯示記錄的數量,取值範圍:1~100。

10

PageNo

integer

頁碼。

20

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

******3B-0E1A-586A-AC29-742247******

Count

integer

當前頁返回的回呼記錄總數。

1

HasMore

boolean

是否有下一頁。

false

Logs

array<object>

回呼記錄。

object

回呼記錄。

AppId

string

訂閱的應用程式 ID。

yourAppId

SubId

string

事件回呼 ID。

Sub-******9799B2C4500******

MsgId

string

回呼記錄 ID。

42bba8b5-********-9b501dd6cb6e

Data

string

回呼內容,詳見建立混流轉推事件回呼

{\"EventType\":1,\"MsgId\":\"42bba8b5-94ab-468c-9dae-9b501dd6c***\",\"AppId\":\"rtcdev\",\"SubId\":\"Sub-9799B2C45009799B2C4***\",\"TaskId\":\"mpucallbacktest\",\"CallbackTs\":1712656430***,\"Payload\":{\"DstUrl\":\"rtmp://domain/app/stream?auth\",\"EventTs\":1712656430***,\"EventCode\":1,\"ErrorCode\":0,\"ErrorMessage\":\"\"}}

Time

string

回呼呼叫時間。 格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)

1970-01-01T00:00:00Z

Cost

integer

回呼時長,單位:毫秒。

22

CallbackUrl

string

回呼地址。

http://testcallback***.com/callback

HTTPCode

string

錯誤碼,200 為回呼成功。

200

樣本

正常返回樣本

JSON格式

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "Count": 1,
  "HasMore": false,
  "Logs": [
    {
      "AppId": "yourAppId",
      "SubId": "Sub-******9799B2C4500******",
      "MsgId": "42bba8b5-********-9b501dd6cb6e",
      "Data": "{\\\"EventType\\\":1,\\\"MsgId\\\":\\\"42bba8b5-94ab-468c-9dae-9b501dd6c***\\\",\\\"AppId\\\":\\\"rtcdev\\\",\\\"SubId\\\":\\\"Sub-9799B2C45009799B2C4***\\\",\\\"TaskId\\\":\\\"mpucallbacktest\\\",\\\"CallbackTs\\\":1712656430***,\\\"Payload\\\":{\\\"DstUrl\\\":\\\"rtmp://domain/app/stream?auth\\\",\\\"EventTs\\\":1712656430***,\\\"EventCode\\\":1,\\\"ErrorCode\\\":0,\\\"ErrorMessage\\\":\\\"\\\"}}",
      "Time": "1970-01-01T00:00:00Z",
      "Cost": 22,
      "CallbackUrl": "http://testcallback***.com/callback",
      "HTTPCode": "200"
    }
  ]
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 InvalidParam %s. 參數校驗失敗。
400 InvalidAppId %s, please check and try again later. AppId無效,請檢查後重試。
400 MissingParam %s, please check and try again later. 參數缺失,請檢查後重試。
500 InternalError InternalError
403 OperationDenied Your account has not enabled the Live service
403 Forbidden %s, please check and try again later. 無權限,請檢查後重試。

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

變更歷史

更多資訊,參考變更詳情