搜索本产品文档关键词
绑定EIP
所有文档
menu

弹性公网IP EIP

绑定EIP

  • 可用于绑定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
上一篇
EIP带宽扩缩容
下一篇
解绑EIP