AI 助理
文档备案控制台
官方文档
首页 智能媒体服务 开发参考 API参考 API目录 媒体处理 媒体信息接口 ListMediaInfoJobs - 查询媒体信息任务列表

ListMediaInfoJobs - 查询媒体信息任务列表

更新时间：
复制 MD 格式
产品详情
我的收藏

查询媒体信息任务列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:ListMediaInfoJobs

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
StartOfCreateTime

string

否

任务创建时间筛选条件的起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ。

2022-07-01T00:00:00Z
EndOfCreateTime

string

否

任务创建时间筛选条件的结束时间。格式为：yyyy-MM-ddTHH:mm:ssZ。

2022-07-15T00:00:00Z
JobId

string

否

按 jobId 筛选。

7b38a5d86f1e47838927b6e7ccb1****
Status

string

否

任务状态

  • Init: 已提交,

  • Success: 成功,

  • Fail: 失败

Success
OrderBy

string

否

排序顺序。目前只支持两种：

  • CreateTimeDesc：按创建时间降序

  • CreateTimeAsc：按创建时间升序

CreateTimeDesc
PageSize

integer

否

分页大小 default 10。

10
NextPageToken

string

否

连续分页查询时下一页的标记 （第一页没有）。

ab4802364a2e49208c99efab82df****

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

31E30781-9495-5E2D-A84D-759B0A01E262
Jobs

array<object>

媒体信息任务列表。

array<object>

任务详情。

Name

string

任务名字。

job-name
TriggerSource

string

任务来源。

  • API：API

  • WorkFlow：工作流

  • Console：控制台

API
JobId

string

任务 ID。

ab4802364a2e49208c99efab82df****
Input

object

任务输入。

Type

string

媒体对象类型。 取值：

  • OSS: OSS 文件。

  • Media: 媒资 ID。

OSS
Media

string

媒体值：

  • type 为 OSS 时，为 URL, 支持 OSS 协议和 HTTP 协议；

  • type 为 Media 时，为媒资 ID。

oss://bucket/path/to/video.mp4
Async

boolean

是否异步处理。

true
UserData

string

用户数据。

user-data
ScheduleConfig

object

调度信息。

PipelineId

string

管道 ID。

e37ebee5d98b4781897f6086e89f****
Priority

integer

任务优先级。数字越大优先级越高，取值范围：1~10

5
Status

string

任务状态

  • Init: 已提交,

  • Success: 成功,

  • Fail: 失败

Init
SubmitResultJson

object

任务提交信息。

MediaInfoProperty

object

媒体信息详情。

FileBasicInfo

object

基础文件信息。

MediaId

string

媒资 ID。

4765337007f571edbfdf81848c01****
FileName

string

文件名。

file.m3u8
FileStatus

string

文件状态。

Normal
FileType

string

文件类型。取值：

  • source_file：源文件

  • transcode_file：转码文件

source_file
FileSize

string

文件大小。单位：Byte。

31737
FileUrl

string

文件 URL。

http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8
Region

string

文件所在区域。

cn-shanghai
FormatName

string

视频格式名称。

hls,applehttp
Duration

string

视频时长（单位：秒）。

403.039999
Bitrate

string

视频码率。

888.563
Width

string

宽。

848
Height

string

高。

478
AudioStreamInfoList

array<object>

音频流信息。

object

音频流信息。

Index

string

流序号。

1
CodecName

string

编码格式。

aac
CodecLongName

string

编码格式名。

AAC (Advanced Audio Coding)
CodecTimeBase

string

编码器时间基。

1/44100
CodecTagString

string

编码器标签名。

[15][0][0][0]
CodecTag

string

编码器标签。

0x000f
SampleFmt

string

采样格式。

fltp
SampleRate

string

采样率（单位：Hz）。

44100
Channels

string

声道数。

2
ChannelLayout

string

声道布局。

stereo
Timebase

string

时间基。

1/90000
StartTime

string

开始时间。

1.473556
Duration

string

时长（单位：秒）。

403.039989
Bitrate

string

码率。

0.f
Lang

string

语言。

cn
VideoStreamInfoList

array<object>

视频流信息。

object

视频流信息。

Index

string

流序号。

0
Codec_name

string

编码格式。

h264
Codec_long_name

string

编码格式名。

H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile

string

编码器预设。

High
Codec_time_base

string

编码时基。

1/50
Codec_tag_string

