调用QueryAnalysisJobList查询模板分析作业,模板分析作业完成后,返回可用的预置模板列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 否 | QueryAnalysisJobList |
操作接口名,系统规定参数,取值:QueryAnalysisJobList |
AnalysisJobIds | String | 是 | 88c6ca184c0e*****a5b665e2a126797 |
模板分析作业ID列表。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
AnalysisJobList | Array of AnalysisJob |
模板分析作业列表。 |
|
AnalysisJob | |||
AnalysisConfig | Struct |
作业配置。 |
|
PropertiesControl | Struct |
属性控制。 |
|
Crop | Struct |
视频裁切配置。 |
|
Height | String | 8 |
裁切后高。
|
Left | String | 8 |
裁切左边距。
|
Mode | String | Auto |
取值:
|
Top | String | 8 |
裁切上边距。
|
Width | String | 8 |
裁切后宽。
|
Deinterlace | String | Auto |
强制扫描模式判定。
|
QualityControl | Struct |
输出质量控制。 |
|
MethodStreaming | String | network |
播放方式,network或local。 默认值:network |
RateQuality | String | 25 |
输出质量等级。
|
Code | String | xxx |
分析失败时错误码。 |
CreationTime | String | 2014-01-10T12:00:00Z |
作业添加时间。 |
Id | String | 88c6ca184c0e*****a5b665e2a126797 |
模板分析作业ID。 |
InputFile | Struct |
作业输入。 |
|
Bucket | String | example-bucket |
OSS Bucket。 |
Location | String | oss-cn-hangzhou |
OSS Location。 |
Object | String | example.flv |
OSS Object。 |
MNSMessageResult | Struct |
MNS通知用户作业完成的结果。 |
|
ErrorCode | String | xxx |
失败时错误码。 |
ErrorMessage | String | xxx |
失败时错误信息。 |
MessageId | String | 123 |
成功时消息ID。 |
Message | String | xxx |
分析失败时错误信息。 |
Percent | Long | 100 |
转码进度。 取值范围:0~100。 |
PipelineId | String | 88c6ca184c0e*****a5b665e2a126797 |
管道ID。 |
Priority | String | 8 |
任务在其对应管道内的优先级。
|
State | String | Success |
作业状态。 分为Submitted、Analyzing、Success、Fail |
TemplateList | Array of Template |
作业输出的预置模板列表。 |
|
Template | |||
Audio | Struct |
音频编解码配置。 |
|
Bitrate | String | 128 |
输出文件的音频码率。
|
Channels | String | 2 |
声道数。
|
Codec | String | aac |
音频编解码格式。
|
Profile | String | aac_low |
音频编码预置。 当Codec为aac时可以设置如下范围中的值:aac_low、aac_he、aac_he_v2、aac_ld、aac_eld |
Qscale | String | 15 |
音频质量控制度
|
Samplerate | String | 44100 |
采样率。
|
Container | Struct |
容器。 |
|
Format | String | flv |
容器格式。 可选范围flv、mp4、ts、m3u8、gif、mp3、ogg、flac |
Id | String | S00000000-000020 |
转码模板ID。 |
MuxConfig | Struct |
转码封包配置。 |
|
Gif | Struct |
gif格式。 |
|
FinalDelay | String | 0 |
gif的loop间隔,单位为百分之一秒,比如500代表间隔为5秒。 |
Loop | String | 0 |
gif与webp循环次数,默认不循环。 |
Segment | Struct |
切片配置。 |
|
Duration | String | 10 |
分片时长。
|
Name | String | FLV-UD |
模板名称。 |
State | String | Normal |
模板的状态,分为Normal、Deleted。 |
TransConfig | Struct |
转码通用配置。 |
|
TransMode | String | onepass |
转码模式。
|
Video | Struct |
视频编解码配置。 |
|
Bitrate | String | 1000 |
视频平均码率。
|
BitrateBnd | Struct |
视频平均码率范围。 |
|
Max | String | 1500 |
总码率上限,
|
Min | String | 800 |
总码率下限。
|
Bufsize | String | 6000 |
缓冲区大小。
|
Codec | String | H.264 |
编解码格式。
|
Crf | String | 26 |
码率-质量控制因子。
|
Degrain | String | 5 |
独立去噪算法强度 -取值范围: |
Fps | String | 25 |
帧率。
|
Gop | String | 250 |
关键帧间最大帧数。
|
Height | String | 720 |
高。
|
Maxrate | String | 2000 |
视频码率峰值。
|
PixFmt | String | yuv420p |
视频颜色格式。 范围:yuv420p,yuvj420p等标准颜色格式 |
Preset | String | medium |
视频算法器预置。
|
Profile | String | high |
编码级别。 支持baseline、main、high。
|
Qscale | String | 15 |
视频质量控制度
|
ScanMode | String | interlaced |
扫描模式。 支持interlaced、progressive |
Width | String | 1280 |
宽。
|
UserData | String | testid-001 |
用户自定义数据。 |
NonExistAnalysisJobIds | List | 无 |
不存在的模板分析作业ID列表,无数据时该结构不返回。 |
RequestId | String | 25818875-5F78-4A*****F6-D7393642CA58 |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=QueryAnalysisJobList
&AnalysisJobIds=88c6ca184c0e*****a5b665e2a126797
&<公共请求参数>
正常返回示例
XML
格式
<QueryAnalysisJobListResponse>
<RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
<AnalysisJobList>
<AnalysisJob>
<Id>88c6ca184c0e*****a5b665e2a126797</Id>
<InputFile>
<Bucket>example-bucket</Bucket>
<Location>oss-cn-hangzhou</Location>
<Object>example.flv</Object>
</InputFile>
<AnalysisConfig>
<QualityControl>
<RateQuality>25</RateQuality>
<MethodStreaming>network</MethodStreaming>
</QualityControl>
</AnalysisConfig>
<UserData>testid-001</UserData>
<State>Success</State>
<Code></Code>
<Message></Message>
<Percent>100</Percent>
<PipelineId>88c6ca184c0e*****a5b665e2a126797</PipelineId>
<CreationTime>2014-01-10T12:00:00Z</CreationTime>
<TemplateList>
<Template>
<Id>S00000000-000020</Id>
<Name>FLV-UD</Name>
<Container>
<Format>flv</Format>
</Container>
<Video>
<Codec>Auto</Codec>
<Profile>Auto</Profile>
<Bitrate>Auto</Bitrate>
<Crf>Auto</Crf>
<Width>Auto</Width>
<Height>Auto</Height>
<Fps>Auto</Fps>
<Gop>Auto</Gop>
</Video>
<Audio>
<Codec>AAC</Codec>
<Samplerate>44100</Samplerate>
<Bitrate>Auto</Bitrate>
<Channels>Auto</Channels>
</Audio>
<State>Normal</State>
</Template>
</TemplateList>
</AnalysisJob>
</AnalysisJobList>
</QueryAnalysisJobListResponse>
JSON
格式
{
"QueryAnalysisJobListResponse": {
"RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
"AnalysisJobList": {
"AnalysisJob": {
"Id": "88c6ca184c0e*****a5b665e2a126797",
"InputFile": {
"Bucket": "example-bucket",
"Location": "oss-cn-hangzhou",
"Object": "example.flv"
},
"AnalysisConfig": {
"QualityControl": {
"RateQuality": 25,
"MethodStreaming": "network"
}
},
"UserData": "testid-001",
"State": "Success",
"Code": "",
"Message": "",
"Percent": 100,
"PipelineId": "88c6ca184c0e*****a5b665e2a126797",
"CreationTime": "2014-01-10T12:00:00Z",
"TemplateList": {
"Template": {
"Id": "S00000000-000020",
"Name": "FLV-UD",
"Container": {
"Format": "flv"
},
"Video": {
"Codec": "Auto",
"Profile": "Auto",
"Bitrate": "Auto",
"Crf": "Auto",
"Width": "Auto",
"Height": "Auto",
"Fps": "Auto",
"Gop": "Auto"
},
"Audio": {
"Codec": "AAC",
"Samplerate": 44100,
"Bitrate": "Auto",
"Channels": "Auto"
},
"State": "Normal"
}
}
}
}
}
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交