查询在线录制任务接口

最近更新时间:2020-05-27 21:10:15

查询在线录制任务接口(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"
  }
}

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

免费注册