You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

请输入
  • 文档首页
    • 对象存储SDK 参考Java数据处理视频处理查询视频转码任务（Java SDK）
复制全文
下载 pdf
我的收藏
视频处理
查询视频转码任务（Java SDK）
复制全文
下载 pdf
我的收藏
查询视频转码任务（Java SDK）
本文介绍如何通过 TOS Java SDK 查询视频转码任务。​
注意事项​
仅 Java SDK 2.9.8 及以上版本支持查询视频转码任务的功能。​
示例代码​
​
// 根据 Id 查询视频转码任务​
package org.example.GetVideoConvertJob;​
​
import com.volcengine.tos.TOSV2;​
import com.volcengine.tos.TOSV2ClientBuilder;​
import com.volcengine.tos.TosClientException;​
import com.volcengine.tos.TosServerException;​
import com.volcengine.tos.comm.common.*;​
import com.volcengine.tos.model.bucket.*;​
import com.volcengine.tos.model.object.*;​
​
public class GetVideoConvertJobExample {​
public static void main(String[] args) {​
String endpoint = System.getenv("TOS_ENDPOINT");​
String region = System.getenv("TOS_REGION");​
String accessKey = System.getenv("TOS_ACCESS_KEY");​
String secretKey = System.getenv("TOS_SECRET_KEY");​
​
// 填写 BucketName，对应存放任务配置和结果的桶名称​
String bucketName = System.getenv("TOS_BUCKET");​
​
String jobId = "18860c8a52e85836aeb60001253eb055bab7";​
​
// 初始化客户端​
TOSV2 tos = new TOSV2ClientBuilder().build(region, endpoint, accessKey, secretKey);​
​
try {​
// 构造查询视频转码任务的输入参数​
// bucket 为创建任务时使用的桶名称​
// jobId 为创建任务后返回的任务 ID，用于标识具体的视频转码任务​
GetVideoConvertJobInput input = GetVideoConvertJobInput.builder()​
.bucket(bucketName)​
.jobId(jobId)​
.build();​
​
// 调用查询视频转码任务接口​
GetVideoConvertJobOutput output = tos.getVideoConvertJob(input);​
​
// 打印关键返回信息：请求 ID、状态码、任务 ID、任务状态、错误码与错误信息​
com.volcengine.tos.model.RequestInfo requestInfo = output.getRequestInfo();​
if (requestInfo != null) {​
System.out.println("查询视频转码任务成功");​
// RequestID 为本次请求的唯一标识，可用于排查问题​
System.out.println("RequestID: " + requestInfo.getRequestId());​
// StatusCode 为 HTTP 状态码，200 表示请求成功​
System.out.println("StatusCode: " + requestInfo.getStatusCode());​
}​
// JobID 为视频转码任务的唯一标识​
System.out.println("JobID: " + output.getJobID());​
// State 表示任务当前状态，如 Running、Success、Failed 等​
System.out.println("State: " + output.getState());​
// Code / Message 表示任务失败时的错误码和错误信息，成功时通常为 0/OK​
System.out.println("Code: " + output.getCode());​
System.out.println("Message: " + output.getMessage());​
System.out.println("Callback: " + output.getCallback());​
​
// 若返回包含任务输入信息，则打印任务输入对象 Object​
ConvertJobInput jobInput = output.getInput();​
if (jobInput != null) {​
System.out.println("\n任务输入:");​
// Object 表示待处理的视频源对象 Key​
System.out.println(" Object: " + jobInput.getObject());​
}​
​
// 若返回包含任务输出信息，则打印输出对象所在的 Region、Bucket 与 Object​
ConvertJobOutput jobOutput = output.getOutput();​
if (jobOutput != null) {​
System.out.println("\n任务输出:");​
// Region/Bucket/Object 分别表示转码结果输出所在的区域、桶与对象 Key​
System.out.println(" Region: " + jobOutput.getRegion());​
System.out.println(" Bucket: " + jobOutput.getBucket());​
System.out.println(" Object: " + jobOutput.getObject());​
}​
​
} catch (TosClientException e) {​
// 操作失败，捕获客户端异常，一般情况是请求参数错误，此时请求并未发送​
System.out.println("操作失败");​
System.out.println("Message: " + e.getMessage());​
if (e.getCause() != null) {​
e.getCause().printStackTrace();​
}​
} catch (TosServerException e) {​
// 操作失败，捕获服务端异常，可以获取到从服务端返回的详细错误信息​
System.out.println("操作失败");​
System.out.println("StatusCode: " + e.getStatusCode());​
System.out.println("Code: " + e.getCode());​
System.out.println("Message: " + e.getMessage());​
System.out.println("RequestID: " + e.getRequestID());​
} catch (Throwable t) {​
// 作为兜底捕获其他异常，一般不会执行到这里​
System.out.println("操作失败");​
System.out.println("unexpected exception, message: " + t.getMessage());​
}​
}​
}​
​
相关文档​
关于查询视频转码任务的相关API接口，请参见QueryMediaJob。​
​
最近更新时间：2026.04.03 17:59:07
这个页面对您有帮助吗？
有用
有用
无用
无用