The QueryMediaListByURL API queries media sets by OSS file URLs.

Request parameters

Parameters Type Required or not Description
Action String Yes API of the action, system required parameter. Value: QueryMediaListByURL
FileURLs String Yes A list of file URLs,
  • separated by commas (,). A maximum of 10 file URLs can be entered.
  • The URL format follows the RFC 3986 standard. (The URL is encoded by UTF-8 and the reserved characters are URL encoded characters.) A URL consists of up to 3,200 bytes.
IncludePlayList Boolean No Whether the results contain a playlist.
  • Optional values: true or false.
  • Default value: false.
IncludeSnapshotList Boolean No Whether the results contain a screenshot list.
  • Optional values: true or false.
  • Default value: false.
IncludeMediaInfo Boolean No Whether the results contain media information.
  • Optional values: true or false.
  • Default value: false.

Response parameters

Name Type Description
MediaList Media[] Media list
NonExistFileURLs String[] A list of nonexistent media resources

Examples

Request example
http://mts.cn-hangzhou.aliyuncs.com?FileURLs=http%3A%2F%2Fzzzinput-test.oss-cn-hangzhou.aliyuncs.com%2Foutput-2016-01-07-09%253A37%253A17.mp485191.mp4&<public parameter>

Response example

XML
<QueryMediaListByURLResponse>
      <MediaList>
        <Media>
          <CoverURL>http://zzyoutputbucket.oss-cn-hangzhou.aliyuncs.com/47b42486019c4f688bf144c1a6ba059a%2F0.jpg</CoverURL>
          <Format>mov,mp4,m4a,3gp,3g2,mj2</Format>
          <PublishState>Published</PublishState>
          <File>
            <State>Normal</State>
            <URL>http://zzzinput-test.oss-cn-hangzhou.aliyuncs.com/output-2016-01-07-09%3A37%3A17.mp485191.mp4</URL>
          </File>
          <Height>1080</Height>
          <MediaId>3e1cd21131a94525be55acf65888bf46</MediaId>
          <Title>output-2016-01-07-09:37:17.mp485191.mp4</Title>
          <CreationTime>2016-09-14T08:30:33Z</CreationTime>
          <RunIdList>
            <RunId>47b42486019c4f688bf144c1a6ba059a</RunId>
          </RunIdList>
          <CateId>0</CateId>
          <MediaInfo>
            <Format/>
            <Streams/>
          </MediaInfo>
          <Duration>7.965000</Duration>
          <Width>1920</Width>
          <Fps>25.0</Fps>
          <Bitrate>2659.326</Bitrate>
          <Size>2647692</Size>
        </Media>
      </MediaList>
      <RequestId>135F7C8D-1E90-4163-8475-15497039B59D</RequestId>
      <NonExistFileURLs/>
    </QueryMediaListByURLResponse>
JSON
{
        "MediaList": {
            "Media": [
                {
                    "CoverURL": "http://zzyoutputbucket.oss-cn-hangzhou.aliyuncs.com/47b42486019c4f688bf144c1a6ba059a%2F0.jpg", 
                    "Format": "mov,mp4,m4a,3gp,3g2,mj2", 
                    "PublishState": "Published", 
                    "File": {
                        "State": "Normal", 
                        "URL": "http://zzzinput-test.oss-cn-hangzhou.aliyuncs.com/output-2016-01-07-09%3A37%3A17.mp485191.mp4"
                    }, 
                    "Height": "1080", 
                    "MediaId": "3e1cd21131a94525be55acf65888bf46", 
                    "Title": "output-2016-01-07-09:37:17.mp485191.mp4", 
                    "CreationTime": "2016-09-14T08:30:33Z", 
                    "RunIdList": {
                        "RunId": [
                            "47b42486019c4f688bf144c1a6ba059a"
                        ]
                    }, 
                    "CateId": 0, 
                    "MediaInfo": {
                        "Format": { }, 
                        "Streams ":{}
                    }, 
                    "Duration": "7.965000", 
                    "Width": "1920", 
                    "Fps": "25.0", 
                    "Bitrate": "2659.326", 
                    "Size": "2647692"
                }
            ]
        }, 
        "RequestId": "96E71ED6-491D-4515-9AB2-AB06AFF71F70", 
        "NonExistFileURLs": {
            "FileURL": [ ]
        }
    }