该接口用于查询录制，最大查询时间为 24 小时。

请求路径

/v1/cloudRecord

请求方法

GET

请求参数

参数 类型 是否必填 说明 默认值

app_id

String

是

应用 ID

-

channel

String

是

频道名称

-

from_hour

int

否

当天且在当前时间之前多少小时。限制：不能小于 0 且不能小于结束时间。

3

to_hour

int

否

当天且在当前时间之前多少小时。限制：不能小于0且不能大于起始时间。

5

offset

int

否

分页查询

0

limit

int

否

分页查询总条数，最大不能超过 100。

20

返回值

{
    "code":"success",
    "offset":0,
    "limit":20,
    "recinfos":[
        {
            "id":39,
            "project_id":"PHbrnM2Ff",
            "app_id":"34723259bb8f4768bc7a9c7cbb126baa",
            "channel":"crIUxmwHA2",
            "pid":15045,
            "host":"13rtc-rec-gw-bj13103.235.85.758020",
            "status":2,
            "size":0,
            "is_mix":1,
            "url_prefix":"",
            "files":"",
            "acc_key_id":"POAWWUCKNHNGNTHYJTXL",
            "rec_bucket":"sunny-video-recorde",
            "rec_zone":"pek3b",
            "rec_path":"CloudRecordMedia/",
            "created":"2021-11-18 14:56:43",
            "updated":"2021-11-18 14:56:43"
        }
    ],
    "total_count":1
}

返回数据说明，如下表所示。

参数 类型 是否必填 说明

code

String

是

响应代码

offset

int

是

分页偏移量

limit

int

是

分页，数据条数

recinfo.id

int

是

录制任务 ID

recinfo.project_id

String

是

项目 ID

recinfo.app_id

String

是

应用 ID

recinfo.channel

String

是

频道名称

recinfo.pid

String

是

进程 ID

recinfo.host

String

是

录制服务器地址

recinfo.status

String

是

参考录制状态说明

recinfo.size

String

是

录制文件大小

recinfo.is_mix

String

是

是否合流录制

recinfo.url_prefix

String

是

暂未使用

recinfo.files

String

是

暂未使用

recinfo.acc_key_id

String

是

access key

recinfo.rec_bucket

String

是

录制存储的bucket名称

recinfo.rec_zone

String

是

录制所在 zone

recinfo.rec_path

String

是

录制存储 bucket 路径

total_count

int

是

数据总条数

录制状态说明

0:  None：无意义
1:  Start：录制进程启动
2:  Recording：正在进行录制
3:  Recorded：录制已完成
4:  Stopping：录制已手动停止，正在进行退出处理
5:  AutoStopping：录制已自动停止，正在进行退出处理
6:  MergingSingleMedia：开始合并单流文件
7:  SingleMediaMerged：单流文件合并完成
8:  PushingToQingstor：开始上传到对象存储
9:  PushedToQingstor：上传到对象存储完成
10: Stopped：整个录制过程处理完毕
11: RepairingMedia：开始修复录制文件（异常处理）
30: RecordProcessCored：录制进程崩溃
31: RecordProcessCoredRepairSuccess：录制进程崩溃处理成功
32: RecordProcessCoredRepairFailed：录制进程崩溃处理失败
50: RepairMediaFailed：录制文件修复失败
51: MergeSingleMediaFailed：合并单流文件失败
52: PushToQingstorFailed：上传到对象存储失败
53: StopRecordProcessFailed：停止录制进程失败