检查任务状态

1. 接口描述

URL http://gX.upload.youku.com/gupload/check
功能描述 查询视频上传过程中的状态。
返回格式 UTF8
HTTP请求方式 GET
授权/登录 false
当前接口版本 V3
其他接口版本

2. 业务参数

参数名 参数类型 必选 默认值 参数描述 示例
upload_token string true create过程返回值

3. 返回参数

参数名 参数类型 允许为空 参数描述 示例
error object true 出错时返回
code int false 错误码
type String false 错误类型
description int false 错误描述
status int true

视频源文件上传状态

1:文件上传完成,并且全部确认写入磁盘

2:文件上传中,全部分片上传任务已经分派,见返回字段transferred_percent

3:文件上传中,所有分片上传任务都已完成,但是依然有的分片还未确认写入磁盘,见返回字段confirmed_percent

4:文件上传中,还有分片上传任务未分配

transferred_percent int false 服务器接收数据百分比,当status=2时有意义
confirmed_percent int false 服务器接收数据并确认写入磁盘百分比,当status=3时有意义
empty_tasks int64 false 未分配的任务,当status=4时有意义
finished/td> boolen false 文件是否全部上传
upload_server_ip string false 上传服务器地址,用于调用#commit 或者 #cancel

4. 响应示例

GET /gupload/new_slice?upload_token=1a2b3c4d
Host:g01.upload.youku.com
----
201 Created
{ "slice_task_id": 1328793281567, "offset": 12358023, "length": 12345, "transferred": 12358023, "finished": false }
             

5. 错误代码

代码 说明
120010205 无效的上传session id
120010211 内部错误: DB error
120010212 内部错误: memory error
120010223 upload token已过期
120010224 错误的请求/td>