Queries the recording callback configurations of a streaming domain.

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 DescribeLiveRecordNotifyConfig

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

DomainName String Yes live.yourdomain.com

The main streaming domain.

Response parameters

Parameter Type Example Description
RequestId String 5056369B-D337-499E-B8B7-B761BD37B08A

The ID of the request.

LiveRecordNotifyConfig Struct

The recording callback configurations of the streaming domain.

DomainName String live.yourdomain.com

The main streaming domain.

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

The recording callback URL.

NeedStatusNotify Boolean false

Indicates whether the callbacks for recording status were enabled. Valid values:

  • true: The callbacks for recording status were enabled.
  • false: The callbacks for recording status were disabled. This is the default value.
OnDemandUrl String http://www.yourdomain.cn/ondemandcallback.action

The callback URL for on-demand recordings.

Examples

Sample requests

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

Sample success responses

XML format

<DescribeLiveRecordNotifyConfigResponse>
  <RequestId>5056369B-D337-499E-B8B7-B761BD37B08A</RequestId>
  <LiveRecordNotifyConfig>
        <NeedStatusNotify>false</NeedStatusNotify>
        <OnDemandUrl>http://www.yourdomain.cn/ondemandcallback.action</OnDemandUrl>
        <DomainName>live.yourdomain.com</DomainName>
        <NotifyUrl>http://www.yourdomain.cn/examplecallback.action</NotifyUrl>
  </LiveRecordNotifyConfig>
</DescribeLiveRecordNotifyConfigResponse>

JSON format

{
    "RequestId": "5056369B-D337-499E-B8B7-B761BD37B08A",
    "LiveRecordNotifyConfig": {
        "NeedStatusNotify": "false",
        "OnDemandUrl": "http://www.yourdomain.cn/ondemandcallback.action",
        "DomainName": "live.yourdomain.com",
        "NotifyUrl": "http://www.yourdomain.cn/examplecallback.action"
    }
}

Error codes

HTTP status code Error code Error message Description
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.