調(diào)用DescribeRecordFiles查詢錄制生成的文件列表。

使用說明

本接口用于查詢錄制生成的文件列表。例如：您可以查詢錄制生成文件的創(chuàng)建時間、錄制時長等參數(shù)。

QPS限制

本接口的單用戶QPS限制為10次/秒。超過限制，API調(diào)用會被限流，這可能會影響您的業(yè)務(wù)，請合理調(diào)用。更多信息，請參見QPS限制。

調(diào)試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 DescribeRecordFiles

系統(tǒng)規(guī)定參數(shù)。取值：DescribeRecordFiles。

AppId String 是 yourAppId

應(yīng)用ID。僅支持傳單個ID，您可以在控制臺創(chuàng)建和查詢。
ChannelId String 否 yourChannelId

頻道ID。僅支持傳單個ID。
PageSize Integer 否 10

每頁顯示個數(shù)，默認為10，每頁最多顯示100個數(shù)據(jù)。

PageNum Integer 否 1

第幾頁，默認查詢第1頁。
StartTime String 否 2020-11-01T17:36:00Z

開始時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

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

結(jié)束時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

TaskIds.N String 否 yourTaskId

錄制任務(wù)ID（和StartRecordTask入?yún)⒅械腡askId一致），最多支持10個任務(wù)批量查詢。格式如下所示： 


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

返回數(shù)據(jù)

名稱 類型 示例值 描述
TotalPage Long 1

返回分頁數(shù)。
RequestId String 760bad53276431c499e30dc36f6b****

請求ID。
TotalNum Long 1

返回結(jié)果數(shù)。
RecordFiles Array of RecordFile

文件列表。
StartTime String 2020-11-01T17:36:00Z

開始時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

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

創(chuàng)建時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

AppId String yourAppId

應(yīng)用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

任務(wù)ID。
StopTime String 2020-11-02T17:36:00Z

結(jié)束時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

示例

請求示例

https://rtc.aliyuncs.com/?Action=DescribeRecordFiles
&AppId=yourAppId
&<公共請求參數(shù)>

正常返回示例

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狀態(tài)碼

語義

InternalError

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

500

內(nèi)部錯誤