详情页标题前

腾讯云对象存储提交任务

• 腾讯云
详情页1

功能描述

提交一个极速高清转码任务。

授权说明

授权策略中 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（详情请参见 请求签名 文档）。通过子账号使用时，需要授予相关的权限，详情请参见 授权粒度详情 文档。

请求头

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

请求体

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

    Transcode            input/demo.mp4                t1460606b9752148c4ab182f55163ba7cd        t1318c5f428d474afba1797f84091cbe22        t1318c5f428d474afba1797f84091cbe23        t1318c5f428d474afba1797f84091cbe24                    Text            123456789ab            V1            false                            ap-chongqing            test-123456789            output/out.${ext}                This is my data.        0        http://callback.demo.com    JSON

具体的数据描述如下：

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

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

节点名称（关键字） 父节点 描述 类型 是否必选
Tag Request 创建任务的Tag：Transcode 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, 此处需要传入极速高清模板 ID String 是
WatermarkTemplateId Request.Operation 水印模板 ID，可以传多个水印模板 ID，最多传3个 String 数组 否
Watermark Request.Operation 水印模板参数，同创建水印模板接口中的Request.Watermark，最多传3个 Container 数组 否
DigitalWatermark Request.Operation 数字水印参数，详情见 DigitalWatermark Container 否
Output Request.Operation 结果输出配置 Container 是
UserData Request.Operation 透传用户信息，可打印的 ASCII 码，长度不超过1024 String 否
JobLevel Request.Operation 任务优先级，级别限制：0 、1 、2 。级别越大任务优先级越高，默认为0 String 否

说明水印参数可选，可以通过 WatermarkTemplateId 或 Watermark 设置，WatermarkTemplateId 优先级更高。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        0        2022-06-27T15:23:10+0800        -        -        p2242ab62c7c94486915508540933a2c6        Transcode                    test-123456789            input/demo.mp4            ap-chongqing                            t1460606b9752148c4ab182f55163ba7cd            high_993874            t1318c5f428d474afba1797f84091cbe22            t1318c5f428d474afba1797f84091cbe23            t1318c5f428d474afba1797f84091cbe24                            Text                123456789ab                V1                false                Running                                        ap-chongqing                test-123456789                output/out.${ext}                        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：Transcode String
State Response.JobsDetail 任务状态Submitted：已提交，待执行Running：执行中Success：执行成功Failed：执行失败Pause：任务暂停，当暂停队列时，待执行的任务会变为暂停状态Cancel：任务被取消执行 String
Progress Response.JobsDetail 任务进度百分比，范围为[0, 100] 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 任务的模板名称 String
Watermark Response.JobsDetail.Operation 同请求中的 Request.Operation.Watermark Container 数组
WatermarkTemplateId Response.JobsDetail.Operation 同请求中的 Request.Operation.WatermarkTemplateId String 数组
Output Response.JobsDetail.Operation 同请求中的 Request.Operation.Output Container
MediaInfo Response.JobsDetail.Operation 输出文件的媒体信息，任务未完成时不返回，详见 MediaInfo Container
MediaResult Response.JobsDetail.Operation 输出文件的基本信息，任务未完成时不返回，详见 MediaResult Container
DigitalWatermark Response.JobsDetail.Operation 同请求中的 Request.Operation.DigitalWatermark Container
UserData Response.JobsDetail.Operation 透传用户信息 String
JobLevel Response.JobsDetail.Operation 任务优先级 String

错误码

该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

实际案例

请求

