CreateLivePrivateLine

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

Operation description

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.
The settings take effect only if the value of AppName and the value of StreamName are the same as the application name and stream name that are specified in the streaming URL.

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.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example

Parameter	Type	Required	Description	Example
DomainName	string	Yes	The main streaming domain.	demo.aliyundoc.com
AppName	string	Yes	The name of the application.	live
StreamName	string	Yes	The name of the live stream.	testStream
VideoCenter	string	Yes	The live center. Valid values: cn-beijing, cn-shanghai, cn-shenzhen, cn-qingdao, ap-northeast-1, ap-southeast-5, eu-central-1, and ap-southeast-1, which indicate China (Beijing), China (Shanghai), China (Shenzhen), China (Qingdao), Japan (Tokyo), Indonesia (Jakarta), Germany (Frankfurt), and Singapore, respectively.	cn-shanghai
AccelerationType	string	Yes	The acceleration type. Valid values: play: streaming acceleration publish: stream ingest acceleration	play
AccelerationArea	string	Yes	The acceleration channel.	ap-southeast-1
Reuse	string	Yes	Specifies whether to reuse an existing acceleration channel. Valid values: yes: reuses an existing acceleration channel. no: creates a new acceleration channel.	no
MaxBandwidth	string	No	The accelerated bandwidth. Unit: Mbit/s. This parameter is required if Reuse is set to no.	200
InstanceId	string	No	The acceleration channel that you want to reuse. This parameter is required if Reuse is set to yes.	ga-bp1iovsdpf01ym9su****

Response parameters

Parameter	Type	Description	Example

Parameter	Type	Description	Example
	object	The response parameters.
RequestId	string	The request ID.	7908F2FF-44F8-120F-9FD6-85AE4B6C****

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status code	Error code	Error message	Description

HTTP status code	Error code	Error message	Description
400	InvalidParam	Parameter invalid.	Illegal input parameters
400	NoSpecialConfiguration	no special configuration for acceleration_area.	-
400	ConfigAlreadyExists	Config has already exist.	-
400	HasNoPermission	You do not have permission to create accelerator.	-
400	PostPayNotOpen	The Accelerator PostPay service is not open.	-
400	TryAgain	Create SLR first and please try again.	-
400	HasNoPermisionToCreateSLR	You do not have ram:CreateServiceLinkedRole to create SLR.	-
500	InternalError	The request processing has failed due to backend service exception.	-

For a list of error codes, visit the Service error codes.