绑定EIP
更新时间：2025-08-21
- 可用于绑定EIP到任意BLB实例或BCC实例。
- 只有available状态的EIP支持绑定操作。
- 被绑定的实例不能存在任何已有EIP绑定关系。
- 被绑定的实例不能处于欠费状态。
请求结构
Plain Text
1PUT /v{version}/eip/{eip}?{action}&clientToken={clientToken} HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "instanceType": instanceType,
7 "instanceId": instanceId,
8 "instanceIp": instanceIp
9}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| eip | String | 是 | URL参数 | 被绑定的EIP，包括IPv4 EIP和IPv6 EIP。 |
| action | String | 是 | Query参数 | 对EIP实例执行的动作，本接口中取值bind |
| clientToken | String | 是 | Query参数 | 幂等性Token，详见幂等性 |
| instanceType | instanceType | 是 | RequestBody参数 | 被绑定的实例类型 |
| instanceId | String | 是 | RequestBody参数 | 被绑定的实例ID |
| instanceIp | String | 否 | RequestBody参数 | 实例中需要绑定EIP的IP |
当EIP绑定弹性网卡或者BCC时，默认绑定弹性网卡主ip或者bcc中主网卡的主ip，当需要绑定弹性网卡辅助ip或者bcc主网卡辅助ip时，可在instanceIp中赋值需要绑定的具体ip
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
无特殊返回参数。
请求示例
请求示例，绑定EIP到BCC。
Plain Text
1PUT /v1/eip/180.76.122.3?bind&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2HOST eip.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4
5{
6 "instanceType": "BCC",
7 "instanceId": "i-Tkjq337f"
8}请求示例，绑定EIP到弹性网卡。
Plain Text
1PUT /v1/eip/120.48.186.48?bind&clientToken=31d167e1-2dbd-40bf-853b-d692ac134c75 HTTP/1.1
2HOST eip.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2024-06-21T10:17:45Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4
5{
6 "instanceType": "ENI",
7 "instanceId": "eni-hjxg7hw1zdri"
8}请求示例，绑定EIP到BLB。
Plain Text
1PUT /v1/eip/180.76.122.3?bind&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2HOST eip.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-06-21T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4
5{
6 "instanceType": "BLB",
7 "instanceId": "lb-3ytqlktb"
8}请求示例，绑定EIP到弹性网卡辅助IP。
Plain Text
1PUT /v1/eip/120.48.186.48?bind&clientToken=fb21f917-33c2-4f33-96c3-674d965a0032 HTTP/1.1
2HOST eip.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2024-06-21T10:24:08Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4
5{
6 "instanceType": "ENI",
7 "instanceId": "eni-hjxg7hw1zdri",
8 "instanceIp": "192.168.0.3"
9}请求示例，绑定IPv6 EIP到bcc主网卡的辅助ip。
Plain Text
1PUT /v1/eip/2400:da00:e003:2078:0:3:0:1ed?bind&clientToken=a7e580a2-79d7-4203-9c31-a68a1cf7d108 HTTP/1.1
2HOST eip.bj.baidubce.com
3Authorization bce-auth-v1/08e28f03ea9b11eea8a715135d6be69f/2024-03-25T12:31:26Z/3600/host;x-bce-date/d04aa904d61c452565af7471510f1f1d03f0d7ede2a1bb55eff60b5c6d94211a
4
5{
6 "instanceType": "BCC",
7 "instanceId": "i-1GPwA4Iy",
8 "instanceIp": "2400:da00:e003:0:27c:c00:0:5"
9}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS