All Products
Search

This Product

    Global Accelerator:CreateAccelerator

    Document Center

    Global Accelerator:CreateAccelerator

    Last Updated:Oct 14, 2026

    Global Accelerator (GA) is a network acceleration service that provides global coverage, relying on high-quality Border Gateway Protocol (BGP) bandwidth and the global transmission network of Alibaba Cloud to enable nearest access to the global network. It reduces the impact of network issues such as latency, jitter, and packet loss on service quality, providing high-availability and high-performance network acceleration services for global users. You can call the CreateAccelerator operation to create a GA instance.

    Operation description

    CreateAccelerator is an asynchronous operation. The system returns a GA instance ID, but the GA instance is not yet created and the creation task is still running in the background. You can call DescribeAccelerator to query the status of the GA instance:

    • When the GA instance is in the init state, the instance is being created. In this state, you can only perform query operations and cannot perform other operations.

    • When the GA instance is in the active state, the instance is created.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ga:CreateAccelerator

    create

    *Accelerator

    acs:ga:{#regionId}:{#accountId}:ga/*

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RegionId deprecated

    string

    Yes

    The region ID of the GA instance. Valid value: cn-hangzhou.

    cn-hangzhou
    ClientToken

    string

    No

    The client token that is used to ensure the idempotence of the request.

    You can use the client to generate the value, but you must ensure that it is unique among different requests. The client token can contain only ASCII characters.

    Note

    If you do not specify this parameter, the system automatically uses the RequestId of the API request as the ClientToken. The RequestId of each API request is different.

    123e4567****
    Name

    string

    No

    The name of the GA instance.

    The name must be 1 to 128 characters in length, and can contain digits, underscores (_), and hyphens (-). It must start with a letter or a Chinese character.

    test
    Duration

    integer

    No

    The subscription duration.

    • If PricingCycle is set to Month, valid values for Duration are 1 to 9.

    • If PricingCycle is set to Year, valid values for Duration are 1 to 3.

    Note

    This parameter is required when InstanceChargeType (the billing method of the GA instance) is set to PREPAY (upfront).

    1
    PricingCycle

    string

    No

    The billing cycle. Valid values:

    • Month: billed on a monthly basis.

    • Year: billed on a yearly basis.

    Note

    This parameter is required when InstanceChargeType (the billing method of the GA instance) is set to PREPAY (upfront).

    Valid values:

    • Month :

      Billed on a monthly basis.

    • Year :

      Billed on a yearly basis.

    • Hour :

      Billed on an hourly basis.

    • Day :

      Billed on a daily basis.

    Month
    Spec

    string

    No

    The specifications of the GA instance. Valid values:

    • 1: Small I.

    • 2: Small II.

    • 3: Small III.

    • 5: Medium I.

    • 8: Medium II.

    • 10: Medium III.

    • 20: Large I.

    • 30: Large II.

    • 40: Large III.

    • 50: Large IV.

    • 60: Large V.

    • 70: Large VI.

    • 80: Large VII.

    • 90: Large VIII.

    • 100: Super-large I.

    • 200: Super-large II.

    Note

    • Currently, Large III and above specifications are available only by whitelist. To use these specifications, contact your Alibaba Cloud account manager.

    • This parameter is required when InstanceChargeType (the billing method of the GA instance) is set to PREPAY (upfront).

    Different instance specifications have different definitions. For more information, see Instance specifications.

    1
    AutoPay

    boolean

    No

    Specifies whether to enable automatic payment. Valid values:

    • false (default): disables automatic payment. After an order is generated, you must go to the User Center to complete the payment.

    • true: enables automatic payment. The system automatically pays for the order.

    false
    AutoUseCoupon

    string

    No

    Specifies whether to use coupons for automatic payment of bills. Valid values:

    • true: uses coupons.

    • false (default): does not use coupons.

    Note

    This parameter takes effect only when AutoPay is set to true.

    false
    AutoRenew

    boolean

    No

    Specifies whether to enable auto-renewal. Valid values:

    • true: enables auto-renewal.

    • false (default): disables auto-renewal.

    false
    AutoRenewDuration

    integer

    No

    The auto-renewal duration. Unit: months.

    Valid values: 1 to 12. Default value: 1.

    Note

    This parameter takes effect only when AutoRenew is set to true.

    1
    PromotionOptionNo

    string

    No

    The coupon code.

    Note

    This parameter is applicable only to the Alibaba Cloud International Website.

    50003298014****
    BandwidthBillingType

    string

    No

    The bandwidth billing method. Valid values:

    • BandwidthPackage: billed by bandwidth plan.

    • CDT: billed by traffic.

    BandwidthPackage
    IpSetConfig

    object

    No

    The acceleration area configuration.

    AccessMode

    string

    No

    The access mode of the acceleration area. Valid values:

    • UserDefine: custom nearby access mode. You can select acceleration areas and regions based on your business requirements. Global Accelerator provides an independent EIP for each acceleration region.

    • Anycast: automatic nearby access mode. You do not need to configure acceleration areas. Global Accelerator provides an Anycast EIP in multiple regions worldwide. Users can access the Alibaba Cloud acceleration network from the nearest access point through the Anycast EIP.

    UserDefine
    ResourceGroupId

    string

    No

    The ID of the resource group to which the standard GA instance belongs.

    rg-aekzrnd67gq****
    Tag

    array<object>

    No

    The tags of the GA instance.

    object

    No

    The tags of the GA instance.

    Key

    string

    No

    The tag key of the GA instance. The tag key cannot be an empty string.

    The tag key can be up to 64 characters in length. It cannot start with aliyun or acs:, and cannot contain http:// or https://.

    You can specify up to 20 tag keys.

    tag-key
    Value

    string

    No

    The tag value of the GA instance. The tag value can be an empty string.

    The tag value can be up to 128 characters in length. It cannot start with aliyun or acs:, and cannot contain http:// or https://.

    You can specify up to 20 tag values.

    tag-value
    InstanceChargeType

    string

    No

    The billing method of the GA instance. Valid values:

    • PREPAY (default): upfront.

    • POSTPAY: pay-as-you-go.

    PREPAY
    DryRun

    boolean

    No

    Specifies whether to only precheck the request. Valid values:

    • true: sends a check request, and no resources are created. The system checks whether required parameters are specified, the request format, and service limits. If the request fails the check, the corresponding error is returned. If the request passes the check, the DryRunOperation error code is returned.

    • false (default): sends a normal request. After the request passes the check, an HTTP 2xx status code is returned and the operation is performed.

    false
    Bandwidth

    integer

    No

    The bandwidth of the standard GA instance. Unit: Mbit/s.

    Valid values: 200 to 5000.

    Note

    This parameter is required and takes effect only when the access mode of the acceleration area is set to Anycast.

    200

    Response elements

    Element

    Type

    Description

    Example

    object

    The returned information.

    AcceleratorId

    string

    The GA instance ID.

    ga-bp17frjjh0udz4qz****
    OrderId

    string

    The order ID.

    This parameter is returned when InstanceChargeType (the billing method) is set to PREPAY (subscription). If AutoPay is set to false, which means automatic payment is disabled, go to the User Center to complete the payment.

    208257****
    RequestId

    string

    The request ID.

    F591955F-5CB5-4CCE-A75D-17CF2085CE22

    Examples

    Success response

    JSON format

    {
  "AcceleratorId": "ga-bp17frjjh0udz4qz****",
  "OrderId": "208257****",
  "RequestId": "F591955F-5CB5-4CCE-A75D-17CF2085CE22"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    500 UnknownError An error occurred while processing your request. Please try again. If the error persists, please submit a ticket. An error occurred while the request was being processed. Try again later.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.