调用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地址。

说明 如果设置此参数，则必须设置请求参数NeedStatusNotify。
  • 必须以http://或https://开头。
  • 为了正常识别输入的汉字、空格以及其他特殊字符，需要做URLEncoder编码。
OnDemandUrl String 否 http://guide.aliyundoc.com/ondemandcallback.action

按需回调URL地址。

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

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

说明 如果设置了请求参数NotifyUrl（录制回调URL地址），此参数必填。

取值：

  • true：是。如果此参数取值为true，则需要录制任务状态回调。
  • false（默认值）：否。如果此参数取值为false，则不需要录制任务状态回调。

返回数据

名称 类型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD

请求ID。

示例

请求示例

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

正常返回示例

XML格式 

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

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. 配置错误，请您确认该配置是否正确。

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