调用GetUploadDetails获取媒资上传详情(支持批量获取)。

使用点播控制台上传视频可获取到上传比例等信息。如果使用SDK上传,上传SDK的版本需满足以下条件才能获取到:

  • Java上传SDK的版本≥1.4.4
  • C++上传SDK的版本≥1.0.0
  • PHP上传SDK的版本≥1.0.2
  • Python上传SDK的版本≥1.3.0
  • Javascript上传SDK的版本≥1.4.0
  • Android上传SDK的版本≥1.5.0
  • iOS上传SDK的版本≥1.5.0

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetUploadDetails

系统规定参数。取值:GetUploadDetails

MediaIds String 61ccbdb06fa*****83012be4d8083f6,7d2fbc380*****b0e08e55f

媒资ID。多个支持视频ID,请使用英文逗号(,)分隔,最多支持20个。

MediaType String video

媒体类型。取固定值:video(音视频)。

返回数据

名称 类型 示例值 描述
ForbiddenMediaIds List 7d2fbc380*****b0e08e55f

禁止访问的媒体ID。

NonExistMediaIds List dfsg****

不存在的媒体ID。

RequestId String 9E290613-04F4-47*****F4-795D30732077

请求ID。

UploadDetails Array of UploadDetail

上传详情列表。

CompletionTime String 2019-04-28T09:45:07Z

完成时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

CreationTime String 2019-04-28T09:42:07Z

创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

DeviceModel String Chrome

物模型。

FileSize Long 46

文件大小。

MediaId String 61ccbdb06fa*****83012be4d8083f6

上传视频ID。

ModificationTime String 2019-04-28T09:43:12Z

更新时间。格式为:_yyyy-MM-ddTHH:mm:ssZ_(UTC时间)。

Status String UPLOADING

视频状态。具体的视频状态取值及描述,请参见视频状态Status的取值列表。

Title String 测试文件上传详情

标题。

UploadIP String 127.0.0.1

上传IP。

UploadRatio Float 0.038

上传比率。

UploadSize Long 346

上传大小。

UploadSource String WebSDK

上传资源。

UploadStatus String UPLOADING

上传任务状态。具体的上传状态取值及描述,请参见上传任务状态 Status的取值列表

示例

请求示例

https://vod.{ApiRegion}.aliyuncs.com/?Action=GetUploadDetails
&MediaIds=61ccbdb06fa*****83012be4d8083f6,7d2fbc380*****b0e08e55f
&<公共请求参数>

正常返回示例

XML格式

<GetUploadDetailsResponse>
  <NonExistMediaIds>dfsg****</NonExistMediaIds>
  <UploadDetails>
        <DeviceModel>Chrome</DeviceModel>
        <Status>UPLOADING</Status>
        <Title>测试文件上传详情</Title>
        <ModificationTime>2019-04-28T09:43:12Z</ModificationTime>
        <UploadRatio>0.038</UploadRatio>
        <UploadSource>WebSDK</UploadSource>
        <MediaId>61ccbdb06fa*****83012be4d8083f6</MediaId>
        <UploadSize>346</UploadSize>
        <CompletionTime>2019-04-28T09:45:07Z</CompletionTime>
        <UploadStatus>UPLOADING</UploadStatus>
        <CreationTime>2019-04-28T09:42:07Z</CreationTime>
        <UploadIP>127.0.0.1</UploadIP>
        <FileSize>46</FileSize>
  </UploadDetails>
  <RequestId>9E290613-04F4-47*****F4-795D30732077</RequestId>
  <ForbiddenMediaIds>7d2fbc380*****b0e08e55f</ForbiddenMediaIds>
</GetUploadDetailsResponse>

JSON格式

{
	"NonExistMediaIds": "dfsg****",
	"UploadDetails": [{
		"DeviceModel": "Chrome",
		"Status": "UPLOADING",
		"Title": "测试文件上传详情",
		"ModificationTime": "2019-04-28T09:43:12Z",
		"UploadRatio": "0.038",
		"UploadSource": "WebSDK",
		"MediaId": "61ccbdb06fa*****83012be4d8083f6",
		"UploadSize": "346",
		"CompletionTime": "2019-04-28T09:45:07Z",
		"UploadStatus": "UPLOADING",
		"CreationTime": "2019-04-28T09:42:07Z",
		"UploadIP": "127.0.0.1",
		"FileSize": "46"
	}],
	"RequestId": "9E290613-04F4-47*****F4-795D30732077",
	"ForbiddenMediaIds": "7d2fbc380*****b0e08e55f"
}

错误码

访问错误中心查看更多错误码。

接口错误码

下表列举了本接口特有的错误码。

错误代码

错误信息

HTTP 状态码

说明

LimitExceeded.MediaIds

The input parameter “MediaIds” Exceed the limit.

400

媒资ID数量超过上限20个。