详情页标题前

腾讯云对象存储任务操作

详情页1

简介

文档提供关于数据万象媒体处理任务的相关 API 概览以及 SDK 示例代码,此处以动图任务举例。

API 操作名 操作描述
CreateMediaJobs 创建任务 创建一个媒体处理任务
CancelMediaJob 删除任务 删除一个媒体处理任务,正在处理中的任务不可删除
DescribeMediaJob 查询任务 查询一个任务
DescribeMediaJobs 查询任务列表 查询队列中的任务列表

基本操作

创建任务

功能说明

创建一个媒体处理任务。

方法原型

public MediaJobResponse createMediaJobs(MediaJobsRequest req);

参数说明

Request 中的具体数据描述如下:

节点名称(关键字) 父节点 描述 类型 必选
Tag Request 创建任务的 Tag:Animation 动图任务,Snapshot 截图任务,Transcode 转码任务,SmartCover 智能封面任务 String
Input Request 待操作的媒体信息 Container
Operation Request 操作规则 Container
QueueId Request 任务所在的队列 ID, 开通预览服务后自动生成,请在 万象控制台 中查询 String

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

节点名称(关键字) 父节点 描述 类型 必选
Object Request.Input 媒体文件的名字 String

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

节点名称(关键字) 父节点 描述 类型 必选
Animation Request.Operation 指定该任务的参数,同创建动图模板 CreateMediaTemplate 接口中的 Request.Animation Container
Snapshot Request.Operation 指定该任务的参数,同创建截图模板 CreateMediaTemplate 接口中的 Request.Snapshot Container
Transcode Request.Operation 指定该任务的参数,同创建转码模板 CreateMediaTemplate 接口中的 Request.Transcode Container
Watermark Request.Operation 指定该任务的参数,同创建水印模板 CreateMediaTemplate 接口中的 Request.Watermark Container
SmartCover Request.Operation 当 Tag 为 SmartCover 时有效,目前为空 Container
TemplateId Request.Operation 指定的模板 ID String
Output Request.Operation 结果输出地址 Container

注意 优先使用 TemplateId,无 TemplateId 时使用对应任务类型的参数。Container 类型 Animation 的具体数据描述如下:

节点名称(关键字) 父节点 描述 类型 必选
Container Request.Operation.Animation 同动图模板 CreateMediaTemplate 接口中的 Request.Container Container
Video Request.Operation.Animation 同动图模板 CreateMediaTemplate 接口中的 Request.Video Container
TimeInterval Request.Operation.Animation 同动图模板 CreateMediaTemplate 接口中的 Request.TimeInterval Container

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

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

返回结果说明

成功:返回 job 对象响应信息。失败:发生错误(如 Bucket 不存在),抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理

请求示例

//1.创建任务请求对象MediaJobsRequest request = new MediaJobsRequest();//2.添加请求参数 参数详情请见api接口文档request.setBucketName("examplebucket-1250000000");request.setTag("Transcode");request.getInput().setObject("1.mp4");request.getOperation().setTemplateId("t0e09a9456d4124542b1f0e44d501*****");request.getOperation().getOutput().setBucket("examplebucket-1250000000");request.getOperation().getOutput().setRegion("ap-chongqing");request.getOperation().getOutput().setObject("2.mp4");//3.调用接口,获取任务响应对象MediaJobResponse response = client.createMediaJobs(request);

取消任务

功能说明

取消一个未在处理中的任务。

方法原型

public Boolean cancelMediaJob(MediaJobsRequest req);

参数说明

参数名称 描述 类型 必选
bucketName Bucket 的命名规则为 BucketName-APPID,详情请参见 存储桶概述 String
jobId 要取消的任务 ID String

返回结果说明

成功: 返回一个布尔类型,成功则返回 true。失败: 发生错误(如身份认证失败),抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理

请求示例

MediaJobsRequest request = new MediaJobsRequest();request.setBucketName("examplebucket-1250000000");request.setJobId("jae776cb4ec3011eab2cdd3817d4*****");Boolean response = client.cancelMediaJob(request);

查询任务

功能说明

根据任务 id 查询任务详情。

方法原型

public MediaJobResponse describeMediaJob(MediaJobsRequest req);

参数说明

参数名称 描述 类型 必选
bucketName Bucket 的命名规则为 BucketName-APPID,详情请参见 存储桶概述 String
jobId 要查询的任务 id String

返回结果说明

成功: 返回任务详情响应包装类,类中包含一个 MediaJobObject 任务详情对象。 失败: 发生错误(如身份认证失败),抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理

请求示例

