Query instance package specifications (new)
Updated at：2025-10-20
This API retrieves the list of instance specifications. It is recommended to specify the desired machine type and configuration using the "spec" parameter when creating an instance.
Request structure
Plain Text
1GET /v{version}/instance/flavorSpec HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization stringRequest 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 |
| zoneName | String | No | Query | Availability zone name |
| specs | String | No | Query | List of instance specifications to be queried, separated by commas for multiple specifications, such as bcc.g4.c1m4,bcc.g5.c2m8 |
| specIds | String | No | Query | List of instance families to be queried, separated by commas for multiple instance families, such as g4,g5. |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| zoneResources | List<[ZoneResourceDetailSpec](BCC/API Reference/Appendix.md#ZoneResourceDetailSpec)> | List of available instance package specifications in each availability zone |
Request example
Plain Text
1GET /v2/instance/flavorSpec?specs=bcc.g5.c2m8,bcc.hgn5IB.c116m978.8A100-80g&zoneName=cn-bj-a HTTP/1.1
2Host: bcc.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1deResponse example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Wed, 03 Dec 2014 06:42:19 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6
7{
8 "zoneResources": [
9 {
10 "zoneName": "cn-bj-a",
11 "ebcResources":
12 {
13 "customFlavors": [],
14 "flavorGroups": []
15 },
16 "bccResources":
17 {
18 "flavorGroups": [
19 {
20 "groupId": "gpuHGN5",
21 "flavors": [
22 {
23 "specId": "hgn5IB",
24 "cpuCount": 116,
25 "memoryCapacityInGB": 978,
26 "ephemeralDiskCount": 1,
27 "gpuCardType": "nTeslaA100-80G",
28 "gpuCardCount": 8,
29 "cpuModel": "Intel Xeon Platinum 8350C",
30 "cpuGHz": "2.6",
31 "eniQuota": 8,
32 "eriQuota": 0,
33 "rdmaType": "IB",
34 "rdmaNetCardCount": 4,
35 "rdmaNetBandwidth": 100,
36 "systemDiskType": [
37 "hp1",
38 "cloud_hp1",
39 "SSD_Enhanced"
40 ],
41 "dataDiskType": [
42 "local"
43 ],
44 "enableJumboFrame": false,
45 "nicIpv4Quota": 40,
46 "nicIpv6Quota": 40,
47 "networkBandwidth": "200",
48 "networkPackage": "5000",
49 "netEthQueueCount": "32",
50 "netEthMaxQueueCount": "32",
51 "productType": "Prepaid",
52 "spec": "bcc.hgn5IB.c116m978.8A100-80g"
53 }]
54 },
55 {
56 "groupId": "common",
57 "flavors": [
58 {
59 "specId": "g5",
60 "cpuCount": 2,
61 "memoryCapacityInGB": 8,
62 "ephemeralDiskCount": 0,
63 "cpuModel": "Intel Xeon Platinum 8350C",
64 "cpuGHz": "2.6",
65 "eniQuota": 2,
66 "eriQuota": 0,
67 "systemDiskType": [
68 "hp1",
69 "cloud_hp1",
70 "SSD_Enhanced"
71 ],
72 "dataDiskType": [
73 "hp1",
74 "cloud_hp1",
75 "SSD_Enhanced"
76 ],
77 "enableJumboFrame": false,
78 "nicIpv4Quota": 8,
79 "nicIpv6Quota": 8,
80 "networkBandwidth": "1.5",
81 "networkPackage": "40",
82 "netEthQueueCount": "2",
83 "netEthMaxQueueCount": "2",
84 "productType": "Prepaid",
85 "spec": "bcc.g5.c2m8"
86 }]
87 }]
88 }
89 }]
90}