Shared Bandwidth Inquiry
Last Updated：2020-09-01
- Shared bandwidth inquiry for different billing types.
Request structure
POST /v{version}/eipgroup/price HTTP/1.1
Host: eip.bj.baidubce.com
Authorization: authorization string
{
"bandwidthInMbps": 10,
"count": 1,
"ipNum": 2,
"billing":{
"paymentTiming": paymentTiming,
"billingMethod": billingMethod,
"reservation":{
"reservationLength": reservationLength,
"reservationTimeUnit": reservationTimeUnit
}
},
} Request header
There are no other special headers except the public headers.
Request parameter
| Parameter name | Type | Required or not | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| bandwidthInMbps | int | Yes | RequestBody parameter | Public network bandwidth, in Mbps. The limit is an integer between 1 and 200. |
| count | int | No | RequestBody parameter | Number of shared bandwidth, 1 by default. |
| ipNum | int | Yes | RequestBody parameter | Number of IPs in the shared bandwidth. |
| billing | Billing | Yes | Request Body parameters | Billing information, supports prepaid and postpaid (bandwidth, 95) methods. |
Return header
There are no special headers except the common header.
Return parameter
| Parameter name | Type | Description |
|---|---|---|
| prices | Map | Price details (including purchasePrice (prepaid price), configPrice (configuration price)) |
Request example (prepaid)
POST /v1/eipgroup/price HTTP/1.1
Host: eip.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"bandwidthInMbps": 20,
"count": 1,
"ipNum":2,
"billing": {
"paymentTiming": "Prepaid",
"billingMethod": "ByBandwidth",
"reservation":{
"reservationLength":1,
"reservationTimeUnit":"Month"
}
}
} Return example
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"prices": {
"purchasePrice": "1630.00000"
}
} Request example (postpaid according to bandwidth)
POST /v1/eipgroup/price HTTP/1.1
Host: eip.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"bandwidthInMbps": 20,
"count": 1,
"ipNum":2,
"billing": {
"paymentTiming": "Postpaid",
"billingMethod": "ByBandwidth"
}
} Return example
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"prices": {
"configPrice": "0.05704/minute"
}
} Request example (postpaid according to the monthly peak bandwidth of 95)
POST /v1/eipgroup/price HTTP/1.1
Host: eip.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"bandwidthInMbps": 20,
"count": 1,
"ipNum":2,
"billing": {
"paymentTiming": "Postpaid",
"billingMethod": "By95"
}
} Return example
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"prices": {
"configPrice": "0.00104/minute"
}
}