edit-icon download-icon

QueryMediaList

Last Updated: Apr 19, 2018

Description

The QueryMediaList API queries media sets by media IDs.

Request parameters

Parameter Type Required or not Description
Action String Yes API of the action, system required parameter. Set this parameter to QueryMediaList.
MediaIds String Yes A list of file names separated by commas (,). A maximum of 10 file names can be entered.
IncludePlayList Boolean No Whether the results contain a playlist. Optional values: True/False; default value: False.
IncludeSnapshotList Boolean No Whether the results contain a screenshot list. Optional values: True/False; default value: False.
IncludeMediaInfo Boolean No Whether the results contain media information. Optional values: True/False; default value: False.

Return parameters

Name Type Description
MediaList Media[] Media list
NonExistMediaIds String[] A list of nonexistent media IDs

Example

Request example

  1. http://mts.cn-hangzhou.aliyuncs.com?MediaIds=3e1cd21131a94525be55acf65888bf46&<public parameter>

Return example

XML

  1. <QueryMediaListResponse>
  2. <NonExistMediaIds/>
  3. <MediaList>
  4. <Media>
  5. <CoverURL>http://zzyoutputbucket.oss-cn-hangzhou.aliyuncs.com/47b42486019c4f688bf144c1a6ba059a%2F0.jpg</CoverURL>
  6. <Format>mov,mp4,m4a,3gp,3g2,mj2</Format>
  7. <PublishState>Published</PublishState>
  8. <File>
  9. <State>Normal</State>
  10. <URL>http://zzzinput-test.oss-cn-hangzhou.aliyuncs.com/output-2016-01-07-09%3A37%3A17.mp485191.mp4</URL>
  11. </File>
  12. <Height>1080</Height>
  13. <MediaId>3e1cd21131a94525be55acf65888bf46</MediaId>
  14. <Title>output-2016-01-07-09:37:17.mp485191.mp4</Title>
  15. <CreationTime>2016-09-14T08:30:33Z</CreationTime>
  16. <RunIdList>
  17. <RunId>47b42486019c4f688bf144c1a6ba059a</RunId>
  18. </RunIdList>
  19. <CateId>0</CateId>
  20. <MediaInfo>
  21. <Format/>
  22. <Streams/>
  23. </MediaInfo>
  24. <Duration>7.965000</Duration>
  25. <Width>1920</Width>
  26. <Fps>25.0</Fps>
  27. <Bitrate>2659.326</Bitrate>
  28. <Size>2647692</Size>
  29. </Media>
  30. </MediaList>
  31. <RequestId>2F6D69DE-DAD0-4D8A-BB2C-DACAE76D60E3</RequestId>
  32. </QueryMediaListResponse>

JSON

  1. {
  2. "NonExistMediaIds": {
  3. "MediaId": [ ]
  4. },
  5. "MediaList": {
  6. "Media": [
  7. {
  8. "CoverURL": "http://zzyoutputbucket.oss-cn-hangzhou.aliyuncs.com/47b42486019c4f688bf144c1a6ba059a%2F0.jpg",
  9. "Format": "mov,mp4,m4a,3gp,3g2,mj2",
  10. "PublishState": "Published",
  11. "File": {
  12. "State": "Normal",
  13. "URL": "http://zzzinput-test.oss-cn-hangzhou.aliyuncs.com/output-2016-01-07-09%3A37%3A17.mp485191.mp4"
  14. },
  15. "Height": "1080",
  16. "MediaId": "3e1cd21131a94525be55acf65888bf46",
  17. "Title": "output-2016-01-07-09:37:17.mp485191.mp4",
  18. "CreationTime": "2016-09-14T08:30:33Z",
  19. "RunIdList": {
  20. "RunId": [
  21. "47b42486019c4f688bf144c1a6ba059a"
  22. ]
  23. },
  24. "CateId": 0,
  25. "MediaInfo": {
  26. "Format": { },
  27. "Streams": { }
  28. },
  29. "Duration": "7.965000",
  30. "Width": "1920",
  31. "Fps": "25.0",
  32. "Bitrate": "2659.326",
  33. "Size": "2647692"
  34. }
  35. ]
  36. },
  37. "RequestId": "F1C8B6C4-1E47-4423-9BC8-2F5DDBD892DC"
  38. }
Thank you! We've received your feedback.