直播云

  • 直播云 > 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