ListRtcMPUEventSubRecord - 查询混流转推事件订阅记录

调用ListRtcMPUEventSubRecord查询混流转推事件订阅记录。

接口说明

使用说明

本接口用于查询混流转推事件订阅记录，查询范围为近 7 天的数据。

QPS 限制

本接口的单用户 QPS 限制为 100 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
live:ListRtcMPUEventSubRecord	list	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
AppId	string	是	订阅的应用 ID。说明应用 ID 由大小写字母、数字、下划线、短划线（-）组成，最大 64 字符。	yourAppId
SubId	string	否	订阅的回调 ID。	yourSubId
StartTime	string	是	查询记录的开始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）	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	long	当前页返回的回调记录总数。	1
HasMore	boolean	是否有下一页。	false
Logs	array<object>	回调记录。
SubInfo	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	long	回调时长，单位：毫秒。	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
403	OperationDenied	Your account has not enabled the Live service
403	Forbidden	%s
404	MissingParam	%s
500	InternalError	InternalError

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2024-07-04	OpenAPI 错误码发生变更	查看变更详情