All Products
Search

This Product

    ApsaraVideo Live:OpenLiveShift

    Document Center

    ApsaraVideo Live:OpenLiveShift

    Last Updated:May 30, 2024

    Enables time shifting for a domain name, or an application or a live stream under the domain name.

    Usage notes

    You cannot configure time shifting and delayed transcoding at the same time.

    QPS limit

    You can call this operation up to 10 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits.

    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 OpenLiveShift

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

    DomainName String Yes example.com

    The streaming domain.

    AppName String No liveApp****

    The name of the application to which the live stream belongs. You can specify an asterisk (*) as the value to match all applications under the domain name.

    StreamName String No liveStream****

    The name of the live stream. You can specify an asterisk (*) as the value to match all streams in the application.

    Duration Integer No 3

    The length of a TS segment for HTTP Live Streaming (HLS). Unit: seconds.

    Vision Integer No 10

    The duration for which data is retained. Unit: day. Default value: 7.

    IgnoreTranscode Boolean No true

    Specifies whether to disable time shifting for the transcoded stream. Valid values:

    • true: disables time shifting for the transcoded stream.
    • false: enables time shifting for the transcoded stream.

    Default value: true.

    Response parameters

    Parameter

    Type

    Example

    Description
    RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

    The request ID.

    Examples

    Sample requests

    http(s)://live.aliyuncs.com/?Action=OpenLiveShift
&DomainName=example.com
&<Common request parameters>

    Sample success responses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

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

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

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

    Error codes

    For a list of error codes, see Service error codes.

    Special error codes

    Error code

    Error message

    HTTP status code

    Description

    InvalidParam

    param error

    400

    One or more specified parameters are invalid.

    InvalidDataNotFound

    data not found

    404

    The user data cannot be found.