：QueryJobList

Usage notes

• By default, returned jobs are sorted in descending order by CreationTime.
• You can call this operation to query up to 10 transcoding jobs at a time.
• If you do not set the JobIds parameter, the InvalidParameter error code is returned.

QPS limits

You can call this operation up to 100 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limit.

Request parameters

Response parameters

Callback parameters

When the status of the transcoding job changes, MPS sends a message to the specified MNS queue. For more information about how to specify an MNS queue for receiving callbacks, see the UpdatePipeline topic.~~188374~~ The callback message is a JSON string that contains the parameters described in the following table.

{
  "Type": "Transcode",
  "State": "Success",
  "JobId": "39f8e0bc005e4f309379701645f4****",
  "UserData": "{\"key\":\"value\"}",
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642****"
}

Examples

Sample requests

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryJobList
&JobIds=bb558c1cc25b45309aab5be44d19****,d1ce4d3efcb549419193f50f1fcd****
&<Common request parameters>

Sample success responses

XML format

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

<QueryJobListResponse>
    <NonExistJobIds>d1ce4d3efcb549419193f50f1fcd****</NonExistJobIds>
    <RequestId>197ADF44-104C-514C-9F92-D8924CB34E2A</RequestId>
    <JobList>
        <CreationTime>2014-01-10T12:00:00Z</CreationTime>
        <Percent>100</Percent>
        <FinishTime>2014-01-10T12:20:25Z</FinishTime>
        <State>TranscodeSuccess</State>
        <JobId>31fa3c9ca8134fb4b0b0f7878301****</JobId>
        <Code>InvalidParameter.NullValue</Code>
        <Message>The specified parameter "%s" cannot be null.</Message>
        <Output>
            <Video>
                <Bufsize>6000</Bufsize>
                <Degrain>5</Degrain>
                <BitrateBnd>
                    <Max>1000</Max>
                    <Min>300</Min>
                </BitrateBnd>
                <PixFmt>yuv420p</PixFmt>
                <Pad>1280:800:0:140</Pad>
                <Codec>H.264</Codec>
                <Height>720</Height>
                <Qscale>15</Qscale>
                <Crop>1280:800:0:140</Crop>
                <Bitrate>500</Bitrate>
                <Maxrate>3000</Maxrate>
                <MaxFps>60</MaxFps>
                <Profile>high</Profile>
                <Crf>26</Crf>
                <Gop>250</Gop>
                <Width>1280</Width>
                <Fps>25</Fps>
                <Preset>medium</Preset>
                <ScanMode>interlaced</ScanMode>
                <ResoPriority>1</ResoPriority>
            </Video>
            <TransConfig>
                <IsCheckAudioBitrate>false</IsCheckAudioBitrate>
                <TransMode>onepass</TransMode>
                <IsCheckReso>false</IsCheckReso>
                <IsCheckVideoBitrateFail>false</IsCheckVideoBitrateFail>
                <AdjDarMethod>none</AdjDarMethod>
                <IsCheckVideoBitrate>false</IsCheckVideoBitrate>
                <IsCheckResoFail>false</IsCheckResoFail>
                <IsCheckAudioBitrateFail>false</IsCheckAudioBitrateFail>
            </TransConfig>
            <Encryption>
                <Type>hls-aes-128</Type>
                <Key>encryptionkey128</Key>
                <KeyType>Base64</KeyType>
                <Id>31fa3c9ca8134f9cec2b4b0b0f78****</Id>
                <KeyUri>https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/</KeyUri>
                <SkipCnt>3</SkipCnt>
            </Encryption>
            <WaterMarkList>
                <Type>Image</Type>
                <ReferPos>TopRight</ReferPos>
                <Dx>100</Dx>
                <Width>50</Width>
                <Height>50</Height>
                <InputFile>
                    <Object>example-logo-****.png</Object>
                    <Location>oss-cn-hangzhou</Location>
                    <Bucket>example-bucket</Bucket>
                </InputFile>
                <WaterMarkTemplateId>88c6ca184c0e47098a5b665e2a12****</WaterMarkTemplateId>
                <Dy>100</Dy>
            </WaterMarkList>
            <WaterMarkConfigUrl>http://example.com/configure</WaterMarkConfigUrl>
            <DeWatermark>{"0":[{"l":10,"t":10,"w":10,"h":10},{"l":100,"t":0.1,"w":10,"h":10}],"128000":[],"250000":[{"l":0.2,"t":0.1,"w":0.01,"h":0.05}]}</DeWatermark>
            <M3U8NonStandardSupport>
                <TS>
                    <SizeSupport>true</SizeSupport>
                    <Md5Support>true</Md5Support>
                </TS>
            </M3U8NonStandardSupport>
            <Priority>6</Priority>
            <Audio>
                <Profile>aaclow</Profile>
                <Codec>aac</Codec>
                <Samplerate>44100</Samplerate>
                <Qscale>15</Qscale>
                <Channels>2</Channels>
                <Volume>
                    <Method>auto</Method>
                    <Level>-20</Level>
                </Volume>
                <Bitrate>128</Bitrate>
            </Audio>
            <AudioStreamMap>0:a:0</AudioStreamMap>
            <MergeList>
                <Start>01:59:59.999</Start>
                <RoleArn>acs:ram::&lt;your uid&gt;:role/&lt;your role name&gt;</RoleArn>
                <MergeURL>http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv</MergeURL>
                <Duration>01:59:59.999</Duration>
            </MergeList>
            <SuperReso>
                <IsHalfSample>true</IsHalfSample>
            </SuperReso>
            <UserData>testid-001</UserData>
            <ExtendData>testid-002</ExtendData>
            <OutSubtitleList>
                <Map>0:v:0</Map>
                <OutSubtitleFile>
                    <RoleArn>acs:ram::&lt;your uid&gt;:role/&lt;your role name&gt;</RoleArn>
                    <Object>example.flv</Object>
                    <Location>oss-cn-hangzhou</Location>
                    <Bucket>exampleBucket</Bucket>
                </OutSubtitleFile>
                <Success>true</Success>
                <Message>The specified parameter "%s" cannot be null.</Message>
            </OutSubtitleList>
            <VideoStreamMap>0</VideoStreamMap>
            <OutputFile>
                <RoleArn>acs:ram::&lt;your uid&gt;:role/&lt;your role name&gt;</RoleArn>
                <Object>example-output.flv</Object>
                <Location>oss-cn-hangzhou</Location>
                <Bucket>example-bucket</Bucket>
            </OutputFile>
            <Rotate>90</Rotate>
            <Container>
                <Format>mp4</Format>
            </Container>
            <Clip>
                <TimeSpan>
                    <Seek>01:59:59.999</Seek>
                    <Duration>01:00:59.999</Duration>
                </TimeSpan>
            </Clip>
            <MergeConfigUrl>https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8</MergeConfigUrl>
            <OpeningList>
                <openUrl>http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4</openUrl>
                <Start>0</Start>
                <Width>-1</Width>
                <Height>-1</Height>
            </OpeningList>
            <MuxConfig>
                <Webp>
                    <Loop>0</Loop>
                </Webp>
                <Gif>
                    <FinalDelay>0</FinalDelay>
                    <DitherMode>bayer</DitherMode>
                    <Loop>0</Loop>
                    <IsCustomPalette>false</IsCustomPalette>
                </Gif>
                <Segment>
                    <Duration>20</Duration>
                </Segment>
            </MuxConfig>
            <TailSlateList>
                <Start>00000.00</Start>
                <BgColor>White</BgColor>
                <IsMergeAudio>true</IsMergeAudio>
                <Width>-1</Width>
                <Height>-1</Height>
                <BlendDuration>0</BlendDuration>
                <TailUrl>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv</TailUrl>
            </TailSlateList>
            <TemplateId>S00000001-200010</TemplateId>
            <SubtitleConfig>
                <ExtSubtitleList>
                    <CharEnc>auto</CharEnc>
                    <FontName>"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"</FontName>
                    <Input>
                        <Object>example-output.flv</Object>
                        <Location>oss-cn-hangzhou</Location>
                        <Bucket>example-bucket-****</Bucket>
                    </Input>
                </ExtSubtitleList>
                <SubtitleList>
                    <Map>0:a:0</Map>
                </SubtitleList>
            </SubtitleConfig>
            <Properties>
                <Width>720</Width>
                <Height>1280</Height>
                <SourceLogos>
                    <Source>example</Source>
                </SourceLogos>
                <Duration>17</Duration>
                <Fps>30</Fps>
                <Bitrate>490</Bitrate>
                <FileFormat>mp4</FileFormat>
                <Streams>
                    <VideoStreamList>
                        <Index>0</Index>
                        <Timebase>1/15360</Timebase>
                        <AvgFPS>30.0</AvgFPS>
                        <PixFmt>yuv420p</PixFmt>
                        <Sar>1:1</Sar>
                        <Lang>eng</Lang>
                        <CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
                        <Height>1280</Height>
                        <NumFrames>30</NumFrames>
                        <Bitrate>421.117</Bitrate>
                        <CodecTagString>avc1</CodecTagString>
                        <HasBFrames>2</HasBFrames>
                        <Profile>high</Profile>
                        <StartTime>0.000000</StartTime>
                        <NetworkCost>
                            <PreloadTime>8</PreloadTime>
                            <AvgBitrate>300</AvgBitrate>
                            <CostBandwidth>10</CostBandwidth>
                        </NetworkCost>
                        <Dar>9:16</Dar>
                        <CodecName>h264</CodecName>
                        <Width>720</Width>
                        <Duration>17.233333</Duration>
                        <Fps>30.0</Fps>
                        <CodecTag>0x31637661</CodecTag>
                        <CodecTimeBase>1/60</CodecTimeBase>
                        <Level>31</Level>
                        <colorTransfer>bt709</colorTransfer>
                        <colorPrimaries>bt709</colorPrimaries>
                        <bitsPerRawSample>8</bitsPerRawSample>
                    </VideoStreamList>
                    <AudioStreamList>
                        <Timebase>1/32000</Timebase>
                        <Index>1</Index>
                        <SampleFmt>fltp</SampleFmt>
                        <ChannelLayout>mono</ChannelLayout>
                        <Lang>und</Lang>
                        <Samplerate>32000</Samplerate>
                        <CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
                        <Channels>1</Channels>
                        <NumFrames>50</NumFrames>
                        <Bitrate>64.136</Bitrate>
                        <CodecTagString>mp4</CodecTagString>
                        <StartTime>0.064000</StartTime>
                        <CodecName>aac</CodecName>
                        <Duration>17.223562</Duration>
                        <CodecTag>0x6134706d</CodecTag>
                        <CodecTimeBase>1/32000</CodecTimeBase>
                    </AudioStreamList>
                    <SubtitleStreamList>
                        <Index>1</Index>
                        <Lang>eng</Lang>
                    </SubtitleStreamList>
                </Streams>
                <Format>
                    <StartTime>-0.064000</StartTime>
                    <NumPrograms>0</NumPrograms>
                    <Size>1057273</Size>
                    <NumStreams>2</NumStreams>
                    <FormatLongName>QuickTime / MOV</FormatLongName>
                    <Duration>17.234000</Duration>
                    <Bitrate>490.784</Bitrate>
                    <FormatName>mov</FormatName>
                </Format>
                <FileSize>1057273</FileSize>
            </Properties>
        </Output>
        <PipelineId>88c6ca184c0e47b665e2a1267971****</PipelineId>
        <Input>
            <Object>video_01.mp4</Object>
            <Location>oss-cn-shanghai</Location>
            <Bucket>exampleBucket</Bucket>
        </Input>
        <MNSMessageResult>
            <MessageId>123</MessageId>
            <ErrorMessage>The resource operated "%s" cannot be found.</ErrorMessage>
            <ErrorCode>InvalidParameter.ResourceNotFound</ErrorCode>
        </MNSMessageResult>
    </JobList>
