全部产品
视频直播

添加APP录制配置

更新时间:2017-07-05 10:09:16   分享:   

AddLiveAppRecordConfig

描述

配置APP录制,输出内容保存到OSS中

请求参数

参数 类型 必须? 描述
Action String 操作接口名,系统规定参数,取值:AddLiveAppRecordConfig
DomainName String 您的加速域名
AppName String 直播流所属应用名称,支持通配符*,代表该域名下所有的AppName
OssEndpoint String oss endpoint,如:oss-cn-hangzhou.aliyuncs.com。详细请参照oss相关文档
OssBucket String oss存储bucket名称
RecordFormat.n.Format String 格式,目前支持m3u8,flv,mp4周期录制
RecordFormat.n.OssObjectPrefix String oss存储的录制文件名,小于256byte,支持变量匹配,包含{AppName}、{StreamName}、{Sequence}、{StartTime}、{EndTime},如:record/{AppName}/{StreamName}/{Sequence}_{StartTime}_{EndTime}; 参数值必须要有{StartTime}和{EndTime}变量。默认支持1小时周期录制, 最小周期时间15分钟,最多6小时。
RecordFormat.n.SliceOssObjectPrefix String 当format格式是m3u8录制,则需要配置,表示ts切片名称,默认30秒一片,小于256byte,支持变量匹配,包含{AppName}、{StreamName}、{UnixTimestamp}、{Sequence},如:record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}; 参数值必须包含{UnixTimestamp}和{Sequence}变量。
RecordFormat.n.CycleDuration Integer 周期录制时长,单位秒, 不填则默认为1小时

返回参数

名称 类型 描述
RequestId String 该条任务请求ID

特殊错误码

错误代码 描述 Http 状态码 语义
InvalidDomain.NotFound The domain provided does not exist in our records. 404 当前账户下未查到域名
MissingDomainName DomainName is mandatory for this action. 400 缺少DomainName值
MissingAppName AppName is mandatory for this action. 400 缺少AppName值
MissingOssEndpoint OssEndpoint is mandatory for this action. 400 缺少OssEndpoint值
InvalidOssEndpoint.Malformed Specified parameter OssEndpoint is not valid. 400 OssEndpoint参数不合法
MissingOssBucket OssBucket is mandatory for this action. 400 缺少OssBucket值
InvalidOssBucket.Malformed Specified parameter OssBucket is not valid. 400 OssBucket参数不合法
InvalidOssBucket.NotFound The parameter OssBucket does not exist. 400 该ossBucket不存在
MissingRecordFormat RecordFormat is mandatory for this action. 400 缺少RecordFormat值
InvalidFormat.Malformed Specified parameter Format is not valid. 400 Format参数不合法
MissingOssObjectPrefix OssObjectPrefix is mandatory for this action. 400 缺少OssObjectPrefix值
InvalidOssObjectPrefix.Malformed Specified parameter OssObjectPrefix is not valid. 400 OssObjectPrefix参数不合法
InvalidSliceOssObjectPrefix.Malformed Specified parameter SliceOssObjectPrefix is not valid. 400 SliceOssObjectPrefix参数不合法
InvalidCycleDuration.Malformed Specified parameter CycleDuration is not valid. 400 CycleDuration参数不合法
ConfigAlreadyExists Config has already exist. 400 配置已存在
InternalError The request processing has failed due to some unknown error, exception or failure. 500 内部错误

示例

请求示例:

  1. https://live.aliyuncs.com?Action=AddLiveAppRecordConfig&DomainName=live.aliyunlive.com&AppName=xxx&OssEndpoint=oss-cn-hangzhou.aliyuncs.com&OssBucket=bucket&Format.1.Name=flv&Format.1.OssObjectPrefix=record/{AppName}/{StreamName}/{Sequence}&Format.2.Name=mp4&Format.2.OssObjectPrefix=record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}<公共请求参数>

返回示例

JSON格式:

  1. {
  2. "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  3. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?