查询模板分析作业 - API参考| 阿里云

调试

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

请求参数


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

返回数据


名称	类型	示例值	描述
RequestId	String	5CA6E020-4102-4FFF-AA56-5ED7ECD8****	请求ID。
AnalysisJobList	Array of AnalysisJob		模板分析作业列表。
AnalysisJob
CreationTime	String	2014-01-10T12:00:00Z	作业添加时间。
Percent	Long	100	转码进度。取值范围：[0,100]。
State	String	Success	作业状态。 Submitted：已提交。 Analyzing：分析中。 Success：成功。 Fail：失败。
AnalysisConfig	Object		作业配置。
QualityControl	Object		输出质量控制。
MethodStreaming	String	network	播放方式。 network：在线。 local：本地。默认值：network。
RateQuality	String	25	输出质量等级。范围：(0,51]。值为整数。默认值：25。
PropertiesControl	Object		属性控制。
Deinterlace	String	Auto	强制扫描模式判定。 Auto：自动。 Force：强制做deinterlace。 None：强制不做。
Crop	Object		视频裁切配置。
Top	String	8	裁切上边距。范围：[8,4096]。如MODE为Auto、None，此值失效。
Width	String	8	裁切后宽。范围：[8,4096]。如MODE为Auto、None，此值失效。
Height	String	8	裁切后高。范围：[8,4096]。如MODE为Auto、None，此值失效。
Left	String	8	裁切左边距。范围：[8,4096]。如MODE为Auto、None，此值失效。
Mode	String	Auto	取值： Auto：自动。 Force：强制。 None：强制不做。如Crop不是空JOSN{}，则此值必填。
Message	String	xxx	分析失败时错误信息。
Priority	String	8	任务在其对应管道内的优先级。取值范围：[1,10]。10为最高优先级。默认值：10。
MNSMessageResult	Object		MNS通知用户作业完成的结果。
MessageId	String	123	成功时消息ID。
ErrorMessage	String	xxx	失败时错误信息。
ErrorCode	String	xxx	失败时错误码。
TemplateList	Array of Template		作业输出的预置模板列表。
Template
Video	Object		视频编解码配置。
Bufsize	String	6000	缓冲区大小。取值范围：[1000,128000]。单位：Kb。默认值：6000。
Degrain	String	5	独立去噪算法强度，取值范围：[1,9] 。
BitrateBnd	Object		视频平均码率范围。
Max	String	1500	总码率上限。取值范围：[10,50000]。单位：Kbps。
Min	String	800	总码率下限。取值范围：[10,50000]。单位：Kbps。
PixFmt	String	yuv420p	视频颜色格式。包含yuv420p，yuvj420p等标准颜色格式。
Codec	String	H.264	编解码格式。支持H.264、H.265。默认值：H.264。
Height	String	720	高。取值范围：[128,4096]。单位：px。默认值：视频原始高度。
Qscale	String	15	视频质量控制度，取值范围：[1,31]。
Bitrate	String	1000	视频平均码率。取值范围：[10,50000]。单位：Kbps。
Maxrate	String	2000	视频码率峰值。取值范围：[10,50000]。单位：Kbps。
Profile	String	high	编码级别。 baseline：针对移动设备。 main：针对标准分辨率设备。 high：针对高分辨率设备。默认值：high。
Crf	String	26	码率-质量控制因子。取值范围：[0,51]。默认值：编码格式为H264，默认值为23。编码格式为H265，默认值为26。如果设置了Crf，则Bitrate的设置失效。
Gop	String	250	关键帧间最大帧数。取值范围：[1,1080000]。默认值：250。
Width	String	1280	宽。取值范围：[128,4096]。单位：px。默认值：视频原始宽度。
Fps	String	25	帧率。取值范围：(0,60]。当输入文件帧率超过60时取60。默认值：取输入文件帧率。
Preset	String	medium	视频算法器预置。支持veryfast、fast、medium、slow、slower。默认值：medium。
ScanMode	String	interlaced	扫描模式。支持interlaced、progressive。
TransConfig	Object		转码通用配置。
TransMode	String	onepass	转码模式。可选范围onepass、twopass、CBR。默认值：onepass。
State	String	Normal	模板的状态。 Normal：正常。 Deleted：已删除。
MuxConfig	Object		转码封包配置。
Gif	Object		gif格式。
FinalDelay	String	0	gif的loop间隔，单位为百分之一秒，比如500代表间隔为5秒。
Loop	String	0	gif与webp循环次数，默认不循环。
Segment	Object		切片配置。
Duration	String	10	分片时长。取值范围：[1,60]。单位：秒。
Name	String	FLV-UD	模板名称。
Audio	Object		音频编解码配置。
Profile	String	aac_low	音频编码预置。当Codec为aac时可以设置如下范围中的值：aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。
Codec	String	aac	音频编解码格式。支持aac、mp3、vorbis、flac。默认值：aac。
Samplerate	String	44100	采样率。支持22050、32000、44100、48000、96000。单位：Hz。默认值：44100。
Qscale	String	15	音频质量控制度取值范围：[1,31]。
Channels	String	2	声道数。支持1、2、3、4、5、6、7、8。默认值：2。
Bitrate	String	128	输出文件的音频码率。取值范围：8~1000。单位：Kbps。默认值：128。
Id	String	S00000000-000020	转码模板ID。
Container	Object		容器。
Format	String	flv	容器格式。可选范围flv、mp4、ts、m3u8、gif、mp3、ogg、flac。
UserData	String	testid-001	用户自定义数据。
Code	String	xxx	分析失败时错误码。
InputFile	Object		作业输入。
Object	String	example.flv	OSS的Object，最大1024字节。
Location	String	oss-cn-hangzhou	OSS的服务区域，最大64字节。
Bucket	String	example-bucket	OSS的Bucket，3~63字节。
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-5ED7ECD8****</RequestId>
    <AnalysisJobList>
        <CreationTime>2014-01-10T12:00:00Z</CreationTime>
        <Percent>100</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>xxx</Message>
        <Priority>8</Priority>
        <MNSMessageResult>
            <MessageId>123</MessageId>
            <ErrorMessage>xxx</ErrorMessage>
            <ErrorCode>xxx</ErrorCode>
        </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-000020</Id>
            <Container>
                <Format>flv</Format>
            </Container>
        </TemplateList>
        <UserData>testid-001</UserData>
        <Code>xxx</Code>
        <InputFile>
            <Object>example.flv</Object>
            <Location>oss-cn-hangzhou</Location>
            <Bucket>example-bucket</Bucket>
        </InputFile>
        <PipelineId>bb558c1cc25b45309aab5be44d19****</PipelineId>
        <Id>57f6aa3f84824309bcba67231b406****</Id>
    </AnalysisJobList>
</QueryAnalysisJobListResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "5CA6E020-4102-4FFF-AA56-5ED7ECD8****",
  "AnalysisJobList" : [ {
    "CreationTime" : "2014-01-10T12:00:00Z",
    "Percent" : 100,
    "State" : "Success",
    "AnalysisConfig" : {
      "QualityControl" : {
        "MethodStreaming" : "network",
        "RateQuality" : "25"
      },
      "PropertiesControl" : {
        "Deinterlace" : "Auto",
        "Crop" : {
          "Top" : "8",
          "Width" : "8",
          "Height" : "8",
          "Left" : "8",
          "Mode" : "Auto"
        }
      }
    },
    "Message" : "xxx",
    "Priority" : "8",
    "MNSMessageResult" : {
      "MessageId" : "123",
      "ErrorMessage" : "xxx",
      "ErrorCode" : "xxx"
    },
    "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-000020",
      "Container" : {
        "Format" : "flv"
      }
    } ],
    "UserData" : "testid-001",
    "Code" : "xxx",
    "InputFile" : {
      "Object" : "example.flv",
      "Location" : "oss-cn-hangzhou",
      "Bucket" : "example-bucket"
    },
    "PipelineId" : "bb558c1cc25b45309aab5be44d19****",
    "Id" : "57f6aa3f84824309bcba67231b406****"
  } ],
  "NonExistAnalysisJobIds" : [ ]
}

错误码

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