调用AssociateGlobalAccelerationInstance接口为独享型实例绑定后端服务器。
API描述
调用本接口绑定后端服务实例时，请注意：
- 仅支持专有网络类型的ECS实例和负载均衡实例作为全球加速实例的后端服务实例。
- 一个全球加速实例只能添加一个后端服务实例。
- 多个全球加速实例可以绑定同一个后端服务实例。
- 后端服务实例和全球加速实例需要属于同一个云账号。
- 绑定的后端服务器的地域必须在全球加速实例的服务区域内。
- 只有独享型全球加速实例支持通过该API绑定后端服务。
共享型全球加速实例绑定后端服务器的操作如下：
1. 将EIP加入到共享型全球加速实例。详细信息，请参见AddGlobalAccelerationInstanceIp。
2. 将EIP绑定到后端服务器。详细信息，请参见AssociateEipAddress，调用AssociateEipAddress接口时必须指定InstanceRegionId参数。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | AssociateGlobalAccelerationInstance | 要执行的操作，取值：AssociateGlobalAccelerationInstance。 |
| BackendServerId | String | 是 | i-saf23**** | 后端服务实例的ID。 |
| BackendServerRegionId | String | 是 | cn-shanghai | 后端服务实例所属的地域，该地域需要属于全球加速实例指定的服务区域。 |
| GlobalAccelerationInstanceId | String | 是 | ga-lsajj32**** | 全球加速实例的ID。 |
| RegionId | String | 是 | cn-hangzhou | 全球加速实例所在的地域。 您可以通过调用DescribeRegions接口获取地域ID。 |
| BackendServerType | String | 否 | EcsInstance | 后端服务实例的类型，取值：
|
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | DDF2CC38-76C7-4000-909D-B2088158AEDA | 请求ID。 |
示例
请求示例
https://vpc.aliyuncs.com/?Action=AssociateGlobalAccelerationInstance &BackendServerId=i-saf23**** &BackendServerRegionId=cn-shanghai &GlobalAccelerationInstanceId=ga-lsajj32**** &RegionId=cn-hangzhou &<公共请求参数>
正常返回示例
XML 格式
<AssociateGlobalAccelerationInstanceResponse>
<RequestId>DDF2CC38-76C7-4000-909D-B2088158AEDA</RequestId>
</AssociateGlobalAccelerationInstanceResponse>
JSON 格式
{
"RequestId":"DDF2CC38-76C7-4000-909D-B2088158AEDA"
}
错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 404 | InvalidGlobalAccelerationInstanceId.NotFound | The specified GlobalAccelerationInstanceId is not found. | 全球加速实例不存在。 |
| 404 | InvalidBackendServerId.NotFound | The specified BackendServerId is not found. | 后端服务器实例不存在，请您检查后端服务器实例是否正确。 |
| 400 | IncorrectGlobalAccelerationInstanceIdStatus | Current GlobalAccelerationInstance status does not support this operation. | 指定的全球加速实例状态不支持此操作 |
| 400 | InvalidBackendServerId.NotInVPC | The specified BackendServerId is not in VPC. | 指定的 BackendServerId 不是 VPC 类型。 |
| 400 | TaskConflict.AssociateGlobalAccelerationInstance | Operate too frequent. | 操作过于频繁。 |
| 400 | InvalidBackendServerRegionId.EqualRegionId | The specified BackendServerRegionId can not be the same as RegionId. | 指定的 BackendServerRegionId 不能与 RegionId 相同。 |
| 400 | InvalidAssociation.Duplicated | Specified instance already is associated. | 该实例已绑定EIP或全球加速实例，不能再绑定，如需更换实例绑定的EIP或全球加速实例，请先解绑。 |
| 400 | InvalidBackendServerType.NotFound | The specified BackendServerType is not supported. | 指定的后端服务器类型不支持。 |
| 400 | InvalidParameter | The specified parameter is not valid. | 该参数值不合法。 |
访问错误中心查看更多错误码。
