更新时间:2024-07-11 GMT+08:00

查询DDM可用区规格信息

功能介绍

查询DDM可用区规格信息详情。

接口约束

URI

GET /v2/{project_id}/flavors?engine_id={engine_id}&offset={offset}&limit={limit}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一region下的project ID。

获取方法请参见获取项目ID

表2 Query参数

参数

是否必选

参数类型

描述

engine_id

String

引擎ID,通过查询DDM引擎信息接口获取。

offset

Integer

索引位置,偏移量。

从第一条数据偏移offset条数据后开始查询,默认为0。

取值必须为数字,且不能为负数。

limit

Integer

查询个数上限值。

取值范围:1~128。

不传该参数时,默认值为10。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务的“获取用户Token”接口来获取。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

computeFlavorGroups

Array of ComputeFlavorGroupsInfo objects

计算类型规格组。

表5 ComputeFlavorGroupsInfo

参数

参数类型

描述

groupType

String

计算资源架构类型,目前分X86和ARM两种。

computeFlavors

Array of ComputeFlavors objects

计算类型规格详情。

offset

Integer

分页参数: 起始值。

limit

Integer

分页参数:每页多少条。

total

Integer

计算类型规格总数。

表6 ComputeFlavors

参数

参数类型

描述

id

String

规格ID。

typeCode

String

资源类型编码。

code

String

DDM内部记录的虚拟机规格类型。

iaasCode

String

Iaas记录的虚拟机规格类型。

cpu

String

CPU核数。

mem

String

内存大小,单位:GB。

maxConnections

String

最大连接数。

serverType

String

计算资源服务类型。

architecture

String

计算资源架构类型,目前分X86和ARM两种。

azStatus

Map<String,String>

规格所在可用区状态,其中key是可用区编号,value是规格所在az的状态。包含如下状态:

  • normal:在售。
  • unsupported:暂不支持该规格。
  • sellout:售罄。

regionStatus

String

局点状态。

groupType

String

计算资源架构类型,目前分X86和ARM两种。

dbType

String

服务引擎类型。

extendFields

Map<String,String>

扩展字段,目前存储可用区相关信息。

状态码: 400

表7 响应Body参数

参数

参数类型

描述

errCode

String

业务错误码。

externalMessage

String

错误信息。

状态码: 500

表8 响应Body参数

参数

参数类型

描述

errCode

String

业务错误码。

externalMessage

String

错误信息。

请求示例

查询可用区规格信息。

GET https://{endpoint}/v2/{project_id}/flavors?engine_id={engine_id}&offset={offset}&limit={limit}

响应示例

状态码: 200

OK

{
  "computeFlavorGroups" : [ {
    "offset" : 0,
    "limit" : 128,
    "total" : 6,
    "groupType" : "X86",
    "computeFlavors" : [ {
      "id" : "8f2e696c-a9c1-30bd-af90-25522bc67606",
      "typeCode" : "hws.resource.type.ddm",
      "code" : "ddm.c3.large.2",
      "iaasCode" : "c3.large.2",
      "cpu" : "2",
      "mem" : "4",
      "maxConnections" : "null",
      "serverType" : "KVM",
      "architecture" : "X86",
      "azStatus" : {
        "az2.dc0" : "unsupported",
        "az3xahz" : "normal",
        "az2xahz" : "normal",
        "az1xahz" : "normal"
      },
      "regionStatus" : "normal",
      "dbType" : "DDM",
      "extendFields" : {
        "azCode" : "az2.dc0,az3xahz,az2xahz,az1xahz",
        "azDescription" : "az2.dc0,az3xahz,az2xahz,az1xahz"
      }
    } ]
  }, {
    "offset" : 0,
    "limit" : 128,
    "total" : 3,
    "groupType" : "ARM",
    "computeFlavors" : [ {
      "id" : "87a6cb8b-0c56-3e16-a91d-9b680a1f8b7f",
      "typeCode" : "hws.resource.type.ddm",
      "code" : "ddm.rc6.large.2",
      "iaasCode" : "kc1.xlarge.2",
      "cpu" : "4",
      "mem" : "8",
      "maxConnections" : "null",
      "serverType" : "KVM",
      "architecture" : "ARM",
      "azStatus" : {
        "az2.dc0" : "unsupported",
        "az3xahz" : "normal",
        "az2xahz" : "normal",
        "az1xahz" : "normal"
      },
      "regionStatus" : "normal",
      "groupType" : "null",
      "dbType" : "DDM",
      "extendFields" : {
        "azCode" : "az2.dc0,az3xahz,az2xahz,az1xahz",
        "azDescription" : "az2.dc0,az3xahz,az2xahz,az1xahz"
      }
    } ]
  } ]
}

状态码: 400

bad request

{
  "externalMessage" : "Parameter error.",
  "errCode" : "DBS.280001"
}

状态码: 500

server error

{
  "externalMessage" : "Server failure.",
  "errCode" : "DBS.200412"
}

状态码

状态码

描述

200

OK

400

bad request

500

server error

错误码

请参见错误码