:QueryMediaListByURL

Catatan penggunaan

• Anda dapat memanggil operasi ini untuk menanyakan hingga 10 file media sekaligus.
• Sebelum memanggil operasi ini, Anda harus terlebih dahulu menambahkan file media dengan memanggil operasi AddMedia.
• Operasi ini hanya dapat digunakan untuk menanyakan file media yang telah diproses dalam alur kerja. Untuk mendapatkan informasi lengkap tentang file media yang baru diunggah ke OSS, Anda dapat memanggil operasi ini setelah alur kerja terkait selesai. Jika file media tidak diproses dalam alur kerja, Anda harus mengirim pekerjaan analisis informasi media dengan memanggil operasi SubmitMediaInfoJob. Setelah pekerjaan tersebut selesai, informasi file media tersebut dapat ditanyakan.

Batas QPS

Anda dapat memanggil operasi API ini hingga 100 kali per detik per akun. Jika jumlah panggilan per detik melebihi batas, Pembatasan kecepatan akan dipicu, yang berpotensi mengganggu bisnis Anda. Oleh karena itu, pastikan Anda memperhatikan batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.

Parameter permintaan

Parameter respons

Contoh

Contoh permintaan

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryMediaListByURL
&FileURLs=http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example.mp4
&IncludePlayList=true
&IncludeSnapshotList=true
&IncludeMediaInfo=true
&IncludeSummaryList=true
&<Common request parameters>

Contoh respons sukses

XML format

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

<QueryMediaListByURLResponse>
    <MediaList>
        <CreationTime>2021-07-14T13:05:00Z</CreationTime>
        <CateId>123</CateId>
        <Height>360</Height>
        <CensorState>Initiated</CensorState>
        <Tags>tag1,tag2</Tags>
        <PlayList>
            <Encryption>1</Encryption>
            <Height>10</Height>
            <Bitrate>25.067</Bitrate>
            <File>
                <State>Normal</State>
                <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4l-test/in/1.mp4</URL>
            </File>
            <MediaWorkflowId>6cc3aa66d1cb4bb2adf14e726c0a****</MediaWorkflowId>
            <Width>11</Width>
            <Size>100</Size>
            <Fps>25.0</Fps>
            <Duration>7.965000</Duration>
            <ActivityName>test name</ActivityName>
            <Format>mov</Format>
            <MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
        </PlayList>
        <Bitrate>593.192</Bitrate>
        <MediaId>52d7e98b05e648199612290bb819****</MediaId>
        <File>
            <State>Normal</State>
            <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
        </File>
        <SummaryList>
            <Type>Gif</Type>
            <MediaWorkflowId>93ab850b4f6f44eab54b6e91d24d****</MediaWorkflowId>
            <ActivityName>example-activity-****</ActivityName>
            <MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
            <File>
                <State>Normal</State>
                <URL>http://example-bucket-****.o</URL>
            </File>
        </SummaryList>
        <PublishState>Published</PublishState>
        <MediaInfo>
            <Streams>
                <VideoStreamList>
                    <Sar>1:1</Sar>
                    <Height>360</Height>
                    <CodecTagString>avc1</CodecTagString>
                    <NetworkCost>
                        <PreloadTime>0.01</PreloadTime>
                        <AvgBitrate>2659.326</AvgBitrate>
                        <CostBandwidth>100</CostBandwidth>
                    </NetworkCost>
                    <Width>640</Width>
                    <Index>5</Index>
                    <Timebase>1/15360</Timebase>
                    <AvgFPS>15.0</AvgFPS>
                    <PixFmt>yuv420p</PixFmt>
                    <Lang>und</Lang>
                    <CodecLongName>H.264/AVC/MPEG-4 AVC/MPEG-4 part 10</CodecLongName>
                    <NumFrames>12</NumFrames>
                    <Rotate>90</Rotate>
                    <Bitrate>512.701</Bitrate>
                    <HasBFrames>2</HasBFrames>
                    <Profile>High</Profile>
                    <StartTime>0.046029</StartTime>
                    <Dar>16:9</Dar>
                    <CodecName>H264</CodecName>
                    <Duration>79.200000</Duration>
                    <Fps>15.0</Fps>
                    <CodecTag>0x31637661</CodecTag>
                    <CodecTimeBase>1/30</CodecTimeBase>
                    <Level>31</Level>
                </VideoStreamList>
                <AudioStreamList>
                    <Timebase>1/44100</Timebase>
                    <Index>1</Index>
                    <SampleFmt>fltp</SampleFmt>
                    <ChannelLayout>stereo</ChannelLayout>
                    <Lang>und</Lang>
                    <Samplerate>44100</Samplerate>
                    <CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
                    <Channels>2</Channels>
                    <NumFrames>100</NumFrames>
                    <Bitrate>76.356</Bitrate>
                    <CodecTagString>mp4a</CodecTagString>
                    <StartTime>0.000000</StartTime>
                    <CodecName>aac</CodecName>
                    <Duration>79.203265</Duration>
                    <CodecTag>0x6134706d</CodecTag>
                    <CodecTimeBase>1/44100</CodecTimeBase>
                </AudioStreamList>
                <SubtitleStreamList>
                    <Index>1</Index>
                    <Lang>und</Lang>
                </SubtitleStreamList>
            </Streams>
            <Format>
                <StartTime>0.000000</StartTime>
                <NumPrograms>0</NumPrograms>
                <Size>5872904</Size>
                <NumStreams>2</NumStreams>
                <FormatLongName>QuickTime/MOV</FormatLongName>
                <Duration>79.204000</Duration>
                <Bitrate>593.192</Bitrate>
                <FormatName>mov</FormatName>
            </Format>
        </MediaInfo>
        <Description>This is description ****</Description>
        <Size>5872904</Size>
        <Width>640</Width>
        <CoverURL>http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png</CoverURL>
        <SnapshotList>
            <Type>Single</Type>
            <MediaWorkflowId>6cc3aa66d1cb4bb2adf14e726c0a****</MediaWorkflowId>
            <ActivityName>example-activity1-****</ActivityName>
            <Count>3</Count>
            <MediaWorkflowName>example-workflow-****</MediaWorkflowName>
            <File>
                <State>Normal</State>
                <URL>http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png</URL>
            </File>
        </SnapshotList>
        <RunIdList>9343bd0e7bb54ae19228529908e5****</RunIdList>
        <Duration>79.204000</Duration>
        <Fps>15.0</Fps>
        <Title>kled.mp4</Title>
        <Format>mov</Format>
    </MediaList>
    <NonExistFileURLs>null</NonExistFileURLs>
    <RequestId>1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42</RequestId>