string

编码格式标记文本。

[27][0][0][0]
Codec_tag

string

编码格式标记。

0x001b
Width

string

宽。

848
Height

string

高。

478
Has_b_frames

string

是否有 B 帧。 取值：

  • 0：没有 B 帧,

  • 1：有一个 B 帧,

  • 2：有多个连续 B 帧。

2
Sar

string

采集点数宽高比。

478:477
Dar

string

图像显示宽高比。

16:9
PixFmt

string

颜色存储格式。

yuv420p
Level

string

编码等级。

31
Fps

string

帧率。

25.0
Avg_fps

string

平均帧率。

25.0
Time_base

string

时基。

1/90000
Start_time

string

起始时间。

1.473556
Duration

string

时长（单位：秒）。

403.039989
Bit_rate

string

码率。

888.563
NumFrames

string

总帧数。

10040
Lang

string

语言。

cn
Rotate

string

视频画面旋转角度。

  • 取值 0, 90, 180, 270。

  • 默认值 0

0
SubmitTime

string

任务提交时间。格式为：yyyy-MM-ddTHH:mm:ssZ 。

2022-01-12T08:49:41Z
FinishTime

string

任务完成时间。格式为：yyyy-MM-ddTHH:mm:ssZ 。

2022-01-12T08:49:41Z
RequestId

string

请求 ID。

4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168
NextPageToken

string

下一页标识，第一次提交时为空即可。下一页标识将在第一次查询后返回。

019daf5780f74831b0e1a767c9f1c178

示例

正常返回示例

JSON格式

{
  "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
  "Jobs": [
    {
      "Name": "job-name",
      "TriggerSource": "API",
      "JobId": "ab4802364a2e49208c99efab82df****",
      "Input": {
        "Type": "OSS",
        "Media": "oss://bucket/path/to/video.mp4"
      },
      "Async": true,
      "UserData": "user-data",
      "ScheduleConfig": {
        "PipelineId": "e37ebee5d98b4781897f6086e89f****",
        "Priority": 5
      },
      "Status": "Init",
      "SubmitResultJson": {
        "test": "test",
        "test2": 1
      },
      "MediaInfoProperty": {
        "FileBasicInfo": {
          "MediaId": "4765337007f571edbfdf81848c01****",
          "FileName": "file.m3u8",
          "FileStatus": "Normal",
          "FileType": "source_file",
          "FileSize": "31737",
          "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
          "Region": "cn-shanghai",
          "FormatName": "hls,applehttp",
          "Duration": "403.039999",
          "Bitrate": "888.563",
          "Width": "848",
          "Height": "478"
        },
        "AudioStreamInfoList": [
          {
            "Index": "1",
            "CodecName": "aac",
            "CodecLongName": "AAC (Advanced Audio Coding)",
            "CodecTimeBase": "1/44100",
            "CodecTagString": "[15][0][0][0]",
            "CodecTag": "0x000f",
            "SampleFmt": "fltp",
            "SampleRate": "44100",
            "Channels": "2",
            "ChannelLayout": "stereo",
            "Timebase": "1/90000",
            "StartTime": "1.473556",
            "Duration": "403.039989",
            "Bitrate": "0.f",
            "Lang": "cn"
          }
        ],
        "VideoStreamInfoList": [
          {
            "Index": "0",
            "Codec_name": "h264",
            "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
            "Profile": "High",
            "Codec_time_base": "1/50",
            "Codec_tag_string": "[27][0][0][0]",
            "Codec_tag": "0x001b",
            "Width": "848",
            "Height": "478",
            "Has_b_frames": "2",
            "Sar": "478:477",
            "Dar": "16:9",
            "PixFmt": "yuv420p",
            "Level": "31",
            "Fps": "25.0",
            "Avg_fps": "25.0",
            "Time_base": "1/90000",
            "Start_time": "1.473556",
            "Duration": "403.039989",
            "Bit_rate": "888.563",
            "NumFrames": "10040",
            "Lang": "cn",
            "Rotate": "0"
          }
        ]
      },
      "SubmitTime": "2022-01-12T08:49:41Z",
      "FinishTime": "2022-01-12T08:49:41Z",
      "RequestId": "4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168"
    }
  ],
  "NextPageToken": "019daf5780f74831b0e1a767c9f1c178"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。

上一篇：GetMediaInfoJob - 媒体信息任务查询下一篇：实时处理