调用DescribeRecordFiles查询录制生成的文件列表。

使用说明

本接口用于查询录制生成的文件列表。例如:您可以查询录制生成文件的创建时间、录制时长等参数。

QPS限制

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeRecordFiles

系统规定参数。取值:DescribeRecordFiles

AppId String yourAppId

应用ID。仅支持传单个ID,您可以在控制台创建和查询。

ChannelId String yourChannelId

频道ID。仅支持传单个ID。

PageSize Integer 10

每页显示个数,默认为10,每页最多显示100个数据。

PageNum Integer 1

第几页,默认查询第1页。

StartTime String 2020-11-01T17:36:00Z

开始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

EndTime String 2020-11-02T17:36:00Z

结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

TaskIds.N String yourTaskId

录制任务ID(和StartRecordTask入参中的TaskId一致),最多支持10个任务批量查询。格式如下所示:


TaskIds.1=****
TaskIds.2=****
......

返回数据

名称 类型 示例值 描述
TotalPage Long 1

返回分页数。

RequestId String 760bad53276431c499e30dc36f6b****

请求ID。

TotalNum Long 1

返回结果数。

RecordFiles Array of RecordFile

文件列表。

StartTime String 2020-11-01T17:36:00Z

开始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

CreateTime String 2020-10-02T17:36:00Z

创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

AppId String yourAppId

应用ID。

ChannelId String yourChannelId

频道ID。

Url String http://rtc-demo.oss-cn-****.aliyuncs.com/record/10-15-1/****/record-002_yourTaskId/example.m3u8

录制文件OSS URL。

Duration Float 1800

录制文件时长。

TaskId String yourTaskId

任务ID。

StopTime String 2020-11-02T17:36:00Z

结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

示例

请求示例

https://rtc.aliyuncs.com/?Action=DescribeRecordFiles
&AppId=yourAppId
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeRecordFilesResponse>
<TotalNum>3</TotalNum>
	<RequestId>AB2D3461-2F88-43DC-B60F-2F4C9BDB6522</RequestId>
	<TotalPage>1</TotalPage>
	<RecordFiles>
		<TaskId>yourTaskId</TaskId>
		<AppId>9qb1zcyc</AppId>
		<CreateTime>2020-11-17T05:08:12Z</CreateTime>
		<StartTime>2020-11-17T04:40:28Z</StartTime>
		<Duration>1482.29</Duration>
		<ChannelId>record-002</ChannelId>
		<Url>http://rtc-demo.oss-cn-****.aliyuncs.com/record/10-15-1/****/record-002_yourTaskId/2020-11-17-12-40-28_2020-11-17-13-05-10.m3u8</Url>
		<StopTime>2020-11-17T05:05:11Z</StopTime>
	</RecordFiles>
	<RecordFiles>
		<TaskId>yourTaskId</TaskId>
		<AppId>9qb1zcyc</AppId>
		<CreateTime>2020-11-17T04:40:37Z</CreateTime>
		<StartTime>2020-11-17T04:10:27Z</StartTime>
		<Duration>1800.01</Duration>
		<ChannelId>record-002</ChannelId>
		<Url>http://rtc-demo.oss-cn-****.aliyuncs.com/record/10-15-1/****/record-002_yourTaskId/2020-11-17-12-10-28_2020-11-17-12-40-28.m3u8</Url>
		<StopTime>2020-11-17T04:40:28Z</StopTime>
	</RecordFiles>
	<RecordFiles>
		<TaskId>yourTaskId</TaskId>
		<AppId>9qb1zcyc</AppId>
		<CreateTime>2020-11-17T04:10:34Z</CreateTime>
		<StartTime>2020-11-17T03:40:28Z</StartTime>
		<Duration>1799.95</Duration>
		<ChannelId>record-002</ChannelId>
		<Url>http://rtc-demo.oss-cn-****.aliyuncs.com/record/10-15-1/****/record-002_yourTaskId/2020-11-17-11-40-28_2020-11-17-12-10-28.m3u8</Url>
		<StopTime>2020-11-17T04:10:28Z</StopTime>
	</RecordFiles>
    </DescribeRecordFilesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalNum" : 3,
  "RequestId" : "AB2D3461-2F88-43DC-B60F-2F4C9BDB6522",
  "TotalPage" : 1,
  "RecordFiles" : [ {
    "TaskId" : "yourTaskId",
    "AppId" : "9qb1zcyc",
    "CreateTime" : "2020-11-17T05:08:12Z",
    "StartTime" : "2020-11-17T04:40:28Z",
    "Duration" : 1482.29,
    "ChannelId" : "record-002",
    "Url" : "http://rtc-demo.oss-cn-****.aliyuncs.com/record/10-15-1/****/record-002_yourTaskId/2020-11-17-12-40-28_2020-11-17-13-05-10.m3u8",
    "StopTime" : "2020-11-17T05:05:11Z"
  }, {
    "TaskId" : "yourTaskId",
    "AppId" : "9qb1zcyc",
    "CreateTime" : "2020-11-17T04:40:37Z",
    "StartTime" : "2020-11-17T04:10:27Z",
    "Duration" : 1800.01,
    "ChannelId" : "record-002",
    "Url" : "http://rtc-demo.oss-cn-****.aliyuncs.com/record/10-15-1/****/record-002_yourTaskId/2020-11-17-12-10-28_2020-11-17-12-40-28.m3u8",
    "StopTime" : "2020-11-17T04:40:28Z"
  }, {
    "TaskId" : "yourTaskId",
    "AppId" : "9qb1zcyc",
    "CreateTime" : "2020-11-17T04:10:34Z",
    "StartTime" : "2020-11-17T03:40:28Z",
    "Duration" : 1799.95,
    "ChannelId" : "record-002",
    "Url" : "http://rtc-demo.oss-cn-****.aliyuncs.com/record/10-15-1/****/record-002_yourTaskId/2020-11-17-11-40-28_2020-11-17-12-10-28.m3u8",
    "StopTime" : "2020-11-17T04:10:28Z"
  } ]
}

特殊错误码

错误代码

描述

HTTP状态码

语义

InternalError

The request processing has failed due to some unknown error, exception or failure.

500

内部错误