Modifies the recording callback configurations of a streaming domain.

You can call this operation to modify the following configurations:

  • The callback URL that is used to receive notifications about recording events and status. For more information, see Recording event callbacks.
  • The callback URL for on-demand recordings. For more information, see On-demand recording callbacks.
  • Specifies whether to enable callbacks for recording status.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes UpdateLiveRecordNotifyConfig

The operation that you want to perform. Set the value to UpdateLiveRecordNotifyConfig.

DomainName String Yes live.yourdomain.com

The streaming domain.

NotifyUrl String No http://www.yourdomain.cn/examplecallback.action

The callback URL that is used to receive notifications about recording events and status.

  • The URL must start with http:// or https://.
  • You must use URLEncoder for encoding so that the system can identify Chinese characters, spaces, and special characters.
OnDemandUrl String No http://www.yourdomain.cn/ondemandcallback.action

The callback URL for on-demand recordings.

  • The URL must start with http:// or https://.
  • You must use URLEncoder for encoding so that the system can identify Chinese characters, spaces, and special characters.
NeedStatusNotify Boolean No false

Specifies whether to enable callbacks for recording status. Valid values:

  • true: enables callbacks for recording status.
  • false: disables callbacks for recording status. This is the default value.

Response parameters

Parameter Type Example Description
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD

The ID of the request.

Examples

Sample requests

https://live.aliyuncs.com/?Action=UpdateLiveRecordNotifyConfig
&DomainName=www.yourdomain.com
&<Common request parameters>

Sample success responses

XML format

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

JSON format

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

Error codes

HTTP status code Error code Error message Description
400 InvalidNotifyUrl.Malformed Specified NotifyUrl is invalid. The error message returned because the format of the callback URL is invalid. Check whether the value of the NotifyUrl parameter is correct.
400 InvalidNotifyUrl.Unsafe Specified NotifyUrl is not safe. The error message returned because the callback URL is unsafe. Check whether the value of the NotifyUrl parameter is correct.
404 InvalidConfig.NotFound Config does not exist. The error message returned because no configuration can be found based on the request parameters. Check whether the request parameters are correct.

For a list of error codes, visit the API Error Center.