- 请求方式：
get - 请求路径：
/live/record/query-record
请求参数说明
| 参数名 | 类型 | 名称 | 是否必填 | 说明 |
|---|---|---|---|---|
| TaskID | string | 任务ID | 是 | 任务ID，对应任务创建时返回的ID，目前只支持单个任务 |
返回参数说明
| 参数名 | 类型 | 名称 |
|---|---|---|
| code | int | 状态码，成功时为100000 |
| message | string | 描述信息，成功时为success |
| TaskList | list | 任务信息列表，目前只支持返回单个任务信息,详细说明如下 |
| TaskList[*].TaskID | string | 任务ID |
| TaskList[*].TaskType | string | 任务类型，含义分别为： live-record：直播录制 live-snapshot：直播截图 live-ext-redirect：直播转推 |
| TaskList[*].UniqName | string | 客户标识 |
| TaskList[*].DomainName | string | 域名 |
| TaskList[*].App | string | 频道名 |
| TaskList[*].Stream | string | 流名称 |
| TaskList[*].Params | object | 转码参数，当taskType等于live-record或live-snapshot时存在 |
| TaskList[*].Params.Output | object array | 输出参数 |
| TaskList[].Params.Output[ ].Format | string | 输出文件的封装格式 |
| TaskList[].Params.Output[ ].SegmentTime | string | 录制文件分段时长,按固定文件时长输出，单位秒 |
| TaskList[].Params.Output[ ].ResetTimestamps | int | 录制起始时间戳，仅仅针对mp4,flv.aac有效 取值范围为0和1，默认为1，分别表示： 0：分段文件起始时间戳不重置为0 1：分段文件起始时间戳重置为0 |
| TaskList[*].Params.OutTimeLink | string | 续录的超时时长，单位秒 |
| TaskList[*].Params.XOSAccessKey | string | XOS存储的访问密钥 |
| TaskList[*].Params.XOSSecretKey | string | XOS存储的访问密钥 |
| TaskList[*].Params.XOSBucket | string | XOS存储的Bucket名称 |
| TaskList[*].Params.XOSRegion | string | XOS存储的Region名称 |
| TaskList[*].Params.XOSEndpoint | string | XOS存储的服务地址 |
| TaskList[*].Params.RecordNotifyUrl | string | 录制文件回调通知URL |
| TaskList[*].CreateTime | string | 任务创建时间，格式yyyy-MM-dd HH:mm:ss |
| TaskList[*].UpdateTime | string | 任务更新时间，格式yyyy-MM-dd HH:mm:ss |
| TaskList[*].TaskStatus | string | 任务执行状态，有三种，分别是 “running” ：任务运行中 “finished” ：任务正常结束 “failed” ：任务失败 |
| TaskList[*].ErrMsg | string | 任务具体错误信息 |
返回参数说明
| 参数名 | 类型 | 名称 |
|---|---|---|
| code | int | 状态码，成功时为100000 |
| message | string | 描述信息，成功时为success |
| TaskID | string | 任务id |
调用示例
https://cdnapi-global.ctapi.ctyun.cn/live/record/query-record
返回结果：
{
"code":100000,
"TaskList":[
{
"App":"test",
"TaskID":"123",
"DomainName":"ctyun.cn",
"ErrMsg":"Task scheduling exception",
"CreateTime":"2022-02-24 14:31:37",
"Params":{
"RecordNotifyUrl":"test",
"OssAccessKey":"test",
"OssEndpoint":"test",
"Output":[
{
"Format":"hls",
"ResetTimestamps":0,
"SegmentTime":"10"
}
],
"OssBucket":"test",
"OssSecretKey":"test",
"OssRegion":"test",
"OutTimeLink":"100"
},
"TaskStatus":"failed",
"Template":"None",
"Referrer":"open-api",
"UniqName":"1234",
"TaskType":"live-record",
"UpdateTime":"2022-02-24 14:31:37",
"Worker":"unknown",
"Stream":"test",
"SrcUrl":"None",
"DstUrl":""
}
],
"message":"success"
}
