接口说明
查询实例可用规格列表。您可以通过查询专属宿主机上云主机实例可用规格列表接口查询宿主机上实例可用规格。
注意事项：
-
zoneId为空返回当前地域的规格；zoneId不为空则返回当前可用区的规格(一个地域下存在多个可用区)。
-
cpu、ram、 vmType不可全为空。
URL
GET https://ecloud.10086.cn/api/openapi-instance/v4/region/flavors
请求参数
Query
|
参数名称
|
类型
|
必填
|
描述
|
|
zoneId
|
string
|
否
|
可用区，可通过查询属地地域可用区信息接口获取。 |
|
cpu
|
integer(int32)
|
否
|
cpu核数。 |
|
ram
|
integer(int32)
|
否
|
内存大小，单位为GB。 |
|
vmType
|
string
|
否
|
云主机规格类型。您可以通过云主机类型下的实例类型查看具体含义。 |
请求示例
GET https://ecloud.10086.cn/api/openapi-instance/v4/region/flavors返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
<ZoneFlavorInfo> array
|
请求成功时返回的数据。 |
|
flavorInfos
|
<FlavorInfo> array
|
规格信息列表。 |
|
cpu
|
integer(int32)
|
cpu核数。 |
|
flavorName
|
string
|
规格名称。 |
|
flavorType
|
string
|
规格类型。 |
|
ram
|
integer(int32)
|
内存大小。 |
|
soldOut
|
string
|
售罄标识:1售罄，0未售罄。 |
|
vmType
|
string
|
主机类型。 |
|
zoneId
|
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":[
{
"zoneId":"cn-jiangsu-1b",
"flavorInfos":[
{
"vmType":"common",
"cpu":2,
"ram":4,
"flavorName":"s5.large.2",
"flavorType":"s5",
"soldOut":"0"
},
{
"vmType":"common",
"cpu":2,
"ram":4,
"flavorName":"s3.large.2",
"flavorType":"s3",
"soldOut":"0"
},
{
"vmType":"common",
"cpu":2,
"ram":4,
"flavorName":"s4.large.2",
"flavorType":"s4",
"soldOut":"1"
}
]
},
{
"zoneId":"cn-jiangsu-1-suzhou-b",
"flavorInfos":[
{
"vmType":"common",
"cpu":2,
"ram":4,
"flavorName":"s5.large.2",
"flavorType":"s5",
"soldOut":"0"
},
{
"vmType":"common",
"cpu":2,
"ram":4,
"flavorName":"s3.large.2",
"flavorType":"s3",
"soldOut":"0"
}
]
}
]
}