直播云 > API 文档 > Pub API >创建任务

创建任务

最近更新时间：2021-09-16 19:25:49

在服务端创建一个pub任务。

请求包

POST /tasks
Host: pili-pub.qiniuapi.com
Authorization: <QiniuToken>
Content-Type: application/json

{
    "name": "",
    "sourceUrls": [
        {
            "url":<URL>,
            "isp":<ISP>
        }
    ],  
    "runType": "seek",         
    "forwardUrls": [ 
        {
            "url":<URL>,
            "isp":<ISP>
        }
    ],
    "filter": {},
    "loopTimes": 0,
    "deliverStartTime": 123, 
    "deliverStopTime": 123 
}

参数名称	必填	说明
name	是	字符串，任务名称必须满足 `1-20个数字或字母`。
sourceUrls	是	对象数组，源地址，数组必须长度必须大于等于1，大于1的情况下为播单模式。
runType	是	字符串，任务类型, normal: 普通转推,seek: seek转推。
forwardUrls	是	对象数组，转推地址，数组必须长度必须大于等于1。
filter	否	用于筛选转推机器，有area和isp字段，祥见参数说明
loopTimes	否	整型，表示pub任务的循环次数，不填写此参数则默认为0，不循环；-1表示无限循环
deliverStartTime	否	整型，任务定时开始时间，单位：ms,必须要大于当前时间且小于设置定时关闭的时间。
deliverStopTime	否	整型，任务定时关闭时间，单位：ms,必须要大于当前时间且小于设置定时开始的时间。

参数

详细参数说明见参数说明

返回包

200 {
    "taskID":"taskID"
}

400 {
    "error": "invalid parameter"
}

500 {
    "error": "create task fail"
}

以上内容是否对您有帮助？