EIP Inquiry
Updated at:2025-10-16
- Query the pricing details for EIPs under various charging models.
Request structure
Plain Text
1 POST /v{version}/eip/price HTTP/1.1
2 Host: eip.bj.baidubce.com
3 Authorization: authorization string
4 {
5 "bandwidthInMbps": 1,
6 "count": 1,
7 "billing":{
8 "paymentTiming": paymentTiming,
9 "billingMethod": billingMethod,
10 "reservation":{
11 "reservationLength": reservationLength,
12 "reservationTimeUnit": reservationTimeUnit
13 }
14 }
15 }
Request headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| bandwidthInMbps | int | Yes | RequestBody | Public network bandwidth, in Mbps. For EIPs billed by bandwidth, limited to an integer within the range of 1~200 (representing the bandwidth upper limit); for EIPs billed by traffic, limited to an integer within the range of 1~1,000 (representing the allowed peak traffic bandwidth). |
| count | int | No | RequestBody | EIP count, defaulted as 1. |
| purchaseType | String | No | RequestBody | EIP line selection options: BGP, Static, ChinaTelcom, ChinaUnicom, or ChinaMobile (defaulted as BGP) |
| billing | Billing | Yes | Request Body parameters | Billing information supports prepay and postpay (bandwidth, traffic) modes |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| prices | Map | Price details (including purchasePrice (prepay price), configPrice (configuration price), netrafficPrice (traffic price)) |
Request example (prepaid)
Plain Text
1 POST /v1/eip/price HTTP/1.1
2 Host: eip.bj.baidubce.com
3 Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4 {
5 "bandwidthInMbps": 1,
6 "count": 1,
7 "billing": {
8 "paymentTiming": "Prepaid",
9 "reservation": {
10 "reservationLength": 1,
11 "reservationTimeUnit": "month"
12 }
13 }
14 }
Response example
Plain Text
1 HTTP/1.1 200 OK
2 x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3 Date: Thu, 16 Mar 2017 06:29:48 GMT
4 Content-Type: application/json;charset=UTF-8
5 Server: BWS
6 {
7 "prices": {
8 "purchasePrice": "23.00000"
9 }
10 }
Request example (postpaid by bandwidth)
Plain Text
1 POST /v1/eip/price HTTP/1.1
2 Host: eip.bj.baidubce.com
3 Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4 {
5 "bandwidthInMbps": 1,
6 "count": 1,
7 "billing": {
8 "paymentTiming": "Postpaid",
9 "billingMethod": "ByBandwidth"
10 }
11 }
Response example
Plain Text
1 HTTP/1.1 200 OK
2 x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3 Date: Thu, 16 Mar 2017 06:29:48 GMT
4 Content-Type: application/json;charset=UTF-8
5 Server: BWS
6 {
7 "prices": {
8 "configPrice": "0.00094/minute"
9 }
10 }
Request example (postpaid by traffic)
Plain Text
1 POST /v1/eip/price HTTP/1.1
2 Host: eip.bj.baidubce.com
3 Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4 {
5 "bandwidthInMbps": 1,
6 "count": 1,
7 "billing": {
8 "paymentTiming": "Postpaid",
9 "billingMethod": "ByTraffic"
10 }
11 }
Response example
Plain Text
1 HTTP/1.1 200 OK
2 x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3 Date: Thu, 16 Mar 2017 06:29:48 GMT
4 Content-Type: application/json;charset=UTF-8
5 Server: BWS
6 {
7 "prices": {
8 "netrafficPrice": "0.76/GB",
9 "configPrice": "0.00032/minute"
10 }
11 }
