遍历转码作业。
接口说明
- 本接口返回结果默认按 CreationTime 降序排列。
- 本接口最多返回最近 90 天的任务,小于 90 天的按实际设置时间返回。
- 您可以通过设置作业状态、创建时间区间、转码管道等请求参数筛选查询结果。
- 媒体处理默认同一账号不同地域数据不互通,调用接口前请确认您传入的地域信息与待查询文件地域一致,否则可能导致接口调用失败或信息不一致。
QPS 限制
本接口的单用户 QPS 限制为 100 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见 QPS 限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
mts:ListJob | get |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
NextPageToken | string | 否 | 下一页标识。第一次请求无需传入,服务会返回,第二次请求传入即可。 | 16f01ad6175e4230ac42bb5182cd**** |
MaximumPageSize | long | 否 | 单页最大可返回媒体工作流执行实例。
| 10 |
State | string | 否 | 转码任务状态。默认为 All(所有状态)。可取值:
| All |
StartOfJobCreatedTimeRange | string | 否 | 创建转码作业时间范围中的下限值。日期格式按照 ISO8601 标准表示,并需要使用 UTC 时间。格式为: | 2014-01-10T12:00:00Z |
EndOfJobCreatedTimeRange | string | 否 | 创建转码作业时间的上限。日期格式按照 ISO8601 标准表示,并需要使用 UTC 时间。格式为: | 2014-01-11T12:00:00Z |
PipelineId | string | 否 | 管道 ID。可以通过 MPS 控制台 > 全局设置 > 管道及回调查询。 | 88c6ca184c0e424d5w5b665e2a12**** |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "BC860F04-778A-472F-AB39-E1BF329C1EA8",
"NextPageToken": "16f01ad6175e4230ac42bb5182cd****",
"JobList": {
"Job": [
{
"CreationTime": "2014-01-10T12:00:00Z",
"Percent": 100,
"FinishTime": "2014-01-10T12:20:25Z",
"State": "TranscodeSuccess",
"JobId": "31fa3c9ca8134fb4b0b0f7878301****",
"Code": "InternalError",
"Message": "The operation has failed due to some unknown error, exception or failure.",
"Output": {
"Video": {
"Bufsize": "6000",
"Degrain": "5",
"BitrateBnd": {
"Max": "1000",
"Min": "200"
},
"PixFmt": "yuv420p",
"Pad": "1280:800:0:140",
"Codec": "H.264",
"Height": "720",
"Qscale": "15",
"Crop": "border",
"Bitrate": "428",
"Maxrate": "1000",
"MaxFps": "60",
"Profile": "high",
"Crf": "26",
"Gop": "250",
"Width": "1280",
"Fps": "25",
"Preset": "medium",
"ScanMode": "interlaced",
"ResoPriority": "1"
},
"TransConfig": {
"IsCheckAudioBitrate": "false",
"TransMode": "onepass",
"IsCheckReso": "false",
"IsCheckVideoBitrateFail": "false",
"AdjDarMethod": "none",
"IsCheckVideoBitrate": "false",
"IsCheckResoFail": "false",
"IsCheckAudioBitrateFail": "false"
},
"Encryption": {
"Type": "hls-aes-128",
"Key": "encryptionkey128",
"KeyType": "Base64",
"Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
"KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
"SkipCnt": "3"
},
"WaterMarkList": {
"WaterMark": [
{
"Type": "Image",
"ReferPos": "TopRight",
"Dx": "100",
"Width": "50",
"Height": "50",
"InputFile": {
"Object": "example-logo-****.png",
"Location": "oss-cn-hangzhou",
"Bucket": "example-bucket"
},
"WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
"Dy": "100"
}
]
},
"WaterMarkConfigUrl": "http://example.com/configure",
"DeWatermark": "{\"0\": [{\"l\": 10,\"t\": 10,\"w\": 10,\"h\": 10},{\"l\": 100,\"t\": 0.1,\"w\": 10,\"h\": 10}],\"128000\": [],\"250000\": [{\"l\": 0.2,\"t\": 0.1,\"w\": 0.01,\"h\": 0.05}]}",
"M3U8NonStandardSupport": {
"TS": {
"SizeSupport": true,
"Md5Support": true
}
},
"Priority": "6",
"Audio": {
"Profile": "aaclow",
"Codec": "aac",
"Samplerate": "44100",
"Qscale": "15",
"Channels": "2",
"Volume": {
"Method": "auto",
"Level": "-20"
},
"Bitrate": "128"
},
"AudioStreamMap": "0:a:0",
"MergeList": {
"Merge": [
{
"Start": "01:59:59.999或者32000.23",
"RoleArn": "acs:ram::<your uid>:role/<your role name>",
"MergeURL": "http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv",
"Duration": "01:59:59.999"
}
]
},
"SuperReso": {
"IsHalfSample": "true"
},
"UserData": "test-001",
"OutSubtitleList": {
"OutSubtitle": [
{
"Map": "0:v:0",
"OutSubtitleFile": {
"RoleArn": "acs:ram::<your uid>:role/<your role name>",
"Object": "example-output.flv",
"Location": "oss-cn-hangzhou",
"Bucket": "example-bucket-****"
},
"Success": true,
"Message": "The specified parameter “%s” cannot be null."
}
]
},
"VideoStreamMap": "0:a:0",
"OutputFile": {
"RoleArn": "acs:ram::<your uid>:role/<your role name>",
"Object": "example-output.flv",
"Location": "oss-cn-hangzhou",
"Bucket": "example-bucket"
},
"Rotate": "90",
"Container": {
"Format": "flv"
},
"Clip": {
"TimeSpan": {
"Seek": "01:00:59.999",
"Duration": "01:00:59.999"
}
},
"MergeConfigUrl": "{\"MergeList\":[{\"MergeURL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4\"}]}",
"OpeningList": {
"Opening": [
{
"openUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv",
"Start": "0",
"Width": "-1",
"Height": "-1"
}
]
},
"MuxConfig": {
"Webp": {
"Loop": "0"
},
"Gif": {
"FinalDelay": "0",
"DitherMode": "bayer",
"Loop": "0",
"IsCustomPalette": "true"
},
"Segment": {
"Duration": "10"
}
},
"TailSlateList": {
"TailSlate": [
{
"Start": "1",
"BgColor": "White",
"IsMergeAudio": true,
"Width": "-1",
"Height": "-1",
"BlendDuration": "0",
"TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
}
]
},
"TemplateId": "S00000000-000010",
"SubtitleConfig": {
"ExtSubtitleList": {
"ExtSubtitle": [
{
"CharEnc": "auto",
"FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
"Input": {
"Object": "example-output.flv",
"Location": "oss-cn-hangzhou",
"Bucket": "example-bucket-****"
}
}
]
},
"SubtitleList": {
"Subtitle": [
{
"Map": "0"
}
]
}
},
"Properties": {
"Width": "720",
"Height": "1280",
"Duration": "17",
"Fps": "30",
"Bitrate": "490",
"FileFormat": "mp4",
"Streams": {
"VideoStreamList": {
"VideoStream": [
{
"Index": "0",
"Timebase": "1/15360",
"AvgFPS": "30.0",
"PixFmt": "yuv420p",
"Sar": "1:1",
"Lang": "und",
"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"Height": "1280",
"NumFrames": "30",
"Bitrate": "421.117",
"CodecTagString": "avc1",
"HasBFrames": "2",
"Profile": "high",
"StartTime": "0.000000",
"NetworkCost": {
"PreloadTime": "8",
"AvgBitrate": "300",
"CostBandwidth": "10"
},
"Dar": "9:16",
"CodecName": "h264",
"Width": "720",
"Duration": "17.233333",
"Fps": "30.0",
"CodecTag": "0x31637661",
"CodecTimeBase": "1/60",
"Level": "31"
}
]
},
"AudioStreamList": {
"AudioStream": [
{
"Timebase": "1/32000",
"Index": "1",
"SampleFmt": "fltp",
"ChannelLayout": "mono",
"Lang": "und",
"Samplerate": "32000",
"CodecLongName": "AAC (Advanced Audio Coding)",
"Channels": "1",
"NumFrames": "30",
"Bitrate": "64.136",
"CodecTagString": "mp4a",
"StartTime": "0.000000",
"CodecName": "aac",
"Duration": "17.223562",
"CodecTag": "0x6134706d",
"CodecTimeBase": "1/32000"
}
]
},
"SubtitleStreamList": {
"SubtitleStream": [
{
"Index": "1",
"Lang": "und"
}
]
}
},
"Format": {
"StartTime": "0.064000",
"NumPrograms": "0",
"Size": "1057273",
"NumStreams": "2",
"FormatLongName": "QuickTime / MOV",
"Duration": "17.234000",
"Bitrate": "490.784",
"FormatName": "mov"
},
"FileSize": "1057273"
}
},
"PipelineId": "88c6ca184c0e47b665e2a1267971****",
"Input": {
"Object": "example.flv",
"Location": "oss-cn-hangzhou",
"Bucket": "example-bucket"
},
"MNSMessageResult": {
"MessageId": "123",
"ErrorMessage": "The resource operated “%s” cannot be found.",
"ErrorCode": "InvalidParameter.ResourceNotFound"
}
}
]
}
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|
暂无变更历史