Bind EIP
Last Updated：2020-10-21
- It can be used to bind EIP to any BLB instance or BCC instance.
- Only the EIP in available state supports binding operation.
- The bound instance cannot have any existing EIP binding relationship.
- The bound instance cannot be in arrearage state.
Request structure
PUT /v{version}/eip/{eip}?{action}&clientToken={clientToken} HTTP/1.1
Host: eip.bj.baidubce.com
Authorization: authorization string
{
"instanceType": instanceType,
"instanceId": instanceId
}Request header
There are no other special headers except the public headers.
Request parameter
| Parameter name | Type | Required or not | Parameter position | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number (the current value is 1) |
| eip | String | Yes | URL parameter | Bound EIP, expressed with dotted decimal notation |
| action | String | Yes | Query parameter | For the action executed by EIP instance, the value in this interface is bind. |
| clientToken | String | Yes | Query parameter | Idempotence, for details, please see Idempotence |
| instanceType | instanceType | Yes | RequestBody parameter | Type of bound instance |
| instanceId | String | Yes | RequestBody parameter | Bound instance ID |
Return status code
200 is returned successfully, for the failed return, please see Error code.
Return header
There are no other special headers except the public headers.
Return parameter
There is no special return parameter.
Request example
Request example, bind EIP to BCC.
PUT /v1/eip/180.76.122.3?bind&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST eip.bj.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
{
"instanceType": "BCC",
"instanceId": "i-Tkjq337f"
}Request example, bind EIP to BLB.
PUT /v1/eip/180.76.122.3?bind&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST eip.bj.baidubce.com
Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-06-21T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
{
"instanceType": "BLB",
"instanceId": "lb-3ytqlktb"
}Response example
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS