批量绑定和解绑实例
更新时间:2025-08-05
接口描述
本接口用来批量绑定和解绑实例。
请求结构
JSON
1PUT /v1/eip/batch/instance/{action}{?clientToken} HTTP/1.1
2Host: bec.baidubce.com
3Authorization: authorization string
4
5{
6 "backends": [
7 {
8 "eipId": "ip-xxxxxxxx",
9 "instanceType": "instanceType",
10 "instanceId": "instanceId",
11 "instanceIp": "instanceIp",
12 "mode": "mode"
13 }
14 ]
15}
请求头域
除公共头域外,无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| action | String | 是 | Path参数 | 操作:绑定bind、解绑unbind |
| backends | List<EipBackend> | 是 | Request Body参数 | 批量操作弹性公网IP请求 |
| clientToken | String | 否 | Query参数 | 幂等性Token,是一个长度不超过64位的ASCII字符串 |
返回头域
除公共头域,无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | Boolean | 操作是否成功,true表示成功;false表示失败 |
| details | BecBatchUpdateEipResponse | 返回EIP对象列表 |
请求示例
JSON
1 PUT /v1/eip/batch/instance/bind HTTP/1.1
2 Host: bec.baidubce.com
3 Authorization: authorization string
4
5{
6 "backends": [
7 {
8 "eipId": "ip-u5wf9tsj",
9 "instanceType": "eni",
10 "instanceId": "eni-r7ceb9jc7coa",
11 "instanceIp": "172.16.0.144",
12 "mode": "nat"
13 }
14 ]
15}
返回示例
JSON
1 HTTP/1.1 200 OK
2 x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50
3 Date: Thu, 16 Mar 2022 06:29:48 GMT
4 Content Type: application/json;charset=UTF 8
5 Server: BWS
6
7{
8 "result": true,
9 "action": "bind",
10 "details": [
11 {
12 "resourceId": "ip-u5wf9tsj",
13 "success": true,
14 "error": null
15 }
16 ]
17}
Modal对象定义
EipBackend
| 参数名称 | 类型 | 描述 |
|---|---|---|
| instanceType | String | 被绑定的实例类型 |
| instanceId | String | 被绑定的实例ID |
| instanceIp | String | 被绑定的实例IP |
| mode | String | 指定EIP的网络模式 |
