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

使用点播控制台上传视频可获取到上传比例等信息。如果使用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(音视频)。

返回数据

名称 类型 示例值 描述
RequestId String 9E290613-04F4-47*****F4-795D30732077

请求ID。

ForbiddenMediaIds Array of String 7d2fbc380*****b0e08e55f

禁止访问的媒体ID。

NonExistMediaIds Array of String dfsg****

不存在的媒体ID。

UploadDetails Array of UploadDetail

上传详情列表。

Status String UPLOADING

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

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

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

UploadSource String WebSDK

上传资源。

UploadIP String 127.0.0.1

上传IP。

DeviceModel String Chrome

设备模型。

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

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

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

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

MediaId String 61ccbdb06fa*****83012be4d8083f6

上传视频ID。

UploadSize Long 346

上传大小。

UploadRatio Float 0.038

上传比率。

UploadStatus String UPLOADING

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

Title String 测试文件上传详情

标题。

FileSize Long 46

文件大小。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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格式

HTTP/1.1 200 OK
Content-Type:application/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个。