Queries the recording callback configurations of a streaming domain.
Usage note
This operation is applicable to the main streaming domains.
QPS limit
A single user can perform a maximum of 50 queries per second (QPS). Throttling is triggered when the number of calls per second exceeds the QPS limit. The throttling may affect your business. Thus, we recommend that you observe the QPS limit on this operation. For more information about what a single user means and the QPS details, see QPS limit on an API operation in ApsaraVideo Live.
Debugging
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 | example.com |
The main streaming domain name. |
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 | example.com |
The main streaming domain name. |
NotifyUrl | String | http://learn.aliyundoc.com/examplecallback.action |
The recording callback URL. |
NeedStatusNotify | Boolean | false |
Indicates whether the callbacks for recording status were enabled. Valid values:
|
OnDemandUrl | String | http://guide.aliyundoc.com/ondemandcallback.action |
The callback URL for on-demand recordings. |
Examples
Sample requests
http(s)://live.aliyuncs.com/?Action=DescribeLiveRecordNotifyConfig
&DomainName=example.com
&<Common request parameters>
Sample success responses
XML
format
<DescribeLiveRecordNotifyConfigResponse>
<RequestId>5056369B-D337-499E-B8B7-B761BD37B08A</RequestId>
<LiveRecordNotifyConfig>
<NeedStatusNotify>false</NeedStatusNotify>
<OnDemandUrl>http://guide.aliyundoc.com/ondemandcallback.action</OnDemandUrl>
<DomainName>example.com</DomainName>
<NotifyUrl>http://learn.aliyundoc.com/examplecallback.action</NotifyUrl>
</LiveRecordNotifyConfig>
</DescribeLiveRecordNotifyConfigResponse>
JSON
format
{
"DescribeLiveRecordNotifyConfigResponse": {
"RequestId": "5056369B-D337-499E-B8B7-B761BD37B08A",
"LiveRecordNotifyConfig": {
"NeedStatusNotify": false,
"OnDemandUrl": "http://guide.aliyundoc.com/ondemandcallback.action",
"DomainName": "example.com",
"NotifyUrl": "http://learn.aliyundoc.com/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.