更新直播录制回调配置 -

使用说明

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

录制回调（包括录制文件生成事件回调、录制任务状态回调）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.	配置错误，请您确认该配置是否正确。

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