全部产品
Search
文档中心

视频直播:更新直播录制回调配置

更新时间:Oct 12, 2023

调用UpdateLiveRecordNotifyConfig更新域名级别录制回调配置。

使用说明

更新域名级别录制回调配置时,您可以修改以下内容:

  • 录制回调(包括录制文件生成事件回调、录制任务状态回调)URL地址。更多详情,请参见录制事件回调
  • 按需录制回调URL地址。更多详情,请参见按需录制回调
  • 是否需要录制任务状态回调。

QPS限制

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

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String UpdateLiveRecordNotifyConfig

系统规定参数。取值:UpdateLiveRecordNotifyConfig

DomainName String example.com

主播流域名。

NotifyUrl String http://learn.aliyundoc.com/examplecallback.action

录制回调(包括事件回调和状态回调)URL地址。

说明
  • 必须以http://https://开头。
  • 为了正常识别输入的汉字、空格以及其他特殊字符,需要做URLEncoder编码。
OnDemandUrl String http://guide.aliyundoc.com/ondemandcallback.action

按需回调URL地址。

说明
  • 必须以http://https://开头。
  • 为了正常识别输入的汉字、空格以及其他特殊字符,需要做URLEncoder编码。
NeedStatusNotify Boolean false

是否需要录制任务状态回调。取值:

  • true:需要录制任务状态回调。
  • false(默认值):不需要录制任务状态回调。

返回数据

名称

类型

示例值

描述

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

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=UpdateLiveRecordNotifyConfig
&DomainName=example.com
&<公共请求参数>

正常返回示例

XML格式

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

<?xml version="1.0" encoding="UTF-8" ?>
<UpdateLiveRecordNotifyConfigResponse>
	<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</UpdateLiveRecordNotifyConfigResponse>

JSON格式

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

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

错误码

HttpCode

错误码

错误信息

描述

400 InvalidNotifyUrl.Malformed Specified NotifyUrl is invalid. 指定的notifyurl错误,请您确认该notifyurl参数是否正确。
400 InvalidNotifyUrl.Unsafe Specified NotifyUrl is not safe. 指定的notifyurl错误,请您确认该notifyurl参数是否正确。
404 InvalidConfig.NotFound Config does not exist. 配置错误,请您确认该配置是否正确。

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