BLB Inquiry
Updated at：2025-10-16
BLB supports the price inquiry API
Request structure
Plain Text
1POST /v{version}/blb/price HTTP/1.1
2Host: blb.bj.baidubce.com
3Authorization: authorization string
4{
5 "blbType":"ipv6Application",
6 "performanceLevel":"small1",
7 "count":1,
8 "billing": {
9 "paymentTiming": "Prepaid",
10 "reservation":{
11 "reservationLength":1
12 }
13 }
14}Request headers
No special headers beyond common headers.
Request parameters
| Parameter name | Types | Required or not | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number, current value is 1. |
| blbType | String | No | RequestBody | BLB type: If unspecified, it defaults to general-purpose BLB. The value can be "normal" for general-purpose, "application" for application-specific, "ipv6" for general-purpose IPv6, or "ipv6Application" for application-specific IPv6. |
| performanceLevel | String | No | RequestBody | Performance specification parameter: By default, it is of the shared type if not specified. Options include: "small1" (Standard 1), "small2" (Standard 2), "medium1" (Enhanced 1), "medium2" (Enhanced 2), "large1" (Extra Large 1), "large2" (Extra Large 2), and "large3" (Extra Large 3). |
| count | Integer | No | RequestBody | Purchase count. It is 1 by default if not specified. |
| billing | [Billing](BLB/API Reference/Appendix.md#Billing) | No | RequestBody | Order-related information |
Response Status Code
Respond with 200 after successful operation, and respond with error codes after failed operation, as shown in [Error Codes](BLB/API Reference/Error code.md)
Response headers
No special headers beyond common headers.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| prices | List<[Price](BLB/API Reference/Appendix.md#Price)> | Returned price information |
Prepay Request Example
Plain Text
1PUT /v1/blb/price?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2HOST blb.bj.baidubce.com
3Authorization: authorization string
4{
5 "blbType":"ipv6Application",
6 "performanceLevel":"small1",
7 "count":1,
8 "billing": {
9 "paymentTiming": "Prepaid",
10 "reservation":{
11 "reservationLength":1
12 }
13 }
14}Prepay Response Example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2024 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7{
8 "prices": [
9 {
10 "chargeItem": "instance",
11 "originalPrice": "190",
12 "discountPrice": "20.90"
13 }
14 ]
15}Postpay Request Example
Plain Text
1PUT /v1/blb/price?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2HOST blb.bj.baidubce.com
3Authorization: authorization string
4{
5 "blbType":"ipv6Application",
6 "performanceLevel":"small1",
7 "count":1,
8 "billing": {
9 "paymentTiming": "Postpaid",
10 "billingMethod":"ByCapacityUnit"
11 }
12}Postpay Response Example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2024 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7{
8 "prices": [
9 {
10 "chargeItem": "instance",
11 "originalPrice": "0.01056",
12 "discountPrice": "0.00116",
13 "chargeUnit": "minute"
14 },
15 {
16 "chargeItem": "lcu",
17 "originalPrice": "0.04",
18 "discountPrice": "0.04",
19 "chargeUnit": "lcu"
20 }
21 ]
22}