更新直播录制回调配置

更新时间: 2023-10-12 16:27:45

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

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

阿里云首页 视频直播 相关技术圈