调用QueryAnalysisJobList查询模板分析作业。
使用说明
本接口一次最多可查询10个模板分析作业。
QPS限制
本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | QueryAnalysisJobList |
操作接口名,系统规定参数,取值:QueryAnalysisJobList。 |
AnalysisJobIds | String | 是 | bb558c1cc25b45309aab5be44d19**** |
模板分析作业ID列表。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 5CA6E020-4102-4FFF-AA56-5ED7ECD811A1 |
请求ID。 |
AnalysisJobList | Array of AnalysisJob |
模板分析作业列表。 |
|
AnalysisJob | |||
CreationTime | String | 2014-01-10T12:00:00Z |
作业添加时间。 |
Percent | Long | 86 |
转码进度。 |
State | String | Success |
作业状态。
|
AnalysisConfig | Object |
作业配置。 |
|
QualityControl | Object |
输出质量控制。 |
|
MethodStreaming | String | network |
播放方式。
|
RateQuality | String | 25 |
输出质量等级。默认值:25。 |
PropertiesControl | Object |
属性控制。 |
|
Deinterlace | String | Auto |
强制扫描模式判定。
|
Crop | Object |
视频裁切配置。 |
|
Top | String | 8 |
裁切上边距。 说明 如果Mode为Auto或None,则此值失效。
|
Width | String | 8 |
裁切后宽。 说明 如果Mode为Auto或None,则此值失效。
|
Height | String | 8 |
裁切后高。 说明 如果Mode为Auto或None,则此值失效。
|
Left | String | 8 |
裁切左边距。 说明 如果Mode为Auto或None,则此值失效。
|
Mode | String | Auto |
裁切方式。取值:
|
Message | String | The resource operated \"PipelineId\" cannot be found |
分析失败时错误信息。 |
Priority | String | 8 |
任务在其对应管道内的优先级。
|
MNSMessageResult | Object |
MNS通知用户作业完成的结果。 |
|
MessageId | String | 3ca84a39a9024f19853b21be9cf9**** |
成功时消息ID。分析失败时不返回此参数。 |
ErrorMessage | String | The resource operated \"PipelineId\" cannot be found |
失败时错误信息。分析成功时不返回此参数。 |
ErrorCode | String | InvalidParameter.ResourceNotFound |
失败时错误码。分析成功时不返回此参数。 |
TemplateList | Array of Template |
作业输出的预置模板列表。 |
|
Template | |||
Video | Object |
视频编解码配置。 |
|
Bufsize | String | 6000 |
缓冲区大小。
|
Degrain | String | 5 |
独立去噪算法强度。 |
BitrateBnd | Object |
视频平均码率范围。 |
|
Max | String | 1500 |
总码率上限。单位:Kbps。 |
Min | String | 800 |
总码率下限。单位:Kbps。 |
PixFmt | String | yuv420p |
视频颜色格式。包含yuv420p,yuvj420p等标准颜色格式。 |
Codec | String | H.264 |
编解码格式。支持H.264、H.265。 默认值:H.264。 |
Height | String | 720 |
视频高。
|
Qscale | String | 15 |
视频质量控制度。 |
Bitrate | String | 1000 |
视频平均码率。单位:Kbps。 |
Maxrate | String | 2000 |
视频码率峰值。
|
Profile | String | high |
编码级别。
|
Crf | String | 26 |
码率-质量控制因子。
|
Gop | String | 250 |
关键帧间最大帧数。默认值:250。 |
Width | String | 1280 |
视频宽。
|
Fps | String | 25 |
帧率。
|
Preset | String | medium |
视频算法器预置。支持veryfast(超快)、fast(快)、medium(中等)、slow(慢)、slower(超慢)。 默认值:medium。 |
ScanMode | String | interlaced |
扫描模式。取值:
|
TransConfig | Object |
转码通用配置。 |
|
TransMode | String | onepass |
转码模式。默认值:onepass。可选范围:
|
State | String | Normal |
模板的状态。
|
MuxConfig | Object |
转码封包配置。 |
|
Gif | Object |
gif格式。 |
|
FinalDelay | String | 0 |
gif的loop间隔,单位为百分之一秒,比如500代表间隔为5秒。 |
Loop | String | 0 |
gif与webp循环次数,默认不循环。 |
Segment | Object |
切片配置。 |
|
Duration | String | 10 |
分片时长。单位:秒。 |
Name | String | FLV-UD |
模板名称。 |
Audio | Object |
音频编解码配置。 |
|
Profile | String | aac_low |
音频编码预置。当Codec为aac时可取值:
|
Codec | String | aac |
音频编解码格式。默认值:aac。可取值:
|
Samplerate | String | 44100 |
采样率。
|
Qscale | String | 15 |
音频质量控制度。 |
Channels | String | 2 |
声道数。默认值:2。 |
Bitrate | String | 128 |
输出文件的音频码率。
|
Id | String | S00000000-00**** |
转码模板ID。 |
Container | Object |
容器。 |
|
Format | String | flv |
容器格式。 |
UserData | String | testid-001 |
用户自定义数据。 |
Code | String | InvalidParameter.ResourceNotFound |
分析失败时错误码。 |
InputFile | Object |
作业输入。 |
|
Object | String | example.flv |
OSS的Object。 |
Location | String | oss-cn-hangzhou |
OSS的服务区域。 |
Bucket | String | example-bucket |
输入文件的OSS Bucket。 |
PipelineId | String | bb558c1cc25b45309aab5be44d19**** |
管道ID。 |
Id | String | 57f6aa3f84824309bcba67231b406**** |
模板分析作业ID。 |
NonExistAnalysisJobIds | Array of String | null |
不存在的模板分析作业ID列表,无数据时该结构不返回。 |
示例
请求示例
http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryAnalysisJobList
&AnalysisJobIds=bb558c1cc25b45309aab5be44d19****
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<QueryAnalysisJobListResponse>
<RequestId>5CA6E020-4102-4FFF-AA56-5ED7ECD811A1</RequestId>
<AnalysisJobList>
<CreationTime>2014-01-10T12:00:00Z</CreationTime>
<Percent>86</Percent>
<State>Success</State>
<AnalysisConfig>
<QualityControl>
<MethodStreaming>network</MethodStreaming>
<RateQuality>25</RateQuality>
</QualityControl>
<PropertiesControl>
<Deinterlace>Auto</Deinterlace>
<Crop>
<Top>8</Top>
<Width>8</Width>
<Height>8</Height>
<Left>8</Left>
<Mode>Auto</Mode>
</Crop>
</PropertiesControl>
</AnalysisConfig>
<Message>The resource operated \"PipelineId\" cannot be found</Message>
<Priority>8</Priority>
<MNSMessageResult>
<MessageId>3ca84a39a9024f19853b21be9cf9****</MessageId>
</MNSMessageResult>
<TemplateList>
<Video>
<Bufsize>6000</Bufsize>
<Degrain>5</Degrain>
<BitrateBnd>
<Max>1500</Max>
<Min>800</Min>
</BitrateBnd>
<PixFmt>yuv420p</PixFmt>
<Codec>H.264</Codec>
<Height>720</Height>
<Qscale>15</Qscale>
<Bitrate>1000</Bitrate>
<Maxrate>2000</Maxrate>
<Profile>high</Profile>
<Crf>26</Crf>
<Gop>250</Gop>
<Width>1280</Width>
<Fps>25</Fps>
<Preset>medium</Preset>
<ScanMode>interlaced</ScanMode>
</Video>
<TransConfig>
<TransMode>onepass</TransMode>
</TransConfig>
<State>Normal</State>
<MuxConfig>
<Gif>
<FinalDelay>0</FinalDelay>
<Loop>0</Loop>
</Gif>
<Segment>
<Duration>10</Duration>
</Segment>
</MuxConfig>
<Name>FLV-UD</Name>
<Audio>
<Profile>aac_low</Profile>
<Codec>aac</Codec>
<Samplerate>44100</Samplerate>
<Qscale>15</Qscale>
<Channels>2</Channels>
<Bitrate>128</Bitrate>
</Audio>
<Id>S00000000-00****</Id>
<Container>
<Format>flv</Format>
</Container>
</TemplateList>
<UserData>testid-001</UserData>
<InputFile>
<Object>example.flv</Object>
<Location>oss-cn-hangzhou</Location>
<Bucket>example-bucket</Bucket>
</InputFile>
<PipelineId>bb558c1cc25b45309aab5be44d19****</PipelineId>
<Id>57f6aa3f84824309bcba67231b406****</Id>
</AnalysisJobList>
<NonExistAnalysisJobIds>null</NonExistAnalysisJobIds>
</QueryAnalysisJobListResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId": "5CA6E020-4102-4FFF-AA56-5ED7ECD811A1",
"AnalysisJobList": [
{
"CreationTime": "2014-01-10T12:00:00Z",
"Percent": 86,
"State": "Success",
"AnalysisConfig": {
"QualityControl": {
"MethodStreaming": "network",
"RateQuality": "25"
},
"PropertiesControl": {
"Deinterlace": "Auto",
"Crop": {
"Top": "8",
"Width": "8",
"Height": "8",
"Left": "8",
"Mode": "Auto"
}
}
},
"Message": "The resource operated \\\"PipelineId\\\" cannot be found",
"Priority": "8",
"MNSMessageResult": {
"MessageId": "3ca84a39a9024f19853b21be9cf9****",
},
"TemplateList": [
{
"Video": {
"Bufsize": "6000",
"Degrain": "5",
"BitrateBnd": {
"Max": "1500",
"Min": "800"
},
"PixFmt": "yuv420p",
"Codec": "H.264",
"Height": "720",
"Qscale": "15",
"Bitrate": "1000",
"Maxrate": "2000",
"Profile": "high",
"Crf": "26",
"Gop": "250",
"Width": "1280",
"Fps": "25",
"Preset": "medium",
"ScanMode": "interlaced"
},
"TransConfig": {
"TransMode": "onepass"
},
"State": "Normal",
"MuxConfig": {
"Gif": {
"FinalDelay": "0",
"Loop": "0"
},
"Segment": {
"Duration": "10"
}
},
"Name": "FLV-UD",
"Audio": {
"Profile": "aac_low",
"Codec": "aac",
"Samplerate": "44100",
"Qscale": "15",
"Channels": "2",
"Bitrate": "128"
},
"Id": "S00000000-00****",
"Container": {
"Format": "flv"
}
}
],
"UserData": "testid-001",
"InputFile": {
"Object": "example.flv",
"Location": "oss-cn-hangzhou",
"Bucket": "example-bucket"
},
"PipelineId": "bb558c1cc25b45309aab5be44d19****",
"Id": "57f6aa3f84824309bcba67231b406****"
}
],
"NonExistAnalysisJobIds": [
"null"
]
}
错误码
访问错误中心查看更多错误码。