POST /jobs HTTP/1.1Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0ea057Host: test-1234567890.ci.ap-chongqing.myqcloud.comContent-Length: 166Content-Type: application/xml
    Transcode            input/demo.mp4                t1460606b9752148c4ab182f55163ba7cd        t1318c5f428d474afba1797f84091cbe22        t1318c5f428d474afba1797f84091cbe23        t1318c5f428d474afba1797f84091cbe24                    Text            123456789ab            V1            false                            ap-chongqing            test-123456789            output/out.${ext}                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: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
            Success                j8d121820f5e411ec926ef19d53ba9c6f        Submitted        0        2022-06-27T15:23:11+0800        -        -        p2242ab62c7c94486915508540933a2c6        Transcode                    test-123456789            input/demo.mp4            ap-chongqing                            t1460606b9752148c4ab182f55163ba7cd            high_993874            t1318c5f428d474afba1797f84091cbe22            t1318c5f428d474afba1797f84091cbe23            t1318c5f428d474afba1797f84091cbe24                            Text                123456789ab                V1                false                Running                                        ap-chongqing                test-123456789                output/out.${ext}                        This is my data.            0



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

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

赞 (0)
0
上一篇 2023年12月9日
下一篇 2023年12月9日
详情页2

相关推荐

  • 腾讯云云点播防盗链

    简介 将媒体播放链接，盗挂到其他站点播放的行为，称为盗链。盗链不仅威胁版权安全，还会对被盗方造成 CDN 带宽流量的损失。云点播支持 Referer 防盗链和 Key 防盗链两种形式，防范非法盗链行为。 分类 功能 说明 Referer 防盗链 来源页面地址控制 基于 HTTP 协议支持的 Referer 机制，通过播放请求 Header 中携带的 Refe…

    腾讯云 2023年12月9日
  • 腾讯云容器服务关联集群同尘科技 腾讯云

    腾讯云容器服务关联集群同尘科技

    操作场景 本文档介绍如何在 Prometheus 监控服务中关联集群与监控实例，关联成功后即可编辑数据采集规则等配置。当前支持跨 VPC 关联，支持在同一个监控实例内监控不同地域不同 VPC 下的集群。 前提条件 已登录 容器服务控制台，并创建集群。已创建 监控实例。 操作步骤 关联集群 注意关联集群成功后将在集群中安装监控数据采集插件，该插件在解除关联的同…

    2023年12月9日

  • 腾讯云对象存储操作列表

    腾讯云对象存储服务（COS）相关接口及说明如下： Service 接口 API 操作名 操作描述 GET Service（List Buckets） 查询存储桶列表 查询指定账号下所有存储桶列表 Bucket 接口 基本操作接口 API 操作名 操作描述 PUT Bucket 创建存储桶 在指定账号下创建一个存储桶 GET Bucket（List Objec…

    腾讯云 2023年12月9日
  • 信息流广告，信息流部分建议宽度830px，只针对默认列表样式，顺序随机

  • 阿里云容器服务ACKRAM鉴权-云淘科技

    在使用RAM账号调用阿里云API前，需要主账号（即阿里云账号）通过创建授权策略对RAM账号进行授权。 资源授权 默认RAM账号没有权限通过调用阿里云API去创建、修改云资源。使用RAM账号调用API时，您需要先创建一个授权策略，然后将这个授权策略关联给对应的RAM账号完成资源授权。 在创建授权策略时，您可以通过ARN（Aliyun Resource Name…

    阿里云容器服务 2023年12月10日

  • 腾讯云容器服务Pod 处于 CrashLoopBackOff 状态同尘科技

    本文档介绍可能导致 Pod 处于 CrashLoopBackOff 状态的几种情形，以及如何通过排查步骤定位异常原因。请按照以下步骤依次进行排查，定位问题后恢复正确配置即可。 现象描述 Pod 处于 CrashLoopBackOff 状态，说明该 Pod 在正常启动过后异常退出过，此状态下 Pod 的 restartPolicy 如果不是 Never 就可能…

    腾讯云 2023年12月9日

联系我们

400-800-8888

在线咨询： QQ交谈

邮件：admin@example.com

工作时间：周一至周五，9:30-18:30，节假日休息

关注微信
本站为广大会员提供阿里云、腾讯云、华为云、百度云等一线大厂的购买，续费优惠，保证底价，买贵退差。