EIP renewal has been enabled
Updated at：2025-10-16
Enable EIP auto-renewal
- The EIP charge type is prepay
- The EIP is not been assigned with shift charge tasks
- The EIP has not been enabled with auto-renewal function
Request structure
Plain Text
1PUT /v{version}/eip/{eip}?{action}&clientToken={clientToken} HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization: authorization string
4{
5 "autoRenewTimeUnit": autoRenewTimeUnit,
6 "autoRenewTime": autoRenewTime
7}Request headers
No special headers beyond common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | The current API version number is 1. |
| clientToken | String | Yes | Query | Idempotence token; for more information, refer to the Idempotence documentation. |
| eip | String | Yes | URL parameter | EIPs designated for renewal, including IPv4 and IPv6 EIPs. |
| action | String | Yes | Query | The action to be performed on the EIP instance. For this API, the value is startAutoRenew |
| autoRenewTimeUnit | String | No | RequestBody | The valid value is month or year (defaulted as month) |
| autoRenewTime | int | No | RequestBody | The value ranges vary by autoRenewTimeUnit, with 1-9 for month and 1-3 for year |
Response Status Code
Respond with 200 upon successful operation or provide error codes in case of failure, as detailed in the Error Codes section.
Response headers
No additional headers beyond standard ones.
Response parameters
No special response parameters are available.
IPv4 EIP request example
Plain Text
1PUT /v1/eip/180.76.122.3?startAutoRenew&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 "autoRenewTime": 1,
6 "autoRenewTimeUnit": "month"
7}IPv6 EIP request example
Plain Text
1PUT /v1/eip/240c:4082:ffff:ff01:0:4:0:9a?startAutoRenew&clientToken=c17de085-a132-47a2-9b9e-cd48cf798d54 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 "autoRenewTime": 1,
6 "autoRenewTimeUnit": "month"
7}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: BWSDisable EIP auto-renewal
- Require EIP to have enabled auto-renewal
Request structure
Plain Text
1PUT /v{version}/eip/{eip}?{action}&clientToken={clientToken} HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization: authorization stringRequest headers
No special headers beyond common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | The current API version number is 1. |
| clientToken | String | Yes | Query | Idempotence token; for more information, refer to the Idempotence documentation. |
| eip | String | Yes | URL parameter | EIPs designated to disable renewal, including IPv4 and IPv6 EIPs. |
| action | String | Yes | Query | The action to be performed on the EIP instance. For this API, the value is stopAutoRenew |
Response status code
Respond with 200 upon successful operation or provide error codes in case of failure, as detailed in the Error Codes section.
Response headers
No additional headers beyond standard ones.
Response parameters
No special response parameters are available.
IPv4 EIP request example
Plain Text
1PUT /v1/eip/180.76.122.3?stopAutoRenew&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/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02IPv6 EIP request example
Plain Text
1PUT /v1/eip/240c:4082:ffff:ff01:0:4:0:9a?stopAutoRenew&clientToken=7e0b307d-1ff6-4808-88a6-e6de5751f625 HTTP/1.1
2HOST eip.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02Response 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