Queries Global Acceleration instances attached to a backend server.

Note This API only supports querying dedicated-bandwidth instances.

Debug

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 DescribeServerRelatedGlobalAccelerationInstances

The name of this action.  Value: 

DescribeServerRelatedGlobalAccelerationInstances

RegionId String Yes cn-hangzhou

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

To query the region ID, call DescribeRegions.

ServerId String Yes i-12s3sdfxxxxxxxx

The ID of the backend server.

ServerType String No EcsInstance

The type of the backend server. Valid values:

  • EcsInstance (default): ECS instance.
  • SlbInstance: SLB instance.

Response parameters

Parameter Type Example value Description
GlobalAccelerationInstances N/A N/A

A list of Global Acceleration instances.

 └GlobalAccelerationInstanceId String ga-t4nku6vv9xxxxxxxxx

The ID of the Global Acceleration instance.

 └IpAddress String 12.34.56.78

The public IP address of the Global Acceleration instance.

 └RegionId String ap-southeast-1

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

 └ServerIpAddress String 172.24.52.234

The IP address of the backend server.

RequestId String A8252014-D8DE-4D85-AF35-AFEXXXXXXX

The ID of the request.

Examples

Request example


https://vpc.aliyuncs.com/?Action=DescribeServerRelatedGlobalAccelerationInstances
&RegionId=cn-hangzhou
&ServerId=i-12s3sdfxxxxxxxx
&<CommonParameters>
Response example

XML format

<DescribeServerRelatedGlobalAccelerationInstancesResponse>
  <GlobalAccelerationInstances>
    <GlobalAccelerationInstance>
      <GlobalAccelerationInstanceId>ga-t4nku6vv9xxxxxxxxx</GlobalAccelerationInstanceId>
      <IpAddress>12.34.56.78</IpAddress>
      <RegionId>ap-southeast-1</RegionId>
      <ServerIpAddress>172.24.52.234</ServerIpAddress>
    </GlobalAccelerationInstance>
  </GlobalAccelerationInstances>
  <RequestId>A8252014-D8DE-4D85-AF35-AFEXXXXXXX</RequestId>
</DescribeServerRelatedGlobalAccelerationInstancesResponse>

JSON format

{
	"RequestId":"A8252014-D8DE-4D85-AF35-AFEXXXXXXX",
	"GlobalAccelerationInstances":{
		"GlobalAccelerationInstance":[
			{
				"GlobalAccelerationInstanceId":"ga-t4nku6vv9xxxxxxxxx",
				"RegionId":"ap-southeast-1",
				"IpAddress":"12.34.56.78",
				"ServerIpAddress":"172.24.52.234"
			}
		]
	}
}

Error codes

HTTP status code Error code Error message Description
404 InvalidBackendServerId.NotFound The specified BackendServerId is not found. The specified backend server does not exist.
400 InvalidBackendServerId.NotInVPC The specified BackendServerId is not in VPC. The specified backend server does not support the VPC network type.
400 InvalidBackendServerType.NotFound The specified BackendServerType is not supported. The specified backend server type is not supported.

See common error codes