Migrate EIP from EIPGROUP
Updated at：2025-10-16
- The EIPGROUP being moved out must utilize the postpay charge type.
- The EIPGROUP being removed must not contain any pending orders.
- Only EIPs under the postpay charge type can be removed.
- If the removed EIP belongs to a native EIPGROUP, you are required to specify its bandwidth and billing details after removal.
- If the removed EIP originally belonged to a non-native EIP added to the EIPGROUP, it is unnecessary to specify bandwidth and billing details after removal. The EIP will return to its original bandwidth and charge type prior to being added.
Request structure
Plain Text
1PUT /v{version}/eipgroup/{id}?{action}&clientToken={clientToken} HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "moveOutEips": [
7 {
8 "eip":"ip",
9 "bandwidthInMbps":bandwidthInMbps,
10 "billing":{
11 "paymentTiming":"paymentTiming",
12 "billingMethod":"billingMethod"
13 }
14 }
15 ]
16}Request headers
No special headers beyond common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number, current value is 1. |
| id | String | Yes | URL parameter | EIPGROUP ID |
| action | String | Yes | Query | Operations on the EIPGROUP instance, with the value move_out taken in this API |
| clientToken | String | No | Query | Idempotence token, for details, refer to [clientToken](EIP/API Reference/General Description.md#Idempotence) |
| moveOutEips | List<[EipMoveOutModel](EIP/API Reference/Appendix 1.md#EipMoveOutModel)> | Yes | RequestBody | List of EIPs to be removed, including IPv4 and IPv6 EIPs. |
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](EIP/API Reference/Appendix 1.md)
Response headers
No special headers beyond common headers.
Response parameters
There are no special response parameters
Request example
Plain Text
1PUT /v1/eipgroup/eg-b2511000?move_out&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 "moveOutEips": [
7 {
8 "eip":"100.88.2.121",
9 "bandwidthInMbps":10,
10 "billing":{
11 "paymentTiming":"Postpaid",
12 "billingMethod":"ByTraffic"
13 }
14 },
15 {
16 "eip":"240c:4082:ffff:ff01:0:4:0:159"
17 }
18 ]
19}Response example
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