Creates a Global Acceleration instance.

Note This API only supports creating Pay-As-You-Go Global Acceleration instances.


By using API Explorer, you can easily debug APIs, automatically generate SDK code examples, and quickly search for APIs.

Request parameters

Parameter Type Required? Example value Description 
Action String Yes CreateGlobalAccelerationInstance

The name of this action.  Value: 


Bandwidth Integer Yes 10

The bandwidth in Mbps of the instance. Valid values:


RegionId String Yes cn-hangzhou

The ID of the region where the Global Acceleration instance is located.

To query the region ID, call DescribeRegions.

ServiceLocation String Yes china-mainland
The service area of the instance. Valid values:
  • china-mainland: Mainland China

  • north-america: North America

  • asia-pacific: Asia Pacific

  • europe: Europe

For more information, see Service areas.

BandwidthType String No Exclusive
The type of the Global Acceleration instance. Valid values:
  • Sharing: Creates a shared-bandwidth instance.
  • Exclusive (default): Creates a dedicated-bandwidth instance.

For more information, see Instance types.

ClientToken String No 02fb3da4-130e-11e9-8e44-0016e04115b

A client token used to guarantee the idempotence of requests. 

This parameter value is generated by the client and must be unique. It must be 1 to 64 ASCII characters in length.

Description String No My GA

The description of the Global Acceleration instance.

The description must be 2 to 256 characters in length. It must start with a letter, but cannot start with http:// or https://.

Name String No GA-1

The name of the instance.

The name must be 2 to 128 characters in length and can contain letters, numbers, periods (.), underscores (_), or hyphens (-). The name must start with a letter , but cannot start with http:// or https://.

Response parameters

Parameter Type Example value Description
GlobalAccelerationInstanceId String ga-t4nluhu6

The ID of the Global Acceleration instance.

IpAddress String

The public IP address of the Global Acceleration instance.

RequestId String 21AAFD16-F784-4BFB-XXXX-XXXXXXXX

The ID of the request.


Request example
Response example

XML format


JSON format


Error codes

HTTP status code Error code Error message Description
400 InvalidServiceLocation.ValueNotSupported The specified ServiceLocation is not supported. The specified service area is not supported.
400 InvalidGlobalAccelerationInstanceName.Malformed The specified Name is not valid. The name format is invalid.
400 InvalidGlobalAccelerationInstanceDescription.Malformed The specified Description is not valid. The description format is invalid

See common error codes