查询在线录制任务接口

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

查询在线录制任务接口(ListRecordingTasks)

描述

此接口用于查询在线录制任务的情况;

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

请求示例

参数名 类型 是否必须 描述
Action String Y 操作接口名,取值:ListRecordingTasks
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
RecStatusType Int N 录制任务状态,1:已建立的任务,2:实时录制任务,默认0,全部返回

返回参数

参数名 类型 描述
UniqueName String 域名标识
App String 应用名
Pubdomain String 推流域名
Count Int 返回记录数
OrderTime Int 排序类型,0:从最新的录制任务开始,1:从后向前
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正在录制
RetCode Int 响应码 0成功 其他失败
RetMsg String 错误信息

请求示例

GET /?Action=ListRecordingTasks&Version=2017-01-01&UniqueName=xxx&App=xxx&Pubdomain=xxx.xxx.com&OrderTime=1&RecType=0 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",
    "Count": 2,
    "OrderTime": 1,
    "Pubdomain": "xxx.xxx.com",
    "RecType": 0,
    "Recs": 
    [  
      {
        "Bucket": "xxx",
        "Duration": 0,
        "EndUnixTime": 1490518500,
        "Ks3FullPathM3U8": "http://xxx.xxx.xxx.com/record/live/zyh/hls/a_m3u8_1490518500_zyh.m3u8?Expires=xxx&AWSAccessKeyId=xxx&Signature=xxx",
        "Ks3FullPathMP4": "http://xxx.xxx.xxx.com/record-1/test/live/xxx.xxx.com/zyh/mp4/zyh-1490518500-2017-03-26-16-55-00-activity.mp4?Expires=xxx&AWSAccessKeyId=xxx&Signature=xxx",
        "RecID": 99,
        "RecStatus": 2,
        "RecType": 1,
        "StartUnixTime": 1490518200,
        "Stream": "xxx"
      },
      {
        "Bucket": "xxx",
        "Duration": 0,
        "EndUnixTime": 1490709000,
        "FailDetail": 0,
        "Ks3FullPathM3U8": "http://xxx.xxx.xxx.com/record/live/zyh1/hls/a_m3u8_1490518500_zyh1.m3u8?Expires=xxx&AWSAccessKeyId=xxx&Signature=xxx",
        "Ks3FullPathMP4": "http://xxx.xxx.xxx.com/record-1/test/live/xxx.xxx.com/zyh1/mp4/zyh1-1490518500-2017-03-26-16-55-00-activity.mp4?Expires=xxx&AWSAccessKeyId=xxx&Signature=xxx",
        "RecID": 206,
        "RecStatus": 2,
        "RecType": 1,
        "StartUnixTime": 1490708880,
        "Stream": "zyh1"
      }
    ],
    "RetCode": 0,
    "RetMsg": "success",
    "Total": 3,
    "UniqueName": "xxx"
  }
}

错误码

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

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

免费注册