获取截图任务列表-GetSnapTaskList

获取截图任务列表

Request Parameters

Parameter nameTypeDescriptionRequired
BeginTimeint查询的开始时间,单位:unix时间戳。如果不传,若没有传结束时间,则为当前时间的前七天。否则为结束时间的前七天。No
EndTimeint查询的结束时间,单位:unix时间戳。如果不传,若没有传开始时间,则为当前时间,否则为开始时间的后七天。EndTime必须为当前时间往前一个月内,也就是支持一个月内的任务查询。No
ProjectIdstring项目编号,未填写则为默认项目No

Response Elements

Parameter nameTypeDescriptionRequired
RetCodeint操作返回码Yes
Actionstring操作名称Yes
TaskListarray任务列表No

SnapTaskInfo

Parameter nameTypeDescriptionRequired
TaskIdstring任务IDYes
SrcUrlstring原始视频url地址Yes
SnapTypestring截图模式,single表示确定时间点单张截图,periodic表示周期截图,dynamic表示为gif截图Yes
ImageNamestring截图输出的文件名。对于周期截图,该字段表示不加后缀的文件名。Yes
ImageFormatstring图片格式类型Yes
ImageCountint截图张数Yes
CreateTimeint任务创建时间,单位:Unix时间戳No
Statusstring任务状态:waiting、processing、finished、failed,分别表示排队中,处理中,处理完成,处理失败。No

Request Example

http(s)://api.ucloud.cn/?Action=GetSnapTaskList

Response Example

{
    "Action": "GetSnapTaskListResponse",
    "TaskList": [
        {
            "Status": "finished",
            "TaskId": "1",
            "SrcUrl": "http://video.ucloud.cn/myvideo.mp4",
            "ImageName": "myvideo.jpg",
            "ImageFormat ": "jpg",
            "SnapType": "periodic",
            "CreateTime": 1496298697,
            "ImageCount": 5
        }
    ],
    "RetCode": 0
}