全部产品
视频直播

更新截图配置

更新时间:2017-09-19 11:33:12   分享:   

描述

更新直播流下的 AppName 截图配置,输出内容保存到 OSS 中,重新推流生效。

请求参数

参数 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:UpdateLiveAppSnapshotConfig。
DomainName String 您的加速域名。
AppName String 直播流所属应用名称,支持*号,代表该域名下所以的 AppName。
TimeInterval Integer 截图周期,范围:5~3600,单位秒。
OSSEndpoint String OSS endpoint。
OSSBucket String OSS 存储 bucket 名称。
OverwriteOSSObject String OSS 存储文件名,每次截图都覆盖此文件,小于 256byte,目前仅支持生成 jpg 图片,支持变量匹配,包含 {AppName}、{StreamName},如:{AppName}/{StreamName}.jpg,传入-,表示删除此字段。
SequenceOSSObject String OSS 存储文件名,每次截图都递增存储,DescribeLiveStreamSnapshotInfo接口查询一段时间的文件,小于 256byte,目前仅支持生成 jpg 图片,支持变量匹配,包含 {AppName}、{StreamName}、{UnixTimestamp}、{Sequence},其中 {UnixTimestamp}、{Sequence} 必填一个,如:snapshot/{AppName}/{StreamName}/{UnixTimestamp}.jpg,传入-,表示删除此字段。

返回参数

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

特殊错误码

错误代码 描述 Http 状态码 语义
InvalidOSSEndpoint.Malformed Specified parameter OSSEndpoint is invalid. 400 OSSEndpoint 参数不合法
InvalidOSSBucket.Malformed Specified parameter OSSBucket is invalid. 400 OSSBucket 参数不合法
InvalidTimeInterval Specified parameter TimeInterval is invalid. 400 TimeInterval 参数不合法
InvalidOverwriteOSSObject.Malformed Specified parameter OverwriteOSSObject is invalid. 400 OverwriteOSSObject 参数不合法
InvalidSequenceOSSObject.Malformed Specified parameter SequenceOSSObject is invalid. 400 SequenceOSSObject 参数不合法
InvalidOverwriteOSSObjectOrSequenceOSSObject.Malformed Specified paramters OverwriteOSSObject or SequenceOSSObject should have one. 400 两者必须有一个
InvalidOSSBucket.NotFound The parameter OSSBucket does not exist. 400 该 OSSBucket 不存在
InvalidConfig.NotFound The speicified config does not exist. 400 该 OSSBucket 不存在

示例

请求示例:

  1. https://live.aliyuncs.com?Action=UpdateLiveAppSnapshotConfig&DomainName=test101.aliyunlive.com&AppName=xxx&TimeInterval=10&OssEndpoint=endpoint&OssBucket=bucket&OverwriteOssObject=object&SequenceOssObject=object<公共请求参数>

关于公共请求参数详细内容,请参考 公共请求参数

返回示例

JSON格式:

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