：SubmitAnalysisJob

Usage notes

• After you call the SubmitAnalysisJob operation to submit a preset template analysis job, ApsaraVideo Media Processing (MPS) intelligently analyzes the input file of the job and recommends a suitable preset template. You can call the QueryAnalysisJobList operation to query the analysis result or enable asynchronous notifications to receive the analysis result.
• The analysis result is retained only for two weeks since it is generated. It is deleted after two weeks. If you use the recommended preset template in a transcoding job after two weeks, the job fails, and the AnalysisResultNotFound error code is returned.

QPS limit

You can call this operation up to 100 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limit.

Request parameters

Response parameters

Examples

Sample requests

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SubmitAnalysisJob
&Input={"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.flv"}
&AnalysisConfig={"QualityControl":{"RateQuality":25,"MethodStreaming":"network"}}
&UserData=testid-001
&PipelineId=bb558c1cc25b45309aab5be44d19****
&Priority=10
&<Common request parameters>

Sample success responses

XML format

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

<SubmitAnalysisJobResponse>
    <RequestId>B52658D4-07AB-43CD-82B0-210958A65E23</RequestId>
    <AnalysisJob>
        <CreationTime>2014-01-10T12:00:00Z</CreationTime>
        <Percent>100</Percent>
        <State>Success</State>
        <AnalysisConfig>
            <QualityControl>
                <MethodStreaming>network</MethodStreaming>
                <RateQuality>50</RateQuality>
            </QualityControl>
            <PropertiesControl>
                <Deinterlace>Force</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>10</Priority>
        <MNSMessageResult>
            <MessageId>3ca84a39a9024f19853b21be9cf9****</MessageId>
        </MNSMessageResult>
        <TemplateList>
            <Video>
                <Bufsize>5000</Bufsize>
                <Degrain>5</Degrain>
                <BitrateBnd>
                    <Max>20</Max>
                    <Min>10</Min>
                </BitrateBnd>
                <PixFmt>yuvj420p</PixFmt>
                <Codec>H.264</Codec>
                <Height>1880</Height>
                <Qscale>15</Qscale>
                <Bitrate>10</Bitrate>
                <Maxrate>10</Maxrate>
                <Profile>baseline</Profile>
                <Crf>27</Crf>
                <Gop>1</Gop>
                <Width>1990</Width>
                <Fps>60</Fps>
                <Preset>medium</Preset>
                <ScanMode>progressive</ScanMode>
            </Video>
            <TransConfig>
                <TransMode>onepass</TransMode>
            </TransConfig>
            <State>Normal</State>
            <MuxConfig>
                <Gif>
                    <FinalDelay>0</FinalDelay>
                    <Loop>0</Loop>
                </Gif>
                <Segment>
                    <Duration>60</Duration>
                </Segment>
            </MuxConfig>
            <Name>FLV-UD</Name>
            <Audio>
                <Profile>aac_low</Profile>
                <Codec>mp3</Codec>
                <Samplerate>32000</Samplerate>
                <Qscale>10</Qscale>
                <Channels>1</Channels>
                <Bitrate>8</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>57f6aa3f84824309bcba67231b40****</Id>
    </AnalysisJob>
</SubmitAnalysisJobResponse>

JSON format

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

{
    "RequestId": "B52658D4-07AB-43CD-82B0-210958A65E23",
    "AnalysisJob": {
        "CreationTime": "2014-01-10T12:00:00Z",
        "Percent": 100,
        "State": "Success",
        "AnalysisConfig": {
            "QualityControl": {
                "MethodStreaming": "network",
                "RateQuality": "50"
            },
            "PropertiesControl": {
                "Deinterlace": "Force",
                "Crop": {
                    "Top": "8",
                    "Width": "8",
                    "Height": "8",
                    "Left": "8",
                    "Mode": "Auto"
                }
            }
        },
        "Message": "The resource operated \\\"PipelineId\\\" cannot be found",
        "Priority": "10",
        "MNSMessageResult": {
            "MessageId": "3ca84a39a9024f19853b21be9cf9****",
        },
        "TemplateList": [
            {
                "Video": {
                    "Bufsize": "5000",
                    "Degrain": "5",
                    "BitrateBnd": {
                        "Max": "20",
                        "Min": "10"
                    },
                    "PixFmt": "yuvj420p",
                    "Codec": "H.264",
                    "Height": "1880",
                    "Qscale": "15",
                    "Bitrate": "10",
                    "Maxrate": "10",
                    "Profile": "baseline",
                    "Crf": "27",
                    "Gop": "1",
                    "Width": "1990",
                    "Fps": "60",
                    "Preset": "medium",
                    "ScanMode": "progressive"
                },
                "TransConfig": {
                    "TransMode": "onepass"
                },
                "State": "Normal",
                "MuxConfig": {
                    "Gif": {
                        "FinalDelay": "0",
                        "Loop": "0"
                    },
                    "Segment": {
                        "Duration": "60"
                    }
                },
                "Name": "FLV-UD",
                "Audio": {
                    "Profile": "aac_low",
                    "Codec": "mp3",
                    "Samplerate": "32000",
                    "Qscale": "10",
                    "Channels": "1",
                    "Bitrate": "8"
                },
                "Id": "S00000000-00****",
                "Container": {
                    "Format": "flv"
                }
            }
        ],
        "UserData": "testid-001",
        "InputFile": {
            "Object": "example.flv",
            "Location": "oss-cn-hangzhou",
            "Bucket": "example-bucket"
        },
        "PipelineId": "bb558c1cc25b45309aab5be44d19****",
        "Id": "57f6aa3f84824309bcba67231b40****"
    }
}

Error codes

For a list of error codes, visit the API Error Center.