Unsubscribe prepaid EIPGROUP
Updated at:2025-10-16
- Release the prepaid EIPGROUP and proceed with the refund process.
- Only prepaid EIPGROUP supports unsubscription, while postpaid EIPGROUP does not. Postpaid EIPGROUP can be directly released using the delete EIPGROUP API.
- The EIPGROUP contains blocked EIPs that cannot be unsubscribed. Please unblock them and try again.
- EIPGROUPs containing EIPs bound to a VPN or NAT cannot be unsubscribed. Please unbind them and try again.
- The EIP in the EIPGROUP is bound to a bandwidth package, and unsubscription is not allowed. Please release the bandwidth package and try again.
EIPGROUP refund features a penalty mechanism, with refund amount = max(0, total amount - consumed amount * 1.5)
Request structure
Plain Text
1PUT /v{version}/eipgroup/refund/{id}?clientToken={clientToken} HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization: authorization string
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 | ID of the EIPGROUP to be unsubscribed |
| clientToken | String | Yes | Query | Idempotence token; refer to [Idempotence](EIP/API Reference/General Description.md#Idempotence) for details |
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/Error code.md)
Response headers
No special headers beyond common headers.
Response parameters
There are no special response parameters
Request example
Plain Text
1PUT /v1/eipgroup/refund/eg-13ztaYHz?clientToken=fe563488-edf8-47fd-b71c-86a4c903856a HTTP/1.1
2HOST eip.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2024-06-18T11:21:11Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
Response example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: cd016e71-7cd6-47d6-8b59-9c8e44d08014
3Date: Tue, 18 Jun 2024 11:21:11 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
