说明:当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0。
1. 接口描述
本接口 (AssociateAddress) 用于将 弹性公网IP(简称 EIP)绑定到实例或弹性网卡的指定内网 IP 上。
接口请求域名:eip.api.qcloud.com
- 将 EIP 绑定到实例上,其本质是将 EIP 绑定到实例上主网卡的主内网 IP 上。
- 将 EIP 绑定到主网卡的主内网 IP 上,绑定过程会把其上绑定的普通公网 IP 自动解绑并释放。
- 如果指定网卡的内网 IP 已经绑定了 EIP,则必须先解绑该 EIP,才能再绑定新的。
- EIP 如果欠费或被封堵,则不能被绑定。
- 只有状态为 UNBIND 的 EIP 才能够被绑定。
2. 输入参数
以下请求参数列表仅列出了接口请求参数,其它参数见 公共请求参数 页面。
参数名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Version | String | 是 | 表示 API 版本号,主要用于标识请求的不同 API 版本。 本接口第一版本可传:2017-03-12。 |
AddressId | String | 是 | 标识 EIP 的唯一 ID。EIP 唯一 ID 形如:eip-11112222 。 |
InstanceId | String | 否 | 要绑定的实例 ID。实例 ID 形如:ins-11112222 。可通过登录 控制台 查询,也可通过 DescribeInstances 接口返回值中的InstanceId 获取。 |
NetworkInterfaceId | String | 否 | 要绑定的弹性网卡 ID。 弹性网卡 ID 形如:eni-11112222 。NetworkInterfaceId 与 InstanceId 不可同时指定。弹性网卡 ID 可通过登录 控制台 查询,也可通过 DescribeNetworkInterfaces 接口返回值中的networkInterfaceId 获取。 |
PrivateIpAddress | String | 否 | 要绑定的内网 IP。如果指定了 NetworkInterfaceId 则也必须指定 PrivateIpAddress ,表示将 EIP 绑定到指定弹性网卡的指定内网 IP 上。同时要确保指定的 PrivateIpAddress 是指定的 NetworkInterfaceId 上的一个内网 IP。指定弹性网卡的内网 IP 可通过登录 控制台 查询,也可通过 DescribeNetworkInterfaces 接口返回值中的privateIpAddress 获取。 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 唯一请求 ID。每次请求都会返回RequestId 。当用户调用接口失败找后台研发人员处理时需提供该RequestId 。 |
4. 错误码
以下错误码表仅列出了该接口的业务逻辑错误码,更多错误码详见 公共错误码。
错误码 | 描述 |
---|---|
InvalidAddressId.NotFound | 指定的 EIP 不存在。 |
InvalidAddressId.Blocked | 指定 EIP 处于被封堵状态。当 EIP 处于封堵状态的时候是不能够进行绑定操作的,需要先进行解封。 |
InvalidAddressIdState.InArrears | 指定 EIP 处于欠费状态。 |
InvalidAddressIdStatus.NotPermit | 指定 EIP 当前状态不能进行绑定操作。只有 EIP 的状态是 UNBIND 时才能进行绑定操作。 |
InvalidInstanceId.NotFound | 指定实例 ID 不存在。 |
InvalidInstanceId.AlreadyBindEip | 指定实例已经绑定了 EIP。需先解绑当前的 EIP 才能再次进行绑定操作。 |
InvalidInstance.NotSupported | 指定实例当前状态不能进行绑定 EIP 操作。 |
InvalidNetworkInterfaceId.NotFound | 指定 NetworkInterfaceId 不存在或指定的 PrivateIpAddress 不在 NetworkInterfaceId 上。 |
InvalidPrivateIpAddress.AlreadyBindEip | 指定弹性网卡的指定内网 IP 已经绑定了 EIP,不能重复绑定。 |
InvalidParameterConflict | 指定的两个参数冲突,不能同时存在。 EIP 只能绑定在实例上或指定网卡的指定内网 IP 上。 |
MissingParameter | 参数依赖缺少。NetworkInterfaceId 和 PrivateIpAddress 必须同时指定,表示将 EIP 绑定到指定弹性网卡的指定内网 IP 上。 |
MissingResourceId | 绑定的实体缺失。InstanceId 或 NetworkInterfaceId 、 PrivateIpAddress 必须指定一个。 |
5. 示例代码
示例1
绑定 EIP 到实例上:
请求参数
https://cvm.api.qcloud.com/v2/index.php?Action=AssociateAddress &Version=2017-03-12 &AddressId=eip-ek0cdz1g &InstanceId=ins-1bmpb9tu &<公共请求参数>
返回参数
{ "Response": { "RequestId": "3c140219-cfe9-470e-b241-907877d6fb03" } }
示例2
绑定 EIP 到指定网卡的指定内网 IP 上:
请求参数
https://cvm.api.qcloud.com/v2/index.php?Action=AssociateAddress &Version=2017-03-12 &AddressId=eip-ek0cdz1g &NetworkInterfaceId=eni-8x55qvrh &PrivateIpAddress=10.0.0.2 &<公共请求参数>
返回参数
{ "Response": { "RequestId": "3c140219-cfe9-470e-b241-907877d6fb03" } }