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暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
MediaIds	string	是	媒体ID，即音/视频ID（VideoId）。多个ID之间使用半角逗号（,）分隔，最多支持20个。可通过以下方式获取：通过控制台上传的音/视频，可登录点播控制台，选择媒资库 > 音/视频查看音/视频ID。通过获取音视频上传地址和凭证接口获取上传地址和凭证时，为返回参数VideoId的值。音/视频上传后，可通过搜索媒体信息接口查询，为请求后返回参数VideoId的值。	61ccbdb06fa83012be4d8083f6**,7d2fbc380b0e08e55f**
MediaType	string	否	媒体类型。取固定值：video（音/视频）。	video

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求ID。	9E290613-04F4-47F4-795D30732077****
ForbiddenMediaIds	array	禁止访问的媒体ID。
	string	禁止访问的媒体ID。	7d2fbc380b0e08e55f****
NonExistMediaIds	array	不存在的媒体ID。
	string	不存在的媒体ID。	dfsg****
UploadDetails	array	上传详情列表。
	object	返回结果详情。
Status	string	视频状态。具体的视频状态取值及描述，请参见Status：视频状态的取值列表。	Uploading
CreationTime	string	创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。	2019-04-28T09:42:07Z
UploadSource	string	上传资源。	WebSDK
UploadIP	string	上传IP地址。	192.168.0.1
DeviceModel	string	设备模型。	Chrome
ModificationTime	string	更新时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。	2019-04-28T09:43:12Z
CompletionTime	string	完成时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。	2019-04-28T09:45:07Z
MediaId	string	上传的音/视频ID。	61ccbdb06fa83012be4d8083f6****
UploadSize	Long	上传大小。单位：字节。	346
UploadRatio	number	上传比率。	0.038
UploadStatus	string	上传任务状态。具体的上传状态取值及描述，请参见Status：URL上传任务状态的取值列表。	Uploading
Title	string	标题。	测试文件上传详情
FileSize	Long	文件大小。单位：字节。	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.MediaIds	The input parameter “MediaIds” Exceed the limit.	400	媒资ID数量超过上限20个。