</QueryMediaListByURLResponse>

JSON format

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

{
  "MediaList" : [ {
    "CreationTime" : "2021-07-14T13:05:00Z",
    "CateId" : 123,
    "Height" : "360",
    "CensorState" : "Initiated",
    "Tags" : [ "tag1,tag2" ],
    "PlayList" : [ {
      "Encryption" : "1",
      "Height" : "10",
      "Bitrate" : "25.067",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4l-test/in/1.mp4"
      },
      "MediaWorkflowId" : "6cc3aa66d1cb4bb2adf14e726c0a****",
      "Width" : "11",
      "Size" : "100",
      "Fps" : "25.0",
      "Duration" : "7.965000",
      "ActivityName" : "test name",
      "Format" : "mov",
      "MediaWorkflowName" : "example-mediaworkflow-****"
    } ],
    "Bitrate" : "593.192",
    "MediaId" : "52d7e98b05e648199612290bb819****",
    "File" : {
      "State" : "Normal",
      "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
    },
    "SummaryList" : [ {
      "Type" : "Gif",
      "MediaWorkflowId" : "93ab850b4f6f44eab54b6e91d24d****",
      "ActivityName" : "example-activity-****",
      "MediaWorkflowName" : "example-mediaworkflow-****",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example-bucket-****.o"
      }
    } ],
    "PublishState" : "Published",
    "MediaInfo" : {
      "Streams" : {
        "VideoStreamList" : [ {
          "Sar" : "1:1",
          "Height" : "360",
          "CodecTagString" : "avc1",
          "NetworkCost" : {
            "PreloadTime" : "0.01",
            "AvgBitrate" : "2659.326",
            "CostBandwidth" : "100"
          },
          "Width" : "640",
          "Index" : "5",
          "Timebase" : "1/15360",
          "AvgFPS" : "15.0",
          "PixFmt" : "yuv420p",
          "Lang" : "und",
          "CodecLongName" : "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
          "NumFrames" : "12",
          "Rotate" : "90",
          "Bitrate" : "512.701",
          "HasBFrames" : "2",
          "Profile" : "High",
          "StartTime" : "0.046029",
          "Dar" : "16:9",
          "CodecName" : "H264",
          "Duration" : "79.200000",
          "Fps" : "15.0",
          "CodecTag" : "0x31637661",
          "CodecTimeBase" : "1/30",
          "Level" : "31"
        } ],
        "AudioStreamList" : [ {
          "Timebase" : "1/44100",
          "Index" : "1",
          "SampleFmt" : "fltp",
          "ChannelLayout" : "stereo",
          "Lang" : "und",
          "Samplerate" : "44100",
          "CodecLongName" : "AAC (Advanced Audio Coding)",
          "Channels" : "2",
          "NumFrames" : "100",
          "Bitrate" : "76.356",
          "CodecTagString" : "mp4a",
          "StartTime" : "0.000000",
          "CodecName" : "aac",
          "Duration" : "79.203265",
          "CodecTag" : "0x6134706d",
          "CodecTimeBase" : "1/44100"
        } ],
        "SubtitleStreamList" : [ {
          "Index" : "1",
          "Lang" : "und"
        } ]
      },
      "Format" : {
        "StartTime" : "0.000000",
        "NumPrograms" : "0",
        "Size" : "5872904",
        "NumStreams" : "2",
        "FormatLongName" : "QuickTime/MOV",
        "Duration" : "79.204000",
        "Bitrate" : "593.192",
        "FormatName" : "mov"
      }
    },
    "Description" : "This is description ****",
    "Size" : "5872904",
    "Width" : "640",
    "CoverURL" : "http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png",
    "SnapshotList" : [ {
      "Type" : "Single",
      "MediaWorkflowId" : "6cc3aa66d1cb4bb2adf14e726c0a****",
      "ActivityName" : "example-activity1-****",
      "Count" : "3",
      "MediaWorkflowName" : "example-workflow-****",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png"
      }
    } ],
    "RunIdList" : [ "9343bd0e7bb54ae19228529908e5****" ],
    "Duration" : "79.204000",
    "Fps" : "15.0",
    "Title" : "kled.mp4",
    "Format" : "mov"
  } ],
  "NonExistFileURLs" : [ "null" ],
  "RequestId" : "1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42"
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi Error Center.