直播云

    • 直播云 > API 文档 > Pub API >编辑任务

    编辑任务

    最近更新时间: 2023-03-17 17:25:28

    在服务端编辑一个pub任务。

    请求包

    备注：如果是海外的pub转推任务，请将Host改为：pili-hw-pub.qiniuapi.com

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

{
    "runType": "seek",
    "desc": "",
    "sourceUrls": [
        {
            "url":<URL>,
            "isp":<ISP>,
            "seek":<SEEK>,
            "videoType":<VIDEOTYPE>,
            "rtspType":<RTSPTYPE>
        }
    ],           
    "forwardUrls": [ 
        {
            "url":<URL>,
            "isp":<ISP>
        }
    ],
    "filter": {},
    "loopTimes": 0,
    "retryTime": 60,
    "deliverStartTime": 1637100000000, 
    "deliverStopTime": 1637100000000,
    "preload": {
       "enable": true,
       "preloadTime": 1637000600000
    },
    "statusCallback": {
       "type": "JSON",
       "url": <URL>,
       "vars": {
          "taskid": "$(taskID)",
          "status": "$(status)",
          "startTime": "$(startTime)",
          "stopTime": "$(stopTime)"
       }
    }
}
    参数名称 必填 说明
    taskID 是 任务id。
    sourceUrls 是 对象数组，源地址，数组必须长度必须大于等于1，大于1的情况下为播单模式。详见参数说明
    runType 是 字符串，任务类型, normal: 普通转推,seek: seek转推。
    forwardUrls 是 对象数组，转推地址，数组必须长度必须大于等于1。
    filter 否 用于筛选转推机器，有area和isp字段，详见参数说明
    loopTimes 否 整型， 表示pub任务的循环次数，不填写此参数则默认为0，不循环；-1表示无限循环。
    retryTime 否 整型， 表示pub任务的总断流重试时间，pub任务转推中断后会在断流重试时间内每不断进行重新连接，直至重连成功或者达到设定的总断流重试时间。在单位：s，必须大于等于60。注：任务中断（正常结束或者失败）重试后，运行时间超过1分钟，认为重连成功，会重置retryTime。（不适合点播流，存在无限循环的可能）
    deliverStartTime 否 整型，任务定时开始时间，单位：ms,必须要大于当前时间且小于设置定时关闭的时间。
    deliverStopTime 否 整型，任务定时关闭时间，单位：ms,必须要大于当前时间且大于设置定时开始的时间。
    preload 否 预加载相关配置，有enable和preloadTime字段，详见参数说明
    statusCallback 否 任务状态通知相关配置（任务正常结束或失败重试完后回调通知），详见参数说明

    参数

    返回包

    200 {}

400 {
    "error": "invalid parameter"
}

400 {
    "error": "invalid parameter deliverTime"
}

400 {
    "error": "invalid parameter filter"
}

400 {
    "error": "invalid parameter url"
}

400 {
    "error": "invalid parameter runType"
}

400 {
    "error": "invalid parameter loopTimes"
}

400 {
    "error": "invalid parameter retryTime"
}

400 {
    "error": "invalid parameter preloadTime"
}

404 {
    "error": "not fond"
}

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

400 {
    "error": "task running"
}

500 {
    "error": "edit task fail"
}
    以上内容是否对您有帮助？
    • Qvm free helper
    Close