Disables time shifting for a domain name, or disables time shifting for an application or a live stream under the domain name.
Usage note
Set the AppName or StreamName parameter if you want to disable time shifting for a specific application or a specific live stream.
QPS limit
A single user can perform a maximum of 10 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 | CloseLiveShift |
The operation that you want to perform. Set the value to CloseLiveShift. |
DomainName | String | Yes | example.com |
The streaming domain. |
RegionId | String | No | cn-shanghai |
The ID of the region where the streaming domain resides. |
AppName | String | No | liveApp**** |
The name of the application to which the live stream belongs. You can use the wildcard (*) to specify all applications under the domain name. |
StreamName | String | No | liveStream**** |
The name of the live stream. You can use the wildcard (*) to specify all streams of the application. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
The ID of the request. |
Examples
Sample requests
http(s)://live.aliyuncs.com/?Action=CloseLiveShift
&DomainName=example.com
&<Common request parameters>
Sample success responses
XML
format
<CloseLiveShiftResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</CloseLiveShiftResponse>
JSON
format
{
"CloseLiveShiftResponse": {
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
}
Error codes
For a list of error codes, visit the API Error Center.
Special error codes
Error code |
Error message |
HTTP status code |
Description |
---|---|---|---|
InvalidParam |
param error |
400 |
The error message returned because one or more specified parameters are invalid. |
InvalidDataNotFound |
data not found |
404 |
The error message returned because user data cannot be found. |