# 查询DDM可用区规格信息 #### 功能介绍 查询DDM可用区规格信息详情。 #### 接口约束 无 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DDM&api=ListFlavors)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI GET /v2/{project_id}/flavors?engine_id={engine_id}\&offset={offset}\&limit={limit} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ddm/ddm_api_01_0063.html)。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | engine_id | 是 | String | 引擎ID，通过查询DDM引擎信息接口获取。 | | offset | 否 | Integer | 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0。 取值必须为数字，且不能为负数。 | | limit | 否 | Integer | 查询个数上限值。 取值范围：1\~128。 不传该参数时，默认值为128。 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务的"获取用户Token"接口来获取。 | #### 响应参数 **状态码： 200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | computeFlavorGroups | Array of [ComputeFlavorGroupsInfo] objects | 计算类型规格组。 | 表5ComputeFlavorGroupsInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | groupType | String | 计算资源架构类型，目前分X86和ARM两种。 | | computeFlavors | Array of [ComputeFlavors] objects | 计算类型规格详情。 | | offset | Integer | 分页参数: 起始值。 | | limit | Integer | 分页参数：每页多少条。 | | total | Integer | 计算类型规格总数。 | 表6ComputeFlavors | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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\ | 规格所在可用区状态，其中key是可用区编号，value是规格所在az的状态。包含如下状态： - normal：在售。 - unsupported：暂不支持该规格。 - sellout：售罄。 | | regionStatus | String | 局点状态。 | | groupType | String | 计算资源架构类型，目前分X86和ARM两种。 | | dbType | String | 服务引擎类型。 | | extendFields | Map\ | 扩展字段，目前存储可用区相关信息。 | **状态码： 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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。