腾讯云对象存储提交任务

功能描述

提交一个拼接任务。

授权说明

授权策略中 action 设置为 ci:CreateMediaJobs 。查看所有 action。

服务开通

使用该功能需提前开通数据万象，并绑定存储桶。详情请参见绑定存储桶。

使用限制

使用该接口时，请先确认相关限制条件。详情请参见使用限制。

请求

请求示例

POST /jobs HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>Content-Type: application/xml
<body>

说明Authorization: Auth String（详情请参见请求签名文档）。通过子账号使用时，需要授予相关的权限，详情请参见授权粒度详情文档。

请求头

此接口仅使用公共请求头部，详情请参见公共请求头部文档。

请求体

该请求操作的实现需要有如下请求体。

<Request>    <Tag>Concat</Tag>    <Input>        <Object>input/demo.mp4</Object>    </Input>    <Operation>        <TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>        <Output>            <Region>ap-chongqing</Region>            <Bucket>test-123456789</Bucket>            <Object>output/out.${ext}</Object>        </Output>        <UserData>This is my data.</UserData>        <JobLevel>0</JobLevel>    </Operation>    <CallBack>http://callback.demo.com</CallBack>    <CallBackFormat>JSON</CallBackFormat></Request>

具体的数据描述如下：

节点名称（关键字）	父节点	描述	类型	是否必选
Request	无	保存请求的容器	Container	是

Container 类型 Request 的具体数据描述如下：

节点名称（关键字）	父节点	描述	类型	是否必选
Tag	Request	创建任务的 Tag：Concat	String	是
Input	Request	待操作的文件信息	Container	否
Operation	Request	操作规则	Container	是
CallBackFormat	Request	任务回调格式，JSON 或 XML，默认 XML，优先级高于队列的回调格式	String	否
CallBackType	Request	任务回调类型，Url 或 TDMQ，默认 Url，优先级高于队列的回调类型	String	否
CallBack	Request	任务回调地址，优先级高于队列的回调地址。设置为 no 时，表示队列的回调地址不产生回调	String	否
CallBackMqConfig	Request	任务回调TDMQ配置，当 CallBackType 为 TDMQ 时必填。详情见 CallBackMqConfig	Container	否

Container 类型 Input 的具体数据描述如下：

节点名称（关键字）	父节点	描述	类型	是否必选
Object	Request.Input	文件路径	String	是

Container 类型 Operation 的具体数据描述如下：

节点名称（关键字）	父节点	描述	类型	是否必选
TemplateId	Request.Operation	拼接模板 ID	String	否
ConcatTemplate	Request.Operation	拼接参数	Container	否
Output	Request.Operation	结果输出配置	Container	是
JobLevel	Request.Operation	任务优先级，级别限制：0 、1 、2 。级别越大任务优先级越高，默认为0	String	否

注意拼接参数必须设置，可以通过 TemplateId 或 ConcatTemplate 设置， TemplateId 优先级更高。Container 类型 ConcatTemplate 的具体数据描述如下：

节点名称（关键字）	父节点	描述	类型	默认值	是否必选
ConcatFragment	Request.Operation.ConcatTemplate	拼接节点，支持多个文件，按照文件顺序拼接	Container 数组	无	否
Audio	Request.Operation.ConcatTemplate	音频参数，同创建拼接模板接口中的 Request.ConcatTemplate.Audio	Container	无	否
Video	Request.Operation.ConcatTemplate	视频参数，同创建拼接模板接口中的 Request.ConcatTemplate.Video	Container	无	否
Container	Request.Operation.ConcatTemplate	封装格式，同创建拼接模板接口中的 Request.ConcatTemplate.Container	Container	无	是
AudioMix	Request.Operation.ConcatTemplate	混音参数，详情见 AudioMix	Container	无	否
AudioMixArray	Request.Operation.Transcode	混音参数数组，最多同时传2个	Container 数组	无	否
Index	Request.Operation.ConcatTemplate	Input 节点位于 ConcatFragment 序列索引，不能大于 ConcatFragment 长度	String	0	否
DirectConcat	Request.Operation.ConcatTemplate	简单拼接方式（不转码直接拼接），其他的视频和音频参数失效，取值 true/false	String	false	否

说明AudioMix 和 AudioMixArray 在 Audio.Remove 为 false 时生效。AudioMixArray 是一个数组，每一个子项内容同 AudioMix 。AudioMix 优先级更高，设置 AudioMix 时，AudioMixArray 无效。Container 类型 ConcatFragment 的具体数据描述如下：

