创建流式任务接口(CreateFlowTask)

最近更新时间:2020-10-27 20:50:10

功能描述:

根据已设置的模板创建流式任务

请求方式:

POST

请求参数:

参数名 类型 是否必须 描述
FlowData json array 流式任务信息,json格式
IsTop int 是否置顶 1-是 0-否
CbMethod string 回调用户请求方法
CbUrl string 回调用户地址

FlowData参数说明:

参数名 类型 是否必须 描述
Preset string 模板名称
SrcInfo json array 参考下面srcInfo表格
DstBucket string 输出目标Bucket
DstDir string 截图上传目录,avsample类型专属参数,对其他任务类型不起作用
DstObjectKey string 输出目标文件名,若为切片任务,表示输出的切片列表名字
DstAcl string 转码视频访问权限设置,参数:private、public-read 默认:public-read
ExtParam string 附加参数,json格式

SrcInfo参数说明:

参数名 类型 是否必须 描述
path string 源文件在ks3的相对路径
index int 顺序,对拼接等功能有效
type string 源文件类型(默认为video,方便日后扩展)

ExtParam 参数说明:

用来在创建任务时传递不适用于放入模板里的字段,每种任务类型,extParam内容略有不同,参见《创建任务接口》

返回参数:

参数名 类型 是否必须 描述
ErrNum int
ErrMsg string
TaskID string 任务ID

请求示例:


POST /?Action=CreateFlowTask

&Version=2017-01-01

&X-Amz-Algorithm=AWS4-HMAC-SHA256

&X-Amz-Date=20170519T081513Z

&X-Amz-Credential=xxxx

&X-Amz-SignedHeaders=accept%3Bhost

&X-Amz-Signature=xxxxx HTTP/1.1

Host: kvs.cn-beijing-6.api.ksyun.com

Accept: application/json

{

    "FlowData":[

        {

            "Preset":"xxxx",

            "SrcInfo":[

                {

                    "path":"/xxxxx/xxxxx.mp4",

                    "type":"video",

                    "index":0

                }

            ],

            "DstBucket":"xxxx",

            "DstObjectKey":"xxxxx/xxxx.mp4",

            "DstDir":"",

            "DstAcl":"public-read",

            "ExtParam":""

        },

        {

            "Preset":"xxxx",

            "SrcInfo":[

                {

                    "path":"/xxxxx/xxxx.mp4",

                    "type":"video",

                    "index":0

                }

            ],

            "DstBucket":"xxxxx",

            "DstObjectKey":"xxxx/xxxx.mp4",

            "DstDir":"",

            "DstAcl":"public-read",

            "ExtParam":""

        }

    ],

    "Pipeline":"usual",

    "IsTop":0,

    "CbMethod":"POST",

    "CbUrl":"xxxxx"

}

返回示例:


HTTP/1.1 200 OK

Server: ksyun-open-platform

Date: Fri, 12 May 2017 08:01:06 GMT

Content-Type: application/json;charset=UTF-8

Transfer-Encoding: chunked

{

    "TaskID":"6ba8e05f80831902f6315c0265e8e00a20170815",

    "ErrNum":0,

    "ErrMsg":"success"

}

金山云,开启您的云计算之旅

免费注册