全部产品
Search
文档中心

媒体处理:QueryMediaInfoJobList - 查询媒体信息作业信息

更新时间:Sep 27, 2024

查询媒体信息作业。

接口说明

  • 异步模式需要等到提交媒体信息作业的 MNS 回调成功后才能查询到媒体信息。如果长时间查询不到媒体信息,可能是提交媒体信息作业执行失败。
  • 本接口一次最多可查询 10 个媒体信息作业。
  • 本接口返回值默认按 CreationTime 降序排列。

QPS 限制

本接口的单用户 QPS 限制为 100 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见 QPS 限制

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
mts:QueryMediaInfoJobListget
  • 全部资源
    *

请求参数

名称类型必填描述示例值
MediaInfoJobIdsstring

媒体信息作业 ID。

  • 一次最多查询 10 个,使用半角逗号(,)分隔。
  • 可以从提交媒体信息作业的返回参数中获取。
说明 如果不传入此参数,则会返回 InvalidParameter(参数无效)错误码。
23ca1d184c0e4341e5b665e2a12****

返回参数

名称类型描述示例值
object
NonExistMediaInfoJobIdsarray

不存在的媒体信息作业。

Stringstring

不存在的媒体信息作业 ID 列表,无数据时不返回该参数。

11ce1d184c0e4341e5b665e2a12****
RequestIdstring

请求 ID。

46A04AA5-B119-41BB-B750-7C5327AC3E7A
MediaInfoJobListarray<object>

媒体信息作业列表。

MediaInfoJobobject
CreationTimestring

作业添加时间。

2014-01-10T12:00:00Z
Statestring

作业状态。

  • Analyzing:分析中。
  • Success:分析成功。
  • Fail:分析失败。
Success
JobIdstring

元信息分析作业 ID。

23ca1d184c0e4341e5b665e2a12****
UserDatastring

用户自定义数据。

testid-001
Codestring

元信息分析失败时错误码。

InvalidParameter.JsonObjectFormatInvalid
Messagestring

元信息分析失败时错误信息。

The parameter ”*” does not conform to the JSON Object specification
PipelineIdstring

管道 ID。

88c6ca184c0e432bbf5b665e2a15****
Asyncboolean

是否为异步作业。

true
Inputobject

作业输入。

Objectstring

OSS 的 Object。

example.mp4
Locationstring

OSS 的服务区域。

oss-cn-hangzhou
Bucketstring

输入文件的 OSS Bucket。

example-bucket
MNSMessageResultobject

MNS 通知用户作业完成的消息结果。

MessageIdstring

成功时消息 ID。如果失败则不返回此参数。

123
ErrorMessagestring

失败时错误信息。如果成功则不返回此参数。

The parameter \"Input\" does not conform to the JSON Object specification
ErrorCodestring

失败时错误码。如果成功则不返回此参数。

InvalidParameter.JsonObjectFormatInvalid
Propertiesobject

媒体详细属性。更多信息请参见数据类型 AliyunProperties

Widthstring

视频像素宽。

1280
Heightstring

视频像素长。

720
Durationstring

时长。

17.226000
Fpsstring

帧率。

25
Bitratestring

码率。

1630.045
FileFormatstring

文件格式。

QuickTime/MOV
Streamsobject

流信息。

VideoStreamListarray<object>

视频流信息列表。

VideoStreamobject
Sarstring

编码信号分辨率比。

1:1
Heightstring

视频分辨率长。

1080
CodecTagStringstring

编码格式标记文本。

[0][0][0][0]
NetworkCostobject

网络带宽消耗。

PreloadTimestring

预加载时间。

8
AvgBitratestring

平均码率。

300.34
CostBandwidthstring

最大消耗带宽。

10
Widthstring

视频分辨率宽。

1920
Indexstring

视频流序号,标识视频流在整个媒体流中的位置。

1
Timebasestring

时基。

