Creates one or more acceleration regions.

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 parameter

Parameter Type Required Example Description
Action String Yes CreateIpSets

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

RegionId String Yes cn-hangzhou

The region ID of the Global Accelerator (GA) instance. Set the value to cn-hangzhou.

ClientToken String No 1F4B6A4A-C89E-489E-BAF1-52777EE148EF

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 make sure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

AcceleratorId String Yes ga-bp1yeeq8yfoyszmqy****

The ID of the GA instance.

AccelerateRegion.N.AccelerateRegionId String Yes cn-huhehaote

The ID of the acceleration region.

AccelerateRegion.N.IpVersion String No IPv6

The Internet Protocol (IP) version used to connect to the GA instance. Valid values:

  • IPv4 (default): IPv4
  • IPv6: IPv6
AccelerateRegion.N.Bandwidth Integer No 2

The bandwidth allocated to the acceleration region. Unit: Mbit/s.

Note
  • Each acceleration region must be allocated a minimum of 2 Mbit/s of bandwidth.
  • The total bandwidth for all acceleration regions cannot exceed the bandwidth limit of your basic bandwidth plan.

Response parameters

Parameter Type Example Description
RequestId String 1F4B6A4A-C89E-489E-BAF1-52777EE148EF

The ID of the request.

IpSets Array of GaIpSet

The configurations of the acceleration regions.

AccelerateRegionId String cn-qingdao

The ID of the acceleration region.

Bandwidth Integer 2

The bandwidth allocated to the acceleration region. Unit: Mbit/s.

IpSetId String ips-bp11r5jb8ogp122xl****

The ID of the acceleration region.

AcceleratorId String ga-bp1yeeq8yfoyszmq****

The ID of the GA instance.

Examples

Sample requests

http(s)://[Endpoint]/?Action=CreateIpSets
&RegionId=cn-hangzhou
&ClientToken=1F4B6A4A-C89E-489E-BAF1-52777EE148EF
&AcceleratorId=ga-bp1yeeq8yfoyszmqy****
&AccelerateRegion=[{"AccelerateRegionId":"cn-huhehaote","IpVersion":"IPv6","Bandwidth":2}]
&<Common request parameters>

Sample success responses

XML format

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

<CreateIpSetsResponse>
    <RequestId>1F4B6A4A-C89E-489E-BAF1-52777EE148EF</RequestId>
    <IpSets>
        <AccelerateRegionId>cn-qingdao</AccelerateRegionId>
        <Bandwidth>2</Bandwidth>
        <IpSetId>ips-bp11r5jb8ogp122xl****</IpSetId>
    </IpSets>
    <AcceleratorId>ga-bp1yeeq8yfoyszmq****</AcceleratorId>
</CreateIpSetsResponse>

JSON format

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

{
  "RequestId" : "1F4B6A4A-C89E-489E-BAF1-52777EE148EF",
  "IpSets" : [ {
    "AccelerateRegionId" : "cn-qingdao",
    "Bandwidth" : 2,
    "IpSetId" : "ips-bp11r5jb8ogp122xl****"
  } ],
  "AcceleratorId" : "ga-bp1yeeq8yfoyszmq****"
}

Error codes

For a list of error codes, visit the API Error Center.