节点名称（关键字）	父节点	描述	类型	默认值	是否必选
Url	Request.Operation.ConcatTemplate.ConcatFragment	同 bucket 对象地址，需要 urlEncode	String	无	是
FragmentIndex	Request.Operation.ConcatTemplate.ConcatFragment	拼接对象的索引位置，大于等于0的整数	String	0	否
StartTime	Request.Operation.ConcatTemplate.ConcatFragment	开始时间[0, 视频时长]单位为秒当Request.Operation.ConcatTemplate.DirectConcat 为 true 时不生效	String	视频开始	否
EndTime	Request.Operation.ConcatTemplate.ConcatFragment	结束时间[0, 视频时长]单位为秒当 Request.Operation.ConcatTemplate.DirectConcat 为 true 时不生效	String	视频结束	否

Container 类型 Output 的具体数据描述如下：

节点名称（关键字）	父节点	描述	类型	是否必选
Region	Request.Operation.Output	存储桶的地域	String	是
Bucket	Request.Operation.Output	存储结果的存储桶	String	是
Object	Request.Operation.Output	输出结果的文件名	String	是

Request.Operation.Output.Object 支持的通配符如下：

通配符	含义
${ext}	封装格式
${jobid}	任务Id

响应

响应头

此接口仅返回公共响应头部，详情请参见公共响应头部文档。

响应体

该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：

            Success                j8d121820f5e411ec926ef19d53ba9c6f        Submitted        2022-06-27T15:23:10+0800        -        -        p2242ab62c7c94486915508540933a2c6        Concat                    test-123456789                        ap-chongqing                            t1460606b9752148c4ab182f55163ba7cd            concat_demo                            ap-chongqing                test-123456789                                        This is my data.            0

具体的数据内容如下：

节点名称（关键字）	父节点	描述	类型
Response	无	保存结果的容器	Container

Container 节点 Response 的内容：

节点名称（关键字）	父节点	描述	类型
JobsDetail	Response	任务的详细信息	Container 数组

Container 节点 JobsDetail 的内容：

节点名称（关键字）	父节点	描述	类型
Code	Response.JobsDetail	错误码，只有 State 为 Failed 时有意义	String
Message	Response.JobsDetail	错误描述，只有 State 为 Failed 时有意义	String
JobId	Response.JobsDetail	新创建任务的 ID	String
Tag	Response.JobsDetail	新创建任务的 Tag：Concat	String
State	Response.JobsDetail	任务状态Submitted：已提交，待执行Running：执行中Success：执行成功Failed：执行失败Pause：任务暂停，当暂停队列时，待执行的任务会变为暂停状态Cancel：任务被取消执行	String
CreationTime	Response.JobsDetail	任务的创建时间	String
StartTime	Response.JobsDetail	任务的开始时间	String
EndTime	Response.JobsDetail	任务的结束时间	String
QueueId	Response.JobsDetail	任务所属的队列 ID	String
Input	Response.JobsDetail	该任务的输入资源地址	Container
Operation	Response.JobsDetail	该任务的规则	Container

Container 节点 Input 的内容：

节点名称（关键字）	父节点	描述	类型
Region	Response.JobsDetail.Input	存储桶的地域	String
Bucket	Response.JobsDetail.Input	存储结果的存储桶	String
Object	Response.JobsDetail.Input	输出结果的文件名	String

Container 节点 Operation 的内容：

节点名称（关键字）	父节点	描述	类型
TemplateId	Response.JobsDetail.Operation	任务的模板 ID	String
TemplateName	Response.JobsDetail.Operation	任务的模板名称, 当 TemplateId 存在时返回	String
ConcatTemplate	Response.JobsDetail.Operation	同请求中的 Request.Operation.ConcatTemplate	Container
Output	Response.JobsDetail.Operation	同请求中的 Request.Operation.Output	Container
MediaInfo	Response.JobsDetail.Operation	输出文件的媒体信息，任务未完成时不返回，详见 MediaInfo	Container
MediaResult	Response.JobsDetail.Operation	输出文件的基本信息，任务未完成时不返回，详见 MediaResult	Container
UserData	Response.JobsDetail.Operation	透传用户信息	String
JobLevel	Response.JobsDetail.Operation	任务优先级	String

错误码

常见的错误信息请参见错误码文档。

实际案例

请求1：使用拼接模板 ID

请求

POST /jobs HTTP/1.1Authorization:q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR98****-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****Host:test-123456789.ci.ap-chongqing.myqcloud.comContent-Length: 166Content-Type: application/xml
    Concat                            t1460606b9752148c4ab182f55163ba7cd                    ap-chongqing            test-123456789                            This is my data.        0        http://callback.demo.com    JSON

响应

HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 230Connection: keep-aliveDate: Mon, 28 Jun 2022 15:23:12 GMTServer: tencent-cix-ci-request-id: NjMxMDJhYTNfMThhYTk0MGFfYmU1OV8zZjc=
            Success                j8d121820f5e411ec926ef19d53ba9c6f        Submitted        2022-06-27T15:23:10+0800        -        -        p2242ab62c7c94486915508540933a2c6        Concat                    test-123456789                        ap-chongqing                            t1460606b9752148c4ab182f55163ba7cd            concat_demo                            ap-chongqing                test-123456789                                        This is my data.            0

