UpdateLiveAppSnapshotConfig - 更新直播截图配置_视频直播(LIVE)-阿里云帮助中心

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

接口说明

调用本接口更新播流下的截图配置。输出内容保存到 OSS 中，重新推流后生效。

本接口的单用户 QPS 限制为 30 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。

当前API暂无授权信息透出。

名称	类型	必填	描述	示例值

名称	类型	必填	描述	示例值
DomainName	string	是	主播流域名。	example.com
AppName	string	是	播流所属应用名称。	liveApp****
TimeInterval	integer	否	截图周期。取值范围：5~3600。单位：秒。	5
OssEndpoint	string	否	OSS 存储的 Endpoint 名称。	cn-oss-****.aliyuncs.com
OssBucket	string	否	OSS 存储 Bucket 名称。	liveBucket****
OverwriteOssObject	string	否	覆盖截图存储文件名。每次截图都覆盖此文件。小于 256 Byte。目前仅支持生成 JPG 图片。支持变量匹配，包含 {AppName}、{StreamName}。传入短划线（-），表示删除此字段。	{liveApp**}/{liveStream**}.jpg
SequenceOssObject	string	否	实时截图存储文件名。每次截图都递增存储，调用 DescribeLiveStreamSnapshotInfo 接口，可以查询某一段时间的文件。小于 256 Byte。目前仅支持生成 JPG 图片。支持变量匹配，包含 {AppName}、{StreamName}、{UnixTimestamp}、{Sequence}，其中 {UnixTimestamp}、{Sequence} 必填一个。传入短划线（-），表示删除此字段。	snapshot/{liveApp**}/{liveStream}/{UnixTimestamp**}.jpg
Callback	string	否	截图回调地址。	https://learn.aliyundoc.com

名称	类型	描述	示例值

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

正常返回示例

JSON格式

        
{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

HTTP status code	错误码	错误信息	描述

HTTP status code	错误码	错误信息	描述
400	InvalidOverwriteOssObjectOrSequenceOssObject.Malformed	Specified paramters OverwriteOssObject or SequenceOssObject should have one.	OverwriteOssObject与SequenceOssObject参数任选其一。
400	InvalidOssEndpoint.Malformed	Specified parameter OssEndpoint is not valid.	OSSEndpoint参数错误，请您确认该OSSEndpoint参数是否正确。
400	InvalidOssBucket.Malformed	Specified parameter OssBucket is not valid.	OSSBucket参数错误，请您确认该OSS BUCKET参数是否正确。
400	InvalidOssBucket.NotFound	The parameter OssBucket does not exist.	OSSBucket参数错误，请您确认该OSS BUCKET参数是否正确。
400	InvalidOverwriteOssObject.Malformed	Specified parameter OverwriteOssObject is not valid.	OverwriteOSSObject参数错误，请您确认该OverwriteOSSObject参数是否正确。
400	InvalidSequenceOssObject.Malformed	Specified parameter SequenceOssObject is not valid.	SequenceOssObject参数错误，请您确认该SequenceOssObject参数是否正确。
400	InvalidConfig.NotFound	The speicified config does not exist.	OssBucket错误，请您确认该OssBucket是否正确。

访问错误中心查看更多错误码。

变更时间	变更内容概要	操作

变更时间	变更内容概要	操作

暂无变更历史