查询模板分析作业 - 媒体处理

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	否	QueryAnalysisJobList	操作接口名，系统规定参数，取值：QueryAnalysisJobList
AnalysisJobIds	String	是	88c6ca184c0e*****a5b665e2a126797	模板分析作业ID列表。一次最多查询10个。多个使用逗号“,”作为分隔符。

返回数据


名称	类型	示例值	描述
AnalysisJobList	Array of AnalysisJob		模板分析作业列表。
AnalysisJob
AnalysisConfig	Struct		作业配置。
PropertiesControl	Struct		属性控制。
Crop	Struct		视频裁切配置。
Height	String	8	裁切后高。范围：`[8，4096`] 如MODE为Auto、None，此值失效。
Left	String	8	裁切左边距。范围：`[8，4096`] 如MODE为Auto、None，此值失效。
Mode	String	Auto	取值： Auto：自动， Force：强制， None：强制不做，如Crop不是空JOSN{}，则此值必填。
Top	String	8	裁切上边距。范围：`[8，4096`] 如MODE为Auto、None，此值失效。
Width	String	8	裁切后宽。范围：`[8，4096`] 如MODE为Auto、None，此值失效。
Deinterlace	String	Auto	强制扫描模式判定。 Auto：自动 Force：强制做deinterlace None：强制不做。
QualityControl	Struct		输出质量控制。
MethodStreaming	String	network	播放方式，network或local。默认值：network
RateQuality	String	25	输出质量等级。值范围：(0，51] - 值为整数 - 默认值：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	任务在其对应管道内的优先级。取值范围：`[1, 10`] 最高优先级：10 默认值：10
State	String	Success	作业状态。分为Submitted、Analyzing、Success、Fail
TemplateList	Array of Template		作业输出的预置模板列表。
Template
Audio	Struct		音频编解码配置。
Bitrate	String	128	输出文件的音频码率。取值范围：`[8，1000`] 单位：Kbps 默认值：128
Channels	String	2	声道数。支持1、2、3、4、5、6、7、8 默认值：2
Codec	String	aac	音频编解码格式。支持aac、mp3、vorbis、flac，默认值：aac
Profile	String	aac_low	音频编码预置。当Codec为aac时可以设置如下范围中的值：aac_low、aac_he、aac_he_v2、aac_ld、aac_eld
Qscale	String	15	音频质量控制度取值范围：`[1，31`]
Samplerate	String	44100	采样率。支持22050、32000、44100、48000、96000，单位：Hz 默认值：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	分片时长。取值范围：`[1，60`] 单位：秒
Name	String	FLV-UD	模板名称。
State	String	Normal	模板的状态，分为Normal、Deleted。
TransConfig	Struct		转码通用配置。
TransMode	String	onepass	转码模式。可选范围onepass、twopass、CBR 默认值：onepass
Video	Struct		视频编解码配置。
Bitrate	String	1000	视频平均码率。取值范围：`[10，50000`] 单位：Kbps
BitrateBnd	Struct		视频平均码率范围。
Max	String	1500	总码率上限，取值范围：`[10，50000`] 单位：Kbps
Min	String	800	总码率下限。取值范围：`[10，50000`] 单位：Kbps
Bufsize	String	6000	缓冲区大小。取值范围：`[1000，128000`] 单位：Kb 默认值：6000
Codec	String	H.264	编解码格式。支持H.264、H.265 默认值：H.264
Crf	String	26	码率-质量控制因子。取值范围：`[0，51`] 默认值：26 如果设置了Crf，则Bitrate的设置失效。
Degrain	String	5	独立去噪算法强度 -取值范围: `[1, 9`]
Fps	String	25	帧率。取值范围：(0，60] - 当输入文件帧率超过60时取60 - 默认值：取输入文件帧率。 )
Gop	String	250	关键帧间最大帧数。取值范围：`[1，1080000`] 默认值：250
Height	String	720	高。取值范围：`[128,4096`] 单位：px 默认值：视频原始高度
Maxrate	String	2000	视频码率峰值。取值范围：`[10，50000`] 单位：Kbps
PixFmt	String	yuv420p	视频颜色格式。范围：yuv420p，yuvj420p等标准颜色格式
Preset	String	medium	视频算法器预置。支持veryfast、fast、medium、slow、slower 默认值：medium
Profile	String	high	编码级别。支持baseline、main、high。 baseline：针对移动设备， main：针对标准分辨率设备， high：针对高分辨率设备，默认值：high
Qscale	String	15	视频质量控制度取值范围：`[1，31`]
ScanMode	String	interlaced	扫描模式。支持interlaced、progressive
Width	String	1280	宽。取值范围：`[128,4096`] 单位：px 默认值：视频原始宽度
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"
                    }
                }
            }
        }
    }
}

错误码

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