- 请求方式:
get
- 请求路径:
/live/ext-redirect/query-ext-redirect
请求参数说明
参数名 | 类型 | 名称 | 是否必填 | 说明 |
---|---|---|---|---|
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[*].SrcUrl | string array | 直播中心源流地址。 当taskType等于live-ext-redirect时存在,是字符串数组格式; |
TaskList[*].DstUrl | string | 直播中心推流地址。 当taskType等于live-ext-redirect时存在,是字符串格式 |
TaskList[*].ExtParam | object | 扩展参数,当taskType等于live-ext-redirect时存在 |
TaskList[*].ExtParam.PullRetryType | string | 拉流重试方式,有三种方式,分别是: “0”,不重试,默认值 “1”,按时长重试,时长通过PullRetryTimeOut设置 “2”,一直重试,重试间隔默认10s |
TaskList[*].ExtParam.PullRetryTimeOut | string | 拉流转推重试时长,PullRetryType 为“1”时生效 |
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 | 任务具体错误信息 |
调用示例
https://cdnapi-global.ctapi.ctyun.cn/live/ext-redirect/query-ext-redirect
返回结果:
{
"code":100000,
"TaskList":[
{
"App":"test",
"TaskID":"b055ff106fd64074ae43a3e99212bc33",
"DomainName":"ctyun.cn",
"ErrMsg":"Task scheduling exception",
"CreateTime":"2022-02-24 15:21:30",
"ExtParam":{
"PullRetryTimeOut":"300",
"PullRetryType":"1"
},
"TaskStatus":"failed",
"Template":"None",
"Referrer":"open-api",
"UniqName":"123",
"TaskType":"live-ext-redirect",
"UpdateTime":"2022-02-24 15:21:30",
"Worker":"unknown",
"Stream":"test",
"SrcUrl":"['ctyun.cn1', 'ctyun.cn2']",
"DstUrl":"ctyun.cn3;ctyun.cn4"
}
],
"message":"success"
}