全部产品
Search
文档中心

视频直播:更新通用转码配置

更新时间:Jul 15, 2024

调用UpdateLiveStreamTranscode更新通用转码配置信息。

使用说明

先通过密钥管理服务KMS获取用户KMS主密钥ID,再调用本接口添加转码配置信息,目前本接口只支持标准质量模板和窄带高清™转码模板两种转码模板。

QPS限制

本接口的单用户QPS限制为30次/秒。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action String UpdateLiveStreamTranscode

系统规定参数。取值:UpdateLiveStreamTranscode

Domain String example.com

主播流域名,不可修改。

App String liveApp****

播流所属应用名称,不可修改。

Template String lsd

转码模版,不可修改。

EncryptParameters String {"EncryptType": "aliyun", "KmsKeyID":"afce5722-81d2-43c3-9930-7601da11****","KmsKeyExpireInterval":"3600"}

加密配置。JSON格式,各字段说明如下:

  • EncryptType:加密类型。固定取值aliyun。
  • KmsKeyID:用户KMS主密钥ID。
  • KmsKeyExpireInterval:换Key周期。取值范围:60~3600,单位:秒。

    说明 当使用DRM加密时,KmsKeyID不可修改。

Lazy String yes

是否开启触发转码。取值:

  • yes:开启触发转码。
  • no:不开启触发转码。

返回数据

名称

类型

示例值

描述

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=UpdateLiveStreamTranscode
&Domain=example.com
&App=liveApp****
&Template=lsd
&EncryptParameters={"EncryptType": "aliyun", "KmsKeyID":"afce5722-81d2-43c3-9930-7601da11****","KmsKeyExpireInterval":"3600"}
&Lazy=yes
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateLiveStreamTranscodeResponse>
    <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</UpdateLiveStreamTranscodeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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