全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

查看视频转码任务

最近更新时间:2026-11-18 14:05:03

GetAsyncProcess接口用于查看指定的某个视频转码任务。使用该接口的用户必须是主账号或具有ks3:GetAsyncProcess权限的其他用户。

请求

请求语法

GET /?asyncProcess&processId={processId} HTTP/1.1
Host: {bucket}.{endpoint}
Authorization: KSS {accessKey}:{signature}

请求参数

参数名称

描述

是否必选

asyncProcess

异步任务查询操作标识。

是

processId

任务ID,创建视频转码任务后KS3将返回该字段。

是

请求头

该接口仅使用公共请求头。

请求体

该接口不使用请求体。

响应

响应头

该接口仅返回公共响应头部。

响应体

响应体为一段描述视频转码任务的JSON:

{
  "processId": "MediaConvert-b3b70350-abce-4f46-80f1-db5bdbe9a57d",
  "status": "Failed",
  "code": "BadRequest",
  "message": "Unsupported media format(codec) or file corrupt.",
  "processType": "MediaConvert",
  "startTime": "2026-06-04T10:04:04.422Z",
  "endTime": "2026-06-04T10:04:05.02Z",
  "bucketName": "bucketname",
  "objectKey": "prefix/video.mp4",
  "params": {
    "f": "mp4",
    "vcodec": "h264",
    "acodec": "aac",
    "s": "1280×720"
  },
  "saveAs": {
    "bucketName": "bucketname",
    "objectKey": "prefix/video.mp4",
    "storageClass": "STANDARD"
  },
  "outputs": [
    {
      "bucketName": "bucketname",
      "objectKey": "prefix/video.mp4"
    }
  ],
  "callbackUrl": "http://10.1.2.3",
  "requestId": "5A4FCDBB-D960-537D-ABD4-EE9BEFB38803"
}

响应体的具体参数描述如下所示:

参数名称

说明

processId

任务唯一标识符,用于标识本次转码任务。

  • 示例:MediaConvert-b3b70350-abce-4f46-80f1-db5bdbe9a57d

包括数字、字母、横线,1-64字符,同一个UID下的processId唯一。

status

任务状态。

  • 取值:Pending(等待执行)、Running(处理中)、Succeeded(成功)、Failed(失败)

code

错误码,仅在任务失败时有值,用于标识具体错误类型。

message

错误描述信息,仅在任务失败时有值,详细说明失败原因。

processType

任务类型,标识执行的操作类型。

  • 取值:MediaConvert

startTime

任务开始时间,采用 ISO 8601 格式的 UTC 时间。

  • 示例:2026-06-04T10:04:04.422Z

endTime

任务结束时间,采用 ISO 8601 格式的 UTC 时间。

  • 2026-06-04T10:04:05.02Z

bucketName

源文件所在的存储桶名称。

objectKey

源文件在存储桶中的对象键(Key)。

  • 示例值:output/video.mp4

params

转码参数对象,包含视频和音频的编码设置。

f

输出文件格式。

  • 取值:mp4、mkv、mov、asf、avi、mxf、ts、flv、webm、mp3、aac、flac、oga、ac3、eac3、opus、amr

vcodec

视频编码格式。

  • 取值:copy、h264、h265、av1、vp8、vp9

acodec

音频编码格式。

  • 取值:copy、mp3、aac、flac、vorbis、ac3、opus、amr、eac3、pcm

s

目标分辨率,格式为w x h,即宽 x 高。

  • 类型:String

不返回时默认为原视频宽高。

saveAs

输出文件的保存位置配置。

bucketName

输出文件所在的存储桶名称。

objectKey

输出文件在存储桶中的对象键(Key)。

  • 示例:output/video.mp4

storageClass

输出文件的存储类型,创建任务时如果不选择该请求头,文件存储类型默认跟随桶的存储类型,此时查看或获取任务列表时不展示该字段。

outputs

输出文件列表,可能包含多个输出。

bucketName

单个输出文件所在的存储桶名称。

objectKey

单个输出文件在存储桶中的对象键(Key)。

callbackUrl

回调 URL,任务完成后会向该地址发送通知。

requestId

请求唯一标识符,用于追踪和调试。

示例

请求示例

GET /?asyncProcess&processId=MediaConvert-1234567890 HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Authorization: authorization string

响应示例

{
  "processId": "MediaConvert-b3b70350-abce-4f46-80f1-db5bdbe9a57d",
  "status": "Failed",
  "code": "BadRequest",
  "message": "Unsupported media format(codec) or file corrupt.",
  "processType": "MediaConvert",
  "startTime": "2026-06-04T10:04:04.422Z",
  "endTime": "2026-06-04T10:04:05.02Z",
  "bucketName": "bucketname",
  "objectKey": "prefix/video.mp4",
  "params": {
    "f": "mp4",
    "vcodec": "h264",
    "acodec": "aac",
    "s": "1280×720"
  },
  "saveAs": {
    "bucketName": "bucketname",
    "objectKey": "prefix/video.mp4",
    "storageClass": "STANDARD"
  },
  "outputs": [
    {
      "bucketName": "bucketname",
      "objectKey": "prefix/video.mp4"
    }
  ],
  "callbackUrl": "http://10.1.2.3",
  "requestId": "5A4FCDBB-D960-537D-ABD4-EE9BEFB38803"
}

错误码

HTTP 状态码

错误码

描述

404

NoSuchProcess

指定任务不存在。

400

InvalidRequest

请求不合法。

403 Forbidden

AccessDenied

没有权限。

404 Not Found

NoSuchBucket

桶不存在。

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