接口功能介绍
该接口提供查询当前云主机支持热变配的规格信息，用户可以根据此接口的返回值了解自己可使用的云主机规格有哪些
准备工作：
构造请求：在调用前需要了解如何构造请求，详情查看构造请求
认证鉴权：openapi请求需要进行加密调用，详细查看认证鉴权
注意事项：
确认云主机是否存在于当前资源池
如无法进行热变配，则返回规格结果为空
接口约束
1. 确保当前请求资源池下，该云主机存在（即instanceID真实存在且与regionID相对应）
2. 云主机状态为开机状态
3. 当前接口只支持华东1资源池
URI
POST /v4/ecs/flavor/live-resize-list
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID，您可以查看地域和可用区来了解资源池 获取： 查 资源池列表查询 |
bb9fdb42056f11eda1610242ac110002 | |
| instanceID | 是 | String | 云主机ID，您可以查看弹性云主机了解云主机的相关信息 获取： 查 查询云主机列表 创 创建一台按量付费或包年包月的云主机 创 批量创建按量付费或包年包月云主机 |
adc614e0-e838-d73f-0618-a6d51d09070a |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码（800为成功，900为失败） | 800 | |
| errorCode | String | 业务细分码，为product.module.code三段式码，详见错误码说明 | ||
| message | String | 失败时的错误描述，一般为英文描述 | ||
| description | String | 失败时的错误描述，一般为中文描述 | ||
| returnObj | Object | 返回内容 | returnObj |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| flavorList | Array of Objects | 规格列表 | flavorList |
表 flavorList
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| cpuInfo | String | cpu架构 | x86 | |
| baseBandwidth | Float | 基准带宽 | 0.1 | |
| flavorName | String | 云主机规格名称 | s7.medium.2 | |
| flavorType | String | 规格类型，取值范围：[CPU、CPU_S6、CPU_C6、CPU_M6、CPU_S3、CPU_C3、CPU_M3、CPU_IP3、GPU_N_T4_V、GPU_N_V100、GPU_N_V100_V、GPU_N_P2V_RENMIN、GPU_N_PI7、GPU_N_G7_V、GPU_N_V100、GPU_N_T4_JX]，支持类型会随着功能升级增加 | CPU_S7 | |
| flavorSeries | String | 云主机规格系列，规格系列说明： s（通用性）， c（计算增强型）， m（内存优化型）， hs（海光通用型）， hc（海光计算增强型）， hm（海光内存优化型）， fs（飞腾通用型）， fc（飞腾计算增强型）， fm（飞腾内存优化型）， ks（鲲鹏通用型）， kc（鲲鹏计算增强型）， kc（鲲鹏内存优化型）， p（GPU计算加速型）， g（GPU图像加速基础型）， ip3（超高IO型） |
s | |
| nicMultiQueue | Integer | 网卡多队列数目 | 8 | |
| pps | Integer | 最大收发包限制 | 0 | |
| flavorCPU | Integer | VCPU个数 | 16 | |
| flavorRAM | Integer | 内存 | 64 | |
| bandwidth | Float | 带宽 | 0.8 | |
| flavorID | String | 云主机规格ID，您可以调用flavorID查看最新的天翼云具体资源池的云主机规格列表 | 5f3ba144-98e4-ea85-ea9b-933394dded33 |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"instanceID": "adc614e0-e838-d73f-0618-a6d51d09070a"
}
响应示例
{
"returnObj": {
"flavorList": [{
"flavorID": "5f3ba144-98e4-ea85-ea9b-933394dded33",
"flavorName": "s7.medium.2",
"flavorCPU": 1,
"flavorRAM": 2,
"baseBandwidth": 0.1,
"bandwidth": 0.8,
"flavorSeries": "s",
"nicMultiQueue": 1,
"pps": 10,
"flavorType": "CPU_S7",
"cpuInfo": "x86"
}]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码
