调用DescribeRecordFiles查询录制生成的文件列表_音视频通信(RTC)-阿里云帮助中心

使用说明

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

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	内部错误