查询历史录制任务接口

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

查询历史录制任务接口(ListHistoryRecordTasks)

描述

此接口用于查询历史录制任务的完成情况;

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

历史记录:1个月内;

请求参数

参数名 类型 是否必须 描述
Action String Y 操作接口名,取值:ListHistoryRecordTasks
Version String Y 版本号,取值:2017-01-01
UniqueName String Y 域名标识
App String Y 应用名
Pubdomain String Y 推流域名
Stream String N 流名
RecType Int N 录像类型,1:定时录制,2:短视频,默认值为0,全部返回
Limit Int N 返回条数
Marker Int N 记录返回位置
OrderTime Int N 排序类型(0:从最新的录制任务开始,1:从后向前),默认为0
StartUnixTime Int N 查询开始时间;默认当前时间1小时前
EndUnixTime Int N 查询结束时间,默认当前时间;开始和结束时间限制是录制任务完成的时间

返回参数

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

请求示例

GET /?Action=ListHistoryRecordTasks&Version=2017-01-01&UniqueName=xxx&App=xxx&Pubdomain=xxx.xxx.xxx.com&StartUnixTime=1490198400&EndUnixTime=1490339938&OrderTime=1&RecType=1&Marker=2&Limit=2 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": "live",
    "Count": 2,
    "OrderTime": 1,
    "Pubdomain": "xxx.xxx.xxx.com",
    "RecType": 1,
    "Recs": 
    [ 
      {
        "Bucket": "xxx",
        "Duration": 240,
        "EndUnixTime": 1490267100,
        "FailDetail": 6000,
        "Ks3FullPathM3U8": "http://xxx.xxx.xxx.com/record/live/zyh/hls/This_is_m3u8_1490267100_zyh.m3u8?Expires=xxx&AWSAccessKeyId=xxx&Signature=xxx",
        "Ks3FullPathMP4": "http://xxx.xxx.xxx.com/record-1/qa-ws/live/xxx.xxx.xxx.com/zyh/mp4/zyh-1490267100-2017-03-23-19-05-00-activity.mp4?Expires=xxx&AWSAccessKeyId=xxx&Signature=xxx",
        "RecID": 82,
        "RecStatus": 4,
        "RecType": 1,
        "StartUnixTime": 1490266860,
        "Stream": "zyh"
      },
      {
        "Bucket": "xxx",
        "Duration": 180,
        "EndUnixTime": 1490268360,
        "FailDetail": 0,
        "Ks3FullPathM3U8": "http://xxx.xxx.xxx.com/record/live/zyh1/hls/This_is_m3u8_1490267100_zyh1.m3u8?Expires=xxx&AWSAccessKeyId=xxx&Signature=xxx",
        "Ks3FullPathMP4": "http://xxx.xxx.xxx.com/record-1/qa-ws/live/xxx.xxx.xxx.com/zyh1/mp4/zyh1-1490267100-2017-03-23-19-05-00-activity.mp4?Expires=xxx&AWSAccessKeyId=xxx&Signature=xxx",
        "RecID": 83,
        "RecStatus": 3,
        "RecType": 1,
        "StartUnixTime": 1490268180,
        "Stream": "zyh1"
      }
    ],
    "RetCode": 0,
    "RetMsg": "success",
    "Total": 7,
    "UniqueName": "xxx"
  }
}

错误码

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

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

免费注册