调用AddLiveRecordNotifyConfig添加域名级别录制回调配置

使用说明

先查询直播录制回调配置，才能调用本接口添加域名级别录制回调配置。使用API查询直播录制回调配置，请参见查询直播录制回调配置。

QPS限制

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

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	AddLiveRecordNotifyConfig	系统规定参数。取值：AddLiveRecordNotifyConfig。
DomainName	String	是	example.com	主播流域名。
NotifyUrl	String	是	http://demo.aliyundoc.com/examplecallback.action	录制回调（包括录制事件和状态回调） URL地址。说明必须以`http://`或者`https://`开头。更多详情，请参见录制事件回调。
OnDemandUrl	String	否	http://learn.aliyundoc.com/ondemandcallback.action	按需录制回调URL地址。说明必须以`http://`或者`https://`开头。更多详情，请参见按需录制回调文档。
NeedStatusNotify	Boolean	否	false	是否需要录制任务状态回调。取值： true：是。如果NeedStatusNotify（是否需要录制任务状态回调）选择为true，则返回结果为录制状态回调示例。 false（默认值）：否。

返回数据


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

示例

请求示例

https://live.aliyuncs.com/?Action=AddLiveRecordNotifyConfig
&DomainName=example.com
&NotifyUrl=http://demo.aliyundoc.com/examplecallback.action
&<公共请求参数>

正常返回示例

XML格式

<AddLiveRecordNotifyConfigResponse>
	  <RequestId>394966CA-5940-44D7-A1C5-24211C7B07A9</RequestId>
</AddLiveRecordNotifyConfigResponse>

JSON格式

{
    "RequestId": "394966CA-5940-44D7-A1C5-24211C7B07A9"
}

错误码


HttpCode	错误码	错误信息	描述
400	InvalidNotifyUrl.Malformed	Specified NotifyUrl is invalid.	指定的notifyurl错误，请您确认该notifyurl参数是否正确。
400	InvalidNotifyUrl.Unsafe	Specified NotifyUrl is not safe.	指定的notifyurl错误，请您确认该notifyurl参数是否正确。
400	ConfigAlreadyExists	Config has already exist.	配置已添加。

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