Query resizing specifications
Updated at：2025-10-20
This API retrieves the resizing specifications for BCC instances.
Request structure
Plain Text
1 POST /v{version}/instance?{action} HTTP/1.1
2 Host: bcc.bj.baidubce.com
3 Authorization: authorization string
4
5 {
6 "spec": spec,
7 "zone": zone
8 }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 |
| action | String | Yes | Query | Operation executed on the instance, current value: resizeList |
| spec | String | No | RequestBody | Instance specifications: at any given time, only one among instance specifications, instance family ID, or instance ID can be specified. |
| specId | String | No | RequestBody | Instance family ID: at any given time, only one among instance specifications, instance family ID, or instance ID can be specified. |
| zone | String | No | RequestBody | Specify zone information using lowercase format "country-region-availability zone sequence," e.g., "cn-bj-a" for Beijing zone A. This parameter is mandatory if either spec or specId is specified. |
| instanceIdList | No | RequestBody | List of instance IDs: at any given time, only one among instance specifications, instance family ID, or instance ID can be specified. |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| specList | List | List of resizing specifications |
Error codes
| Error code | Error description | HTTP status code | Chinese explanation |
|---|---|---|---|
| BadRequest | Spec, specid and instanceid can only be queried through one type. | 400 | Only one among instance specifications, instance family ID, or instance ID can be specified at a time. |
| BadRequest | At least one spec, specid and instanceIdList is required. | 400 | Only one among instance specifications, instance family ID, or instance ID can be specified at a time. |
Request example
Plain Text
1 POST /v2/instance?resizeList HTTP/1.1
2 Host: bcc.bj.baidubce.com
3 Authorization: bce-auth-v1/78532e9951254e85b1f79***
4
5 {
6 "spec": "bcc.g5.c2m8",
7 "zone": "cn-bj-a"
8 }Response example
Plain Text
1 HTTP/1.1 200 OK
2 Content-Type: application/json;charset=UTF-8
3 Date: 23 Mar 2023 06:30:58 GMT
4 x-bce-request-id: 5f9a3a71-bed4-45a5-97e7-d4cffbd468c9
5 Server: BWS
6 {
7 "specList": [
8 "bcc.c4.c12m24",
9 "bcc.c4.c16m32",
10 "bcc.c4.c24m48",
11 "bcc.c4.c2m4"
12 ]
13 }