全部产品
云市场

获取辅助媒资信息

更新时间:2019-04-25 17:25:33

描述

通过辅助媒资ID(支持批量)获取辅助媒资的基本信息,包括标题、类型、标签、创建时间等。

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值:GetAttachedMediaInfo
MediaIdsString辅助媒资ID。多个用英文逗号分隔,最多支持20个。
AuthTimeoutLong辅助媒资地址过期时间,单位:秒。
如果返回的是CDN加速地址:
  • 只有开启了URL鉴权辅助媒资地址才会定期失效,否则会永久有效。
  • 最小值:1
  • 最大值:无限制
  • 默认值:未设置时,取值为URL鉴权中设置的默认有效时长
如果返回的是OSS源站地址:
  • 只有存储权限为私有,播放地址才会定期失效,否则会永久有效
  • 最小值:1
  • 最大值:为降低源站安全风险,最大值为2592000(即30天)
  • 默认值:未设置时,取值为3600
OutputTypeString输出地址类型。取值范围 :
  • oss(回源地址)
  • cdn(加速地址)
默认为cdn类型。

返回参数

名称类型描述
RequestId String请求ID
NonExistMediaIds String[]不存在的辅助媒资ID。
AttachedMediaList AttachedMediaInfo[]辅助媒资信息列表。

API示例

请求示例

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=GetAttachedMediaInfo&MediaIds =xxxxx,xxxx&Format=JSON&<公共参数>

注意:示例中的“公共参数”参见 公共参数说明文档

返回示例

JSON格式

  1. {
  2. "NonExistMediaIds": ["xxxx", "xxxx"],
  3. "RequestId": "xxxx-xxxx-xxxx-xxxx-xxxx",
  4. "AttachedMediaList": [{
  5. "Status": "Normal",
  6. "Type": "material",
  7. "MediaId": "xxxxxxxxxxxxxxxx",
  8. "Categories": [{
  9. "ParentId": xxxxx,
  10. "Level": 1,
  11. "CateId": xxxx,
  12. "CateName": "xxxx"
  13. }, {
  14. "ParentId": -1,
  15. "Level": 0,
  16. "CateId": xxxx,
  17. "CateName": "xxxx"
  18. }],
  19. "CreationTime": "2019-01-01T10:00:00Z",
  20. "Title": "xxxx",
  21. "ModificationTime": "2019-01-01T10:00:01Z",
  22. "StorageLocation": "xxxx.aliyuncs.com",
  23. "Tags": "标签1,标签2,tag1,tag2,tag3",
  24. "URL": "http://xxxx.com/video/material/xxxx.mat?auth_key=xxxx"
  25. },{
  26. "Status": "Normal",
  27. "Type": "material",
  28. "MediaId": "xxxxxxxxxxxxxxxx",
  29. "Categories": [{
  30. "ParentId": xxxxx,
  31. "Level": 1,
  32. "CateId": xxxx,
  33. "CateName": "xxxx"
  34. }, {
  35. "ParentId": -1,
  36. "Level": 0,
  37. "CateId": xxxx,
  38. "CateName": "xxxx"
  39. }],
  40. "CreationTime": "2019-01-01T10:00:00Z",
  41. "Title": "xxxx",
  42. "ModificationTime": "2019-01-01T10:00:01Z",
  43. "StorageLocation": "xxxx.aliyuncs.com",
  44. "Tags": "标签1,标签2,tag1,tag2,tag3",
  45. "URL": "http://xxxx.com/video/material/xxxx.mat?auth_key=xxxx"
  46. }]
  47. }

错误码

下表列举了本接口特有的错误码。视频点播通用的错误码信息,参见 错误码列表

错误代码错误信息HTTP 状态码说明
ExceededMaxThe input parameter “MediaIds” Exceed the limit400辅助媒资ID超过上限20个。