1/1000
AvgFPSstring

平均帧率。

23.976025
PixFmtstring

像素格式。

yuv420p
Langstring

语言。

eng
CodecLongNamestring

编码格式长述名。

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

总帧数。

100
Rotatestring

视频旋转角度。

180
Bitratestring

码率。

30541090
HasBFramesstring

是否有 B 帧。0 表示无,1 表示有。

0
Profilestring

编码预置。

High
StartTimestring

起始时间。

0.042000
Darstring

编码显示分辨率比。

16:9
CodecNamestring

编码格式简述名。可选值:

  • h264

  • h265

  • gif

  • webp

h264
Durationstring

时长。

100
Fpsstring

帧率。

25
CodecTagstring

编码格式标记。

0x0000
CodecTimeBasestring

编码时基。

1001/48000
Levelstring

编码等级。

41
ColorRangestring

色彩范围。

700
ColorTransferstring

色彩通道。

R255 G83 B170
ColorPrimariesstring

色原。

700
AudioStreamListarray<object>

音频流信息列表。

AudioStreamobject
Timebasestring

时基。

1/1000
Indexstring

音频流序号,标识音频流在整个媒体流中的位置。

1
SampleFmtstring

采样格式。

fltp
ChannelLayoutstring

声道数。

5.1(side)
Langstring

语言。更多信息请参见 FFmpeg 语言定义

eng
Sampleratestring

采样率。

48000
CodecLongNamestring

编码格式长述名。

DCA (DTS Coherent Acoustics)
Channelsstring

声道输出样式。

2
NumFramesstring

总帧数。

123
Bitratestring

码率。

1536000
CodecTagStringstring

编码格式标记文本。

[0][0][0][0]
StartTimestring

起始时间。

0.042000
CodecNamestring

编码格式简述名。可取值:

  • acc

  • mp3

  • mp4

  • ogg

  • flac

acc
Durationstring

时长。

123
CodecTagstring

编码格式标记。

0x0000
CodecTimeBasestring

编码时基。

1/48000
SubtitleStreamListarray<object>

字幕流信息列表。

SubtitleStreamobject
Timebasestring

时基。

1/1000
Indexstring

字幕流序号,标识字幕流在整个媒体流中的位置。

3
StartTimestring

起始时间。

0.000000
CodecNamestring

编码格式简述名。可选值:

  • srt

  • ass

ass
Langstring

语言。

eng
CodecLongNamestring

编码格式长述名。

ASS (Advanced SSA) subtitle
Durationstring

时长,单位秒(s)。

1370.116000
CodecTagstring

编码格式标记。

0x0000
CodecTimeBasestring

编码时基。

0/1
CodecTagStringstring

编码格式标记文本。

[0][0][0][0]
Formatobject

格式信息。

StartTimestring

起始时间。

0.042000
NumProgramsstring

节目流总数。

2
Sizestring

文件大小。

3509895
NumStreamsstring

媒体流总数。

1
FormatLongNamestring

容器、封装格式长述名。

QuickTime/MOV
Durationstring

总时长。

17.226000
Bitratestring

总码率。

1630.045
FormatNamestring

容器、封装格式简述名。

mov
FileSizestring

文件大小。

3509895

回调消息格式定义

当媒体信息任务执行状态改变时,mps 会发送消息到用户指定的 queue 中(如何指定回调 queue 详见 mps 的更新管道接口)。消息体是一个 JSON 字符串,包含字段如下:

{
  "Type": "MediaInfo",
  "State": "Success",
  "JobId": "bb558c1cc25b45309aab5be44d19****",
  "UserData": "{\"key\":\"value\"}",
  "RequestId": "B52658D4-07AB-43CD-82B0-210958A6****"
}
名称类型描述
TypeString固定字符串“MediaInfo”,表示媒体信息任务。
JobIdString任务唯一 ID。
StateString任务当前状态,与 QueryMediaInfoJobList 中的 State 一致。
UserDataString用户在 SubmitMediaInfoJob 中传入的 UserData。