//1.创建任务请求对象MediaJobsRequest request = new MediaJobsRequest();//2.添加请求参数 参数详情请见api接口文档request.setBucketName("examplebucket-1250000000");request.setJobId("j29a82fea08ba11ebb54bc9d1c05*****");//3.调用接口,获取任务响应对象MediaJobResponse response = client.describeMediaJob(request);

查询任务列表

功能说明

查询队列中的任务列表。

方法原型

public MediaListJobResponse describeMediaJobs(MediaJobsRequest cIMediaJobsRequest);   

参数说明

节点名称(关键字) 描述 类型 必选
bucketName Bucket 的命名规则为 BucketName-APPID,详情请参见 存储桶概述 String
tag 任务的Tag:Animation String
queueId 拉取该队列 ID 下的任务,开通预览服务后自动生成,请在万象控制台中查询 String
orderByTime Desc 或者 Asc。默认为 Desc String
nextToken 请求的上下文,用于翻页。上次返回的值 String
size 拉取的最大任务数。默认为10。最大为100 Integer
states 拉取该状态的任务,以,分割支持多状态 All、Submitted、Running、SuccessFailed、Pause、Cancel。默认为 All String
startCreationTime 拉取创建时间大于该时间的任务。格式为:%Y-%m-%dT%H:%m:%S%z String
endCreationTime 拉取创建时间小于该时间的任务。格式为:%Y-%m-%dT%H:%m:%S%z String

返回结果说明

成功: 返回一个任务集合响应实体。失败: 发生错误(如身份认证失败),抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理

请求示例

MediaJobsRequest request = new MediaJobsRequest();request.setBucketName("examplebucket-1250000000");request.setTag("Transcode");MediaListJobResponse response = client.describeMediaJobs(request);List jobsDetail = response.getJobsDetail();



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

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

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

相关推荐

  • 腾讯云容器服务购买 TKE Anywhere 集群同尘科技

    计费说明 TKE Anywhere 集群目前正在内测中,您可以免费使用 TKE Anywhere 集群服务,即目前您开通或使用本服务,并不需向腾讯云支付费用。但TKE Anywhere 集群是商业化服务,待公测阶段结束后会公布收费标准,若您继续使用则需按腾讯云公布的收费标准支付费用,并应遵守届时腾讯云公布的服务协议和相关规则、规范;如届时您拒绝支付本服务费用…

    腾讯云 2023年12月9日
  • 阿里云日志服务SLS数据采集概述-云淘科技

    日志服务支持采集服务器与应用、开源软件、物联网、移动端、标准协议、阿里云产品等多种来源的数据。本文列举了日志服务所支持的数据来源。 数据来源 日志服务支持的数据来源如下: 类别 来源 接入方式 更多 应用 程序输出 Logtail 查询分析程序日志 访问日志 Logtail 分析Nginx访问日志 链路跟踪 Trace服务 Logtail 无 时序数据 Lo…

    阿里云日志服务SLS 2023年12月10日
  • 信息流广告,信息流部分建议宽度830px,只针对默认列表样式,顺序随机
  • 腾讯云弹性伸缩多机型配置

    操作场景 实例类型在每个可用区支持情况不同,您可能会面对所选机型在当前可用区售罄或相关配置问题,多机型配置可帮助您有效的解决此类问题。多机型配置功能具备以下特点:能够有效降低售罄、实例调用失败带来的扩容失败风险。可推荐您选择多种与您首选机型在配置、价格、性能相似的机型,并在您的首选机型售罄情况下,为您智能选择其他库存丰富的机型。 操作步骤 多机型配置 1. …

    2023年12月9日
  • DMS数仓开发调度任务的问题。当前在重跑补数据?-云小二-阿里云

    DMS数仓开发调度任务的问题。当前在重跑补数据?是否可以设置自动重跑。有的时候莫名其妙原因失败,再跑一次就好了,他能设置失败了自动重跑1次么。这个任务大概跑3分钟,但是红框这几个跑了2小时。看了下时间都是在等待,他在等待啥,我这个阶段数据库上没什么任务啊

    2023年12月27日
  • 腾讯云云函数(SCF)开发调试-云淘科技

    开发模式 Serverless Cloud Framework 支持开发模式(dev 模式),处于开发状态下的项目可以更便捷的进行代码编写及开发调试。在开发模式中,用户可以持续地进行开发 – 调试的过程,减少了打包、更新等其他工作的干扰。 进入开发模式 在项目下执行 scf dev 命令,可以进入项目的开发模式。示例如下:注意目前 scf dev…

    2023年12月9日

联系我们

400-800-8888

在线咨询: QQ交谈

邮件:admin@example.com

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

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