文档首页 > > API参考> 视频转码接口> 查询转码任务

查询转码任务

分享
更新时间: 2019/12/06 GMT+08:00

功能描述

查询转码任务状态。

请求URI

GET /v1/{project_id}/transcodings

请求参数

表1 请求参数

参数

类型

说明

必选项(M)/可选项(O)

task_id

Integer

任务ID。一次最多可查询10个转码任务ID。

O

status

String

任务执行状态。

取值如下:

  • WAITING:等待启动
  • TRANSCODING:转码中
  • SUCCEEDED:转码成功
  • FAILED:转码失败
  • CANCELED:已删除
  • NEED_TO_BE_AUDIT:片源待审核

O

start_time

String

起始时间。若指定“task_id”,该参数无效。

格式:yyyymmddhhmmss。必须是与时区无关的UTC时间。

O

end_time

String

结束时间。若指定“task_id”,该参数无效。

格式:yyyymmddhhmmss。必须是与时区无关的UTC时间。

O

page

Integer

分页编号。查询指定“task_id”时,该参数无效。

默认值:0。

O

size

Integer

每页记录数。查询指定“task_id”时,该参数无效。

取值范围:[1,100]。

默认值:10。

O

请求样例

GET /v1/{project_id}/transcodings?task_id=100211&task_id=100213&status=SUCCEEDED&start_time=20190508120934&end_time=20190508120949&page=0&size=10

返回参数

  • 查询成功时返回
    表2 查询成功返回参数说明

    参数

    类型

    说明

    task_array

    Array of TaskInfo objects

    具体的转码任务查询结果的列表

    is_truncated

    Integer

    查询结果是否被截取。

    取值如下:
    • 1:表示被截取,即还有结果未被返回,可以通过设置page和size参数继续查询。
    • 0:表示未被截取,即所有结果已被返回。

    默认值:0。

    total

    Integer

    查询结果的数量。

    表3 TaskInfo参数说明

    参数

    类型

    说明

    task_id

    String

    任务ID。

    status

    String

    任务执行状态。

    取值如下:

    • WAITING:等待启动。
    • TRANSCODING:转码中。
    • SUCCEEDED:转码成功。
    • FAILED:转码失败。
    • CANCELED:已删除。
    • NEED_TO_BE_AUDIT:片源待审核。

    create_time

    String

    转码任务启动时间。

    end_time

    String

    转码任务结束时间。

    trans_template_id

    Array of integers

    转码任务对应的转码模板,可能包含多个。

    input

    file_addr object

    源文件的存储地址。

    output

    file_addr object

    转码文件的输出地址。

    description

    String

    转码任务描述,当转码任务出现异常时,此字段显示异常的原因。

    tips

    String

    转码成功,当音频采样率过低时的提示。

    output_url

    String

    质检文件输出路径。

    output_file_name

    Array of strings

    转码生成的文件名,数组类型,可能包含多个。

    transcode_detail

    TranscodeDetail object

    转码任务的额外信息。

    thumbnail_output

    file_addr object

    截图的输出信息。

    thumbnail_outputname

    String

    截图压缩包名。

    pic_info

    Array of PicInfo objects

    截图文件信息。

    表4 file_addr参数说明

    参数

    类型

    说明

    bucket

    String

    文件所在桶名。

    location

    String

    桶所在的区域名, 如“华北-北京四”的区域名为“cn-north-4”

    object

    String

    文件的存储路径。

    表5 TranscodeDetail参数说明

    参数

    类型

    说明

    multitask_info

    Array of MultiTaskInfo objects

    一进多出情况下部分转码失败的情况。

    input_file

    SourceInfo object

    片源信息。

    表6 MultiTaskInfo参数说明

    参数

    类型

    说明

    template_id

    Integer

    转码模板ID。

    error

    Error object

    转码失败的错误信息。

    output_file

    SourceInfo object

    单路输出信息。

    表7 SourceInfo参数说明

    参数

    类型

    说明

    duration

    Integer

    文件时长。

    format

    String

    文件格式。

    size

    Integer

    文件大小。

    单位: KB。

    video_info

    VideoInfo object

    视频信息。

    audio_info

    Array of AudioInfo objects

    音频信息,多音轨情况有多个AudioInfo信息。

    表8 VideoInfo参数说明

    参数

    类型

    说明

    width

    Integer

    视频宽度。

    height

    Integer

    视频高度。

    bitrate

    Integer

    视频码率。

    frame_rate

    Integer

    视频帧率。

    codec

    String

    视频编码格式

    表9 AudioInfo参数说明

    参数

    类型

    说明

    codec

    String

    音频编码格式。

    sample_rate

    Integer

    音频采用率。

    channels

    Integer

    音频声道数。

    bitrate

    Integer

    音频码率。

    表10 PicInfo参数说明

    参数

    类型

    说明

    pic_name

    String

    截图的文件名。

  • 查询失败时返回
    表11 查询失败返回参数说明

    参数

    类型

    说明

    error_code

    String

    错误码。

    error_msg

    String

    错误描述。

返回样例

  • 处理成功返回(200 OK)
    {
      "task_array": [
        {
          "task_id": "48302",
          "status": "SUCCEEDED",
          "create_time": "20190508120934",
          "end_time": "20190508120949",
          "trans_template_id": [
            7000476
          ],
          "input": {
            "bucket": "mpc-test-04",
            "location": "cn-north-4",
            "object": "test/a.flv"
          },
          "output": {
            "bucket": "mpc-test-05",
            "location": "cn-north-4",
            "object": "666/test"
          },
          "output_file_name": [
            "index.mpd"
          ],
          "description": null,
          "tips": null,
          "output_url": null,
          "transcode_detail": {
            "multitask_info": [
              {
                "template_id": 7000476,
                "error": null,
                "output_file": {
                  "duration": 135,
                  "format": "DASH",
                  "size": 9582,
                  "video_info": {
                    "width": 270,
                    "height": 480,
                    "bitrate": 561,
                    "frame_rate": 0,
                    "codec": "H264"
                  },
                  "audio_info": [
                    {
                      "codec": "HEAAC",
                      "sample": 44100,
                      "channels": 2,
                      "bitrate": 64
                    }
                  ]
                }
              }
            ],
            "input_file": {
              "duration": 135,
              "format": "FLV",
              "size": 4729901,
              "video_info": {
                "width": 360,
                "height": 640,
                "bitrate": 240,
                "frame_rate": 15166,
                "codec": "H264"
              },
              "audio_info": [
                {
                  "codec": "ACC",
                  "sample": 44100,
                  "channels": 2,
                  "bitrate": 32
                }
              ]
            }
          },
          "thumbnail_output": null,
          "thumbnail_outputname": null,
          "pic_info": []
        },
        ...      
      ],
      "is_truncated": 1,
      "total": 2
    }
  • 处理失败返回(500 Internal Server Error)
    {
      "error_code": "MPC.10200",
      "error_msg": "系统问题,请联系华为工程师解决。"
    }

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区