示例

正常返回示例

JSON格式

{
  "NonExistMediaInfoJobIds": {
    "String": [
      "11ce1d184c0e4341e5b665e2a12****"
    ]
  },
  "RequestId": "46A04AA5-B119-41BB-B750-7C5327AC3E7A",
  "MediaInfoJobList": {
    "MediaInfoJob": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "State": "Success",
        "JobId": "23ca1d184c0e4341e5b665e2a12****",
        "UserData": "testid-001",
        "Code": "InvalidParameter.JsonObjectFormatInvalid",
        "Message": "The parameter ”*” does not conform to the JSON Object specification",
        "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
        "Async": true,
        "Input": {
          "Object": "example.mp4",
          "Location": "oss-cn-hangzhou",
          "Bucket": "example-bucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "The parameter \\\"Input\\\" does not conform to the JSON Object specification",
          "ErrorCode": "InvalidParameter.JsonObjectFormatInvalid"
        },
        "Properties": {
          "Width": "1280",
          "Height": "720",
          "Duration": "17.226000",
          "Fps": "25",
          "Bitrate": "1630.045",
          "FileFormat": "QuickTime/MOV",
          "Streams": {
            "VideoStreamList": {
              "VideoStream": [
                {
                  "Sar": "1:1",
                  "Height": "1080",
                  "CodecTagString": "[0][0][0][0]",
                  "NetworkCost": {
                    "PreloadTime": "8",
                    "AvgBitrate": "300.34",
                    "CostBandwidth": "10"
                  },
                  "Width": "1920",
                  "Index": "1",
                  "Timebase": "1/1000",
                  "AvgFPS": "23.976025",
                  "PixFmt": "yuv420p",
                  "Lang": "eng",
                  "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
                  "NumFrames": "100",
                  "Rotate": "180",
                  "Bitrate": "30541090",
                  "HasBFrames": "0",
                  "Profile": "High",
                  "StartTime": "0.042000",
                  "Dar": "16:9",
                  "CodecName": "h264",
                  "Duration": "100",
                  "Fps": "25",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "1001/48000",
                  "Level": "41",
                  "ColorRange": "700",
                  "ColorTransfer": "R255 G83 B170",
                  "ColorPrimaries": "700"
                }
              ]
            },
            "AudioStreamList": {
              "AudioStream": [
                {
                  "Timebase": "1/1000",
                  "Index": "1",
                  "SampleFmt": "fltp",
                  "ChannelLayout": "5.1(side)",
                  "Lang": "eng",
                  "Samplerate": "48000",
                  "CodecLongName": "DCA (DTS Coherent Acoustics)",
                  "Channels": "2",
                  "NumFrames": "123",
                  "Bitrate": "1536000",
                  "CodecTagString": "[0][0][0][0]",
                  "StartTime": "0.042000",
                  "CodecName": "acc",
                  "Duration": "123",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "1/48000"
                }
              ]
            },
            "SubtitleStreamList": {
              "SubtitleStream": [
                {
                  "Timebase": "1/1000",
                  "Index": "3",
                  "StartTime": "0.000000",
                  "CodecName": "ass",
                  "Lang": "eng",
                  "CodecLongName": "ASS (Advanced SSA) subtitle",
                  "Duration": "1370.116000",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "0/1",
                  "CodecTagString": "[0][0][0][0]"
                }
              ]
            }
          },
          "Format": {
            "StartTime": "0.042000",
            "NumPrograms": "2",
            "Size": "3509895",
            "NumStreams": "1",
            "FormatLongName": "QuickTime/MOV",
            "Duration": "17.226000",
            "Bitrate": "1630.045",
            "FormatName": "mov"
          },
          "FileSize": "3509895"
        }
      }
    ]
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
2021-05-17新增 OpenAPI查看变更详情