查询录像任务状态接口

最近更新时间:2020-10-29 19:36:27

查询录像任务状态接口(GetRecordTask)

描述

此接口用于查询某个录制任务ID的任务进行情况;

目前只支持查询短视频和定时录像任务。

请求参数

参数名 类型 是否必须 描述
Action String Y 操作接口名,取值:GetRecordTask
Version String Y 版本号,取值:2017-01-01
RecID Int Y 录制任务ID

返回参数

参数名 类型 描述
UniqueName String 域名标识
App String 应用名
Pubdomain String 推流域名
Stream String 流名
RecID String 录像任务ID
RecType Int 录像类型,1:定时录制,2:短视频
Bucket String KS3存储bucket
StartUnixTime Int 录制开始时间
EndUnixTime Int 录制结束时间
Duration Unsignedint 录制时长
Ks3FullPathM3U8 String M3U8文件全路径
Ks3FullPathMP4 String MP4文件全路径
RecStatus Int 录制任务状态,1:任务建立, 2正在录制,3:录制成功,4:录制失败
RetCode Int 响应码 0成功 其他失败
RetMsg String 错误信息

请求示例

GET /?Action=GetRecordTask&Version=2017-01-01&RecID=67 HTTP/1.1 
Content-Type: application/json
X-Amz-Date: YOURDATE
Authorization: AWS4-HMAC-SHA256 Credential=YOURAK/YYYYMMDD/cn-beijing-6/kls/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=SIG
Host: kls.api.ksyun.com

返回示例

{
  "Data": 
  {
    "App": "xxx",
    "Bucket": "xxx",
    "Duration": 600,
    "EndUnixTime": 1.490238508e+09,
    "FailDetail": 6008,
    "Ks3FullPathM3U8": "http://xxx.xxx.xxx.com/record/live/ljh/hls/xxx.xxx.com-ljh-1490238508-2017-03-23-11-08-28-28.m3u8??Expires=xxx&AWSAccessKeyId=xxx&Signature=xxx",
    "Ks3FullPathMP4": "http://qa-vod.ks3-cn-beijing.ksyun.com/record/qa-ws/live/qa-ws.test-uplive.ks-cdn.com/yh667/mp4/yh667-1490238508-2017-03-23-11-08-28-micro.mp4?Expires=xxx&AWSAccessKeyId=xxx&Signature=xxx",
    "Pubdomain": "xxx.xxxx.com",
    "RecID": 67,
    "RecStatus": 3,
    "RecType": 2,
    "RetCode": 0,
    "RetMsg": "success",
    "StartUnixTime": 1.490237908e+09,
    "Stream": "ljh",
    "UniqueName": "xxx"
  }
}

错误码

为了帮您快速定位问题,云直播将错误码集中归类,请到错误码中心查看详情。

金山云,开启您的云计算之旅

免费注册