You can call this operation to query acceleration regions that match the specified conditions.

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 ListIpSets

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

AcceleratorId String  Yes ga-bp1yeeq8yfoyszmqy****

The ID of the Global Accelerator instance.

PageNumber Integer Yes 1

The number of the page to return. Pages start from page 1. Default value: 1.

RegionId String  Yes cn-hangzhou

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

PageSize String No 10

The number of entries to return on each page. Valid values: 1 to 100. Default value: 10.

Response parameters

Parameter Type Example Description
IpSets Array

The list of the acceleration regions.

AccelerateRegionId String cn-huhehaote

The ID of the acceleration region.

Bandwidth Integer 2

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

IpAddressList List ['39.xx.xx.220']

The list of accelerated IP addresses in the acceleration region.

IpSetId String ips-bp11r5jb8ogp122xl****

The ID of the acceleration region.

State String active

The status of the acceleration region.

  • init: The acceleration region is being initialized.
  • active: The acceleration region is in the running state.
  • updating: The acceleration region is being configured.
  • deleting: The acceleration region is being deleted.
PageNumber Integer 1

The number of the returned page.

PageSize Integer 10

The number of entries returned per page.

RequestId String A9B4E54C-9CCD-4002-91A9-D38C6C209192

The ID of the request.

TotalCount Integer 2

The total number of entries returned.

Examples

Sample requests

http(s)://[Endpoint]/? Action=ListIpSets
&AcceleratorId=ga-bp1yeeq8yfoyszmqy****
&PageNumber=1
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<ListIpSetsResponse>
  <PageNumber>1</PageNumber>
  <TotalCount>2</TotalCount>
  <PageSize>10</PageSize>
  <RequestId>A9B4E54C-9CCD-4002-91A9-D38C6C209192</RequestId>
  <IpSets>
        <State>active</State>
        <AccelerateRegionId>cn-huhehaote</AccelerateRegionId>
        <IpSetId>ips-bp11r5jb8ogp122xl****</IpSetId>
        <IpAddressList>39.xx.xx.220</IpAddressList>
        <Bandwidth>2</Bandwidth>
  </IpSets>
  <IpSets>
        <State>active</State>
        <AccelerateRegionId>cn-qingdao</AccelerateRegionId>
        <IpSetId>ips-bp11c9mpphtb1xkds****</IpSetId>
        <IpAddressList>47.xx.xx.113</IpAddressList>
        <Bandwidth>3</Bandwidth>
  </IpSets>
</ListIpSetsResponse>

JSON format

{
  "PageNumber": 1,
  "TotalCount": 2,
  "PageSize": 10,
  "RequestId": "A9B4E54C-9CCD-4002-91A9-D38C6C209192",
  "IpSets": [
    {
      "State": "active",
      "AccelerateRegionId": "cn-huhehaote",
      "IpSetId": "ips-bp11r5jb8ogp122xl****",
      "IpAddressList": [
        "39.xx.xx.220"
      ],
      "Bandwidth": 2
    },
    {
      "State": "active",
      "AccelerateRegionId": "cn-qingdao",
      "IpSetId": "ips-bp11c9mpphtb1xkds****",
      "IpAddressList": [
        "47.xx.xx.113"
      ],
      "Bandwidth": 3
    }
  ]
}

Error codes.

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