请求2：使用拼接参数

请求

POST /jobs HTTP/1.1Authorization:q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR98****-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****Host:test-123456789.ci.ap-chongqing.myqcloud.comContent-Length: 166Content-Type: application/xml
    Concat                                                        http://test-123456789.cos.ap-chongqing.myqcloud.com/start.mp4                                        http://test-123456789.cos.ap-chongqing.myqcloud.com/end.mp4                                        mp3                                        H.264                1000                1280                720                30                                        mp4                                        https://test-xxx.cos.ap-chongqing.myqcloud.com/mix1.mp3                Once                true                                    true                    3                    false                    0                    true                    1.7                                                        https://test-xxx.cos.ap-chongqing.myqcloud.com/mix2.mp3                Once                true                                    true                    3                    false                    0                    true                    1.7                                                        ap-chongqing            test-123456789                            This is my data.        0        http://callback.demo.com    JSON

响应

HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 230Connection: keep-aliveDate: Mon, 28 Jun 2022 15:23:12 GMTServer: tencent-cix-ci-request-id: NjMxMDJhYTNfMThhYTk0MGFfYmU1OV8zZjc=
            Success                j8d121820f5e411ec926ef19d53ba9c5d        Submitted        2022-06-27T15:23:10+0800        -        -        p2242ab62c7c94486915508540933a2c6        Concat                    test-123456789                        ap-chongqing                                                                http://test-123456789.cos.ap-chongqing.myqcloud.com/start.mp4                                                    http://test-123456789.cos.ap-chongqing.myqcloud.com/end.mp4                                                    mp3                                                    H.264                    1000                    1280                    720                    30                                                    mp4                                                    https://test-xxx.cos.ap-chongqing.myqcloud.com/mix1.mp3                    Once                    true                                            true                        3                        false                        0                        true                        1.7                                                                        https://test-xxx.cos.ap-chongqing.myqcloud.com/mix2.mp3                    Once                    true                                            true                        3                        false                        0                        true                        1.7                                                    1                                        ap-chongqing                test-123456789                                        This is my data.            0

请求3：多文件拼接

请求

POST /jobs HTTP/1.1Authorization:q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR98****-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****Host:test-123456789.ci.ap-chongqing.myqcloud.comContent-Length: 166Content-Type: application/xml
    Concat                                        http://test-123456789.cos.ap-chongqing.myqcloud.com/start.mp4                0                0                6                                        http://test-123456789.cos.ap-chongqing.myqcloud.com/middle.mp4                1                                        http://test-123456789.cos.ap-chongqing.myqcloud.com/end.mp4                2                5                10                                        mp4                                        ap-chongqing            test-123456789                            This is my data.        0        http://callback.demo.com    JSON

响应

HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 230Connection: keep-aliveDate: Mon, 28 Jun 2022 15:23:12 GMTServer: tencent-cix-ci-request-id: NjMxMDJhYTNfMThhYTk0MGFfYmU1OV8zZjc=
            Success                j8d121820f5e411ec926ef19d53ba9c5d        Submitted        2022-06-27T15:23:10+0800        -        -        p2242ab62c7c94486915508540933a2c6        Concat                    test-123456789                        ap-chongqing                                                                http://test-123456789.cos.ap-chongqing.myqcloud.com/start.mp4                    0                    6                                                    http://test-123456789.cos.ap-chongqing.myqcloud.com/middle.mp4                                                    http://test-123456789.cos.ap-chongqing.myqcloud.com/end.mp4                    5                    10                                                    mp4                                                        ap-chongqing                test-123456789                                        This is my data.            0

对象存储官网1折活动，限时活动，即将结束，速速收藏
 同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠

转转请注明出处：https://www.yunxiaoer.com/145152.html

腾讯云对象存储提交任务

功能描述

授权说明

服务开通

使用限制

请求

请求示例

请求头

请求体

响应

响应头

响应体

错误码

实际案例

请求1：使用拼接模板 ID

请求

响应

请求2：使用拼接参数

请求

响应

请求3：多文件拼接

请求

响应

联系我们

400-800-8888

腾讯云对象存储提交任务

功能描述

授权说明

服务开通

使用限制

请求

请求示例

请求头

请求体

响应

响应头

响应体

错误码

实际案例

请求1：使用拼接模板 ID

请求

响应

请求2：使用拼接参数

请求

响应

请求3：多文件拼接

请求

响应

相关推荐

阿里云ECS云服务器通用流程-云淘科技

腾讯云对象存储设置存储桶标签

腾讯云容器服务Prometheus 监控相关同尘科技

腾讯云容器服务概述同尘科技

腾讯云云函数(SCF)网络相关问题 -云淘科技

联系我们

400-800-8888