该接口用于获取BCC实例可变配规格。
请求结构
POST /v{version}/instance?{action} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"spec": spec,
"zone": zone
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| action | String | 是 | Query参数 | 对实例执行的操作，当前取值：resizeList |
| spec | String | 否 | RequestBody参数 | 实例规格。实例规格、规格族ID和实例ID有且只能传一个。 |
| specId | String | 否 | RequestBody参数 | 规格族ID。实例规格、规格族ID和实例ID有且只能传一个。 |
| zone | String | 否 | RequestBody参数 | 指定zone信息，命名规范是“国家-region-可用区序列"，小写，例如北京可用区A为"cn-bj-a"。若传入spec或specId，则该参数为必填。 |
| instanceIdList | List |
否 | RequestBody参数 | 实例ID列表。实例规格、规格族ID和实例ID有且只能传一个。 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| specList | List | 可变配规格列表 |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| BadRequest | Spec, specid and instanceid can only be queried through one type. | 400 | 实例规格、规格族ID和实例ID有且只能传一个。 |
| BadRequest | At least one spec, specid and instanceIdList is required. | 400 | 实例规格、规格族ID和实例ID有且只能传一个。 |
请求示例
POST /v2/instance?resizeList HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: bce-auth-v1/78532e9951254e85b1f79***
{
"spec": "bcc.g5.c2m8",
"zone": "cn-bj-a"
}返回示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: 23 Mar 2023 06:30:58 GMT
x-bce-request-id: 5f9a3a71-bed4-45a5-97e7-d4cffbd468c9
Server: BWS
{
"specList": [
"bcc.c4.c12m24",
"bcc.c4.c16m32",
"bcc.c4.c24m48",
"bcc.c4.c2m4"
]
}