All Products
Search

This Product

    ApsaraVideo Live:CreateLivePrivateLine

    Document Center

    ApsaraVideo Live:CreateLivePrivateLine

    Last Updated:Nov 03, 2023

    Creates a Global Accelerator (GA) instance and binds it to an acceleration circuit.

    Usage notes

    You can call this operation to create a GA instance and bind it to an acceleration circuit. The granularity is at the stream level. You need to specify the access points where the acceleration circuit starts and ends.

    QPS limit

    You can call this operation up to 50 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 CreateLivePrivateLine

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

    DomainName String Yes demo.aliyundoc.com

    The main streaming domain.

    AppName String Yes live

    The name of the application.

    StreamName String Yes testStream

    The name of the live stream.

    VideoCenter String Yes cn-shanghai

    The live center. Valid values: cn-beijing, cn-shanghai, cn-shenzhen, cn-qingdao, ap-northeast-1, ap-southeast-5, eu-central-1, ap-southeast-1, and ap-south-1, which indicate China (Beijing), China (Shanghai), China (Shenzhen), China (Qingdao), Japan (Tokyo), Indonesia (Jakarta), Germany (Frankfurt), Singapore, and India (Mumbai), respectively.

    AccelerationType String Yes play

    The acceleration type. Valid values:

    • play: streaming acceleration
    • publish: stream ingest acceleration
    AccelerationArea String Yes ap-southeast-1

    The acceleration channel.

    Reuse String Yes no

    Specifies whether to reuse an existing acceleration channel. Valid values:

    • yes: reuses an existing acceleration channel.
    • no: creates a new acceleration channel.
    MaxBandwidth String No 200

    The accelerated bandwidth. Unit: Mbit/s. This parameter must be specified when Reuse is set to no.

    InstanceId String No ga-bp1iovsdpf01ym9su****

    The acceleration channel that you want to reuse. This parameter must be specified when Reuse is set to yes.

    Response parameters

    Parameter

    Type

    Example

    Description
    RequestId String 7908F2FF-44F8-120F-9FD6-85AE4B6C19EC

    The request ID.

    Examples

    Sample requests

    https://live.aliyuncs.com?Action=CreateLivePrivateLine&DomainName=demo.aliyundoc.com&AppName=live&StreamName=testStream&VideoCenter=cn-shanghai&AccelerationType=play&AccelerationArea=ap-southeast-1&Reuse=no&Max_bandwidth=200&<Common request parameters>

    Sample success responses

    XML format

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

<CreateLivePrivateLineResponse>
    <RequestId>7908F2FF-44F8-120F-9FD6-85AE4B6C19EC</RequestId>
</CreateLivePrivateLineResponse>

    JSON format

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

{
  "RequestId" : "7908F2FF-44F8-120F-9FD6-85AE4B6C19EC"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 ConfigAlreadyExists Config has already exist. The error message returned because the configuration already exists.

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