GetUploadDetails - 获取媒体上传详情

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

接口说明

使用说明

  • 本接口只支持获取音/视频的上传详情。
  • 通过点播控制台上传的音/视频,则通过本接口可获取到上传比例等信息。如果是使用SDK上传的音/视频,上传SDK的版本需满足以下条件才能通过本接口获取到媒体上传详情:
  • Java上传SDK的版本 ≥ 1.4.4
  • C++上传SDK的版本 ≥ 1.0.0
  • PHP上传SDK的版本 ≥ 1.0.2
  • Python上传SDK的版本 ≥ 1.3.0
  • Web端(JavaScript)上传SDK的版本 ≥ 1.4.0
  • Android上传SDK的版本 ≥ 1.5.0
  • iOS上传SDK的版本 ≥ 1.5.0

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
MediaIdsstring

媒体ID,即音/视频ID(VideoId)。多个ID之间使用半角逗号(,)分隔,最多支持20个。可通过以下方式获取:

61ccbdb06fa83012be4d8083f6****,7d2fbc380b0e08e55f****
MediaTypestring

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

video

返回参数

名称类型描述示例值
object

返回结果。

RequestIdstring

请求ID。

9E290613-04F4-47F4-795D30732077****
ForbiddenMediaIdsarray

禁止访问的媒体ID。

string

禁止访问的媒体ID。

7d2fbc380b0e08e55f****
NonExistMediaIdsarray

不存在的媒体ID。

string

不存在的媒体ID。

dfsg****
UploadDetailsarray

上传详情列表。

object

返回结果详情。

Statusstring

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

Uploading
CreationTimestring

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

2019-04-28T09:42:07Z
UploadSourcestring

上传资源。

WebSDK
UploadIPstring

上传IP地址。

192.168.0.1
DeviceModelstring

设备模型。

Chrome
ModificationTimestring

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

2019-04-28T09:43:12Z
CompletionTimestring

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

2019-04-28T09:45:07Z
MediaIdstring

上传的音/视频ID。

61ccbdb06fa83012be4d8083f6****
UploadSizeLong

上传大小。单位:字节。

346
UploadRationumber

上传比率。

0.038
UploadStatusstring

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

Uploading
Titlestring

标题。

测试文件上传详情
FileSizeLong

文件大小。单位:字节。

46

示例

请求示例

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=GetUploadDetails
&MediaIds=61ccbdb06fa83012be4d8083f6****,7d2fbc380b0e08e55f****
&MediaType=video
&<公共请求参数>

正常返回示例

JSON格式

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

XML格式

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

错误码

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

接口错误码

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

错误代码错误信息HTTP 状态码说明
LimitExceeded.MediaIdsThe input parameter “MediaIds” Exceed the limit.400媒资ID数量超过上限20个。
阿里云首页 视频点播 相关技术圈