接口说明
本接口用于查询云主机可用规格列表。
说明：
- region为空返回当前资源池的规格。
- region不为空则返回当前可用区的规格(一个资源池下存在多个可用区)。
- cpu,ram和vmType不可都为空。
URL
GET https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/serverSpecs
请求参数
Query
|
参数名称
|
类型
|
必填
|
描述
|
|
region
|
string
|
否
|
可用区，可通过查询属地资源池可用区信息接口获取。 |
|
cpu
|
integer(int32)
|
否
|
CPU核数。 |
|
ram
|
integer(int32)
|
否
|
内存大小。 |
|
vmType
|
enum(memImprove,common,gpu,commonIntroductory,commonNetImprove,compute,computeNetImprove,memNetImprove,localStorage,xlargeMemory,highFrequency,vgpu,highIO,exclusive,normalComputeImprove,normalNetEnhance,storeEnhance,computeEnhance,npu,universal)
|
否
|
云主机规格类型 memNetImprove:内存网络优化型,common:通用型,gpu:GPU型,commonIntroductory:通用入门型,commonNetImprove:通用网络优化型,compute:计算型,computeNetImprove:计算网络优化型,memNetImprove:内存网络优化型,localStorage:本地存储型,xlargeMemory:超大内存型,highFrequency:超高主频型,vgpu:vGPU型,highIO:高IO型,exclusive:独享型,normalComputeImprove:通用计算增强型,normalNetEnhance:通用网络增强型,storeEnhance:存储增强型,computeEnhance:计算增强型,npu:npu型,universal:通用算力型。 |
请求示例
GET https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/serverSpecs返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
<FlavorForApiResp> array
|
请求成功时返回的数据 |
|
cpu
|
integer(int32)
|
cpu核数 |
|
flavorId
|
string
|
规格ID |
|
ram
|
integer(int32)
|
内存大小 |
|
specsName
|
string
|
规格名称 |
|
specsType
|
string
|
规格类型 |
|
vmType
|
string
|
主机类型 |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
页面国际化错误提示 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码。返回正常：OK，返回错误：ERROR，返回异常：EXCEPTION，需要告警实现的：ALARM，禁止访问：FORBIDDEN |
返回示例
返回码：200
OK
{
"requestId":"reqId-3c425412d94b469cae1161d9b06497ce",
"state":"OK",
"body":[
{
"flavorId":"ecloud-normalkunpeng-920-0.5-000200040000",
"vmType":"common",
"cpu":2,
"ram":4,
"specsName":"s5k.large.2",
"specsType":"s5k"
},
{
"flavorId":"ecloud-normal-5118-1.0-000200040020",
"vmType":"common",
"cpu":2,
"ram":4,
"specsName":"s1.large.2",
"specsType":"s1"
},
{
"flavorId":"ecloud-normalHygon-7380-0.5-000200040000",
"vmType":"common",
"cpu":2,
"ram":4,
"specsName":"s5h.large.2",
"specsType":"s5h"
},
{
"flavorId":"ecloud-normal-8378C-0.5-000200040000",
"vmType":"common",
"cpu":2,
"ram":4,
"specsName":"s5.large.2",
"specsType":"s5"
},
{
"flavorId":"ecloud-normal-6248-1.0-000200040020",
"vmType":"common",
"cpu":2,
"ram":4,
"specsName":"s3.large.2",
"specsType":"s3"
},
{
"flavorId":"ecloud-normal-6248R-1.0-000200040020",
"vmType":"common",
"cpu":2,
"ram":4,
"specsName":"s4.large.2",
"specsType":"s4"
},
{
"flavorId":"ecloud-normalHygon-7265-1.0-000200040020",
"vmType":"common",
"cpu":2,
"ram":4,
"specsName":"s4h.large.2",
"specsType":"s4h"
},
{
"flavorId":"ecloud-normalHygon-7390-0.5-000200040000",
"vmType":"common",
"cpu":2,
"ram":4,
"specsName":"s5he.large.2",
"specsType":"s5he"
}
]
}