</QueryJobListResponse>

JSON format

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

{
  "NonExistJobIds" : [ "d1ce4d3efcb549419193f50f1fcd****" ],
  "RequestId" : "197ADF44-104C-514C-9F92-D8924CB34E2A",
  "JobList" : [ {
    "CreationTime" : "2014-01-10T12:00:00Z",
    "Percent" : 100,
    "FinishTime" : "2014-01-10T12:20:25Z",
    "State" : "TranscodeSuccess",
    "JobId" : "31fa3c9ca8134fb4b0b0f7878301****",
    "Code" : "InvalidParameter.NullValue",
    "Message" : "The specified parameter \"%s\" cannot be null.",
    "Output" : {
      "Video" : {
        "Bufsize" : "6000",
        "Degrain" : "5",
        "BitrateBnd" : {
          "Max" : "1000",
          "Min" : "300"
        },
        "PixFmt" : "yuv420p",
        "Pad" : "1280:800:0:140",
        "Codec" : "H.264",
        "Height" : "720",
        "Qscale" : "15",
        "Crop" : "1280:800:0:140",
        "Bitrate" : "500",
        "Maxrate" : "3000",
        "MaxFps" : "60",
        "Profile" : "high",
        "Crf" : "26",
        "Gop" : "250",
        "Width" : "1280",
        "Fps" : "25",
        "Preset" : "medium",
        "ScanMode" : "interlaced",
        "ResoPriority" : "1"
      },
      "TransConfig" : {
        "IsCheckAudioBitrate" : "false",
        "TransMode" : "onepass",
        "IsCheckReso" : "false",
        "IsCheckVideoBitrateFail" : "false",
        "AdjDarMethod" : "none",
        "IsCheckVideoBitrate" : "false",
        "IsCheckResoFail" : "false",
        "IsCheckAudioBitrateFail" : "false"
      },
      "Encryption" : {
        "Type" : "hls-aes-128",
        "Key" : "encryptionkey128",
        "KeyType" : "Base64",
        "Id" : "31fa3c9ca8134f9cec2b4b0b0f78****",
        "KeyUri" : "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
        "SkipCnt" : "3"
      },
      "WaterMarkList" : [ {
        "Type" : "Image",
        "ReferPos" : "TopRight",
        "Dx" : "100",
        "Width" : "50",
        "Height" : "50",
        "InputFile" : {
          "Object" : "example-logo-****.png",
          "Location" : "oss-cn-hangzhou",
          "Bucket" : "example-bucket"
        },
        "WaterMarkTemplateId" : "88c6ca184c0e47098a5b665e2a12****",
        "Dy" : "100"
      } ],
      "WaterMarkConfigUrl" : "http://example.com/configure",
      "DeWatermark" : "{\"0\":[{\"l\":10,\"t\":10,\"w\":10,\"h\":10},{\"l\":100,\"t\":0.1,\"w\":10,\"h\":10}],\"128000\":[],\"250000\":[{\"l\":0.2,\"t\":0.1,\"w\":0.01,\"h\":0.05}]}",
      "M3U8NonStandardSupport" : {
        "TS" : {
          "SizeSupport" : true,
          "Md5Support" : true
        }
      },
      "Priority" : "6",
      "Audio" : {
        "Profile" : "aaclow",
        "Codec" : "aac",
        "Samplerate" : "44100",
        "Qscale" : "15",
        "Channels" : "2",
        "Volume" : {
          "Method" : "auto",
          "Level" : "-20"
        },
        "Bitrate" : "128"
      },
      "AudioStreamMap" : "0:a:0",
      "MergeList" : [ {
        "Start" : "01:59:59.999",
        "RoleArn" : "acs:ram::<your uid>:role/<your role name>",
        "MergeURL" : "http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv",
        "Duration" : "01:59:59.999"
      } ],
      "SuperReso" : {
        "IsHalfSample" : "true"
      },
      "UserData" : "testid-001",
      "ExtendData" : "testid-002",
      "OutSubtitleList" : [ {
        "Map" : "0:v:0",
        "OutSubtitleFile" : {
          "RoleArn" : "acs:ram::<your uid>:role/<your role name>",
          "Object" : "example.flv",
          "Location" : "oss-cn-hangzhou",
          "Bucket" : "exampleBucket"
        },
        "Success" : true,
        "Message" : "The specified parameter "%s" cannot be null."
      } ],
      "VideoStreamMap" : "0",
      "OutputFile" : {
        "RoleArn" : "acs:ram::<your uid>:role/<your role name>",
        "Object" : "example-output.flv",
        "Location" : "oss-cn-hangzhou",
        "Bucket" : "example-bucket"
      },
      "Rotate" : "90",
      "Container" : {
        "Format" : "mp4"
      },
      "Clip" : {
        "TimeSpan" : {
          "Seek" : "01:59:59.999",
          "Duration" : "01:00:59.999"
        }
      },
      "MergeConfigUrl" : "https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8",
      "OpeningList" : [ {
        "openUrl" : "http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4",
        "Start" : "0",
        "Width" : "-1",
        "Height" : "-1"
      } ],
      "MuxConfig" : {
        "Webp" : {
          "Loop" : "0"
        },
        "Gif" : {
          "FinalDelay" : "0",
          "DitherMode" : "bayer",
          "Loop" : "0",
          "IsCustomPalette" : "false"
        },
        "Segment" : {
          "Duration" : "20"
        }
      },
      "TailSlateList" : [ {
        "Start" : "00000.00",
        "BgColor" : "White",
        "IsMergeAudio" : true,
        "Width" : "-1",
        "Height" : "-1",
        "BlendDuration" : "0",
        "TailUrl" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
      } ],
      "TemplateId" : "S00000001-200010",
      "SubtitleConfig" : {
        "ExtSubtitleList" : [ {
          "CharEnc" : "auto",
          "FontName" : "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
          "Input" : {
            "Object" : "example-output.flv",
            "Location" : "oss-cn-hangzhou",
            "Bucket" : "example-bucket-****"
          }
        } ],
        "SubtitleList" : [ {
          "Map" : "0:a:0"
        } ]
      },
      "Properties" : {
        "Width" : "720",
        "Height" : "1280",
        "SourceLogos" : [ {
          "Source" : "example"
        } ],
        "Duration" : "17",
        "Fps" : "30",
        "Bitrate" : "490",
        "FileFormat" : "mp4",
        "Streams" : {
          "VideoStreamList" : [ {
            "Index" : "0",
            "Timebase" : "1/15360",
            "AvgFPS" : "30.0",
            "PixFmt" : "yuv420p",
            "Sar" : "1:1",
            "Lang" : "eng",
            "CodecLongName" : "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
            "Height" : "1280",
            "NumFrames" : "30",
            "Bitrate" : "421.117",
            "CodecTagString" : "avc1",
            "HasBFrames" : "2",
            "Profile" : "high",
            "StartTime" : "0.000000",
            "NetworkCost" : {
              "PreloadTime" : "8",
              "AvgBitrate" : "300",
              "CostBandwidth" : "10"
            },
            "Dar" : "9:16",
            "CodecName" : "h264",
            "Width" : "720",
            "Duration" : "17.233333",
            "Fps" : "30.0",
            "CodecTag" : "0x31637661",
            "CodecTimeBase" : "1/60",
            "Level" : "31",
            "colorTransfer" : "bt709",
            "colorPrimaries" : "bt709",
            "bitsPerRawSample" : "8"
          } ],
          "AudioStreamList" : [ {
            "Timebase" : "1/32000",
            "Index" : "1",
            "SampleFmt" : "fltp",
            "ChannelLayout" : "mono",
            "Lang" : "und",
            "Samplerate" : "32000",
            "CodecLongName" : "AAC (Advanced Audio Coding)",
            "Channels" : "1",
            "NumFrames" : "50",
            "Bitrate" : "64.136",
            "CodecTagString" : "mp4",
            "StartTime" : "0.064000",
            "CodecName" : "aac",
            "Duration" : "17.223562",
            "CodecTag" : "0x6134706d",
            "CodecTimeBase" : "1/32000"
          } ],
          "SubtitleStreamList" : [ {
            "Index" : "1",
            "Lang" : "eng"
          } ]
        },
        "Format" : {
          "StartTime" : "-0.064000",
          "NumPrograms" : "0",
          "Size" : "1057273",
          "NumStreams" : "2",
          "FormatLongName" : "QuickTime / MOV",
          "Duration" : "17.234000",
          "Bitrate" : "490.784",
          "FormatName" : "mov"
        },
        "FileSize" : "1057273"
      }
    },
    "PipelineId" : "88c6ca184c0e47b665e2a1267971****",
    "Input" : {
      "Object" : "video_01.mp4",
      "Location" : "oss-cn-shanghai",
      "Bucket" : "exampleBucket"
    },
    "MNSMessageResult" : {
      "MessageId" : "123",
      "ErrorMessage" : "The resource operated "%s" cannot be found.",
      "ErrorCode" : "InvalidParameter.ResourceNotFound"
    }
  } ]
}

Error codes

For a list of error codes, see Service error codes.