全部产品
云市场

获取媒体上传详情

描述

通过媒资ID(支持批量)获取媒资上传详情,如上传时间、已上传比例、上传来源等信息。

已上传比例等详细信息,只有使用点播控制台上传视频或指定版本(Java上传SDK1.4.4版本,C++上传SDK1.0.0版本,PHP上传SDK1.0.2版本,Python上传SDK1.3.0版本,Javascript上传SDK1.4.0版本,Android上传SDK1.5.0版本,iOS上传SDK1.5.0版本)及以上版本的上传SDK上传的视频才能获取到。

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值:GetUploadDetails。
MediaIdsString媒资ID。目前仅支持视频ID。多个用英文逗号分隔,最多支持20个。
MediaTypeString媒体类型。默认为video,取值:video(音视频)。

返回参数

名称类型描述
RequestId String请求ID
NonExistMediaIds String[]不存在的媒体ID
ForbiddenMediaIds String[]禁止访问的媒体ID
UploadDetails UploadDetail[]上传详情列表

API示例

请求示例

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

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

返回示例

JSON格式

  1. {
  2. "UploadDetails": [{
  3. "Status": "Uploading",
  4. "DeviceModel": "Chrome...",
  5. "UploadSource": "WebSDK",
  6. "MediaId": "xxxxxxxxxx",
  7. "UploadStatus": "UPLOADING",
  8. "UploadSize": xxxxx,
  9. "CreationTime": "2019-04-28T09:42:07Z",
  10. "Title": "测试文件上传详情",
  11. "UploadIP": "xx.xx.xx.xx",
  12. "ModificationTime": "2019-04-28T09:43:12Z",
  13. "UploadRatio": 0.038,
  14. "FileSize": xxxxx
  15. }, {
  16. "DeviceModel": "Chrome...",
  17. "Status": "Normal",
  18. "Title": "测试文件上传详情2",
  19. "ModificationTime": "2019-05-06T09:21:36Z",
  20. "UploadRatio": 1.0,
  21. "UploadSource": "WebSDK",
  22. "MediaId": "xxxxxxxxxx",
  23. "CompletionTime": "2019-05-06T09:21:36Z",
  24. "UploadStatus": "UPLOAD_SUCCESS",
  25. "UploadSize": xxxxx,
  26. "CreationTime": "2019-05-06T09:21:32Z",
  27. "UploadIP": "xx.xx.xx.xx",
  28. "FileSize": xxxxx
  29. }],
  30. "RequestId": "9E290613-04F4-4711-9CF4-795D30732077"
  31. }

错误码

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

错误代码错误信息HTTP 状态码说明
LimitExceeded.MediaIdsThe input parameter “MediaIds” Exceed the limit.400媒资ID数量超过上限20个。