# 查询实例的扩容规格列表（新规格）
#### 功能介绍
查询实例的扩容规格列表。
![](https://support.huaweicloud.com/api-kafka/public_sys-resources/note_3.0-zh-cn.png)
当前页面API为历史版本API，未来可能停止维护。请使用[查询实例的扩容规格列表](https://support.huaweicloud.com/api-kafka/ShowKafkaInstanceExtendProductInfo.html)。
#### URI
GET /v2/{engine}/{project_id}/instances/{instance_id}/extend
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                         |
|:---|:---|:---|:---|
| engine      | 是    | String | 消息引擎。                                                                                      |
| project_id  | 是    | String | 项目ID，获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-kafka/kafka-api-0036212547.html)。 |
| instance_id | 是    | String | 实例ID。                                                                                      |
   
表2Query参数 
| 参数   | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| type | 是    | String | 产品的类型。 - advanced: 专享版   |
   
#### 请求参数
无
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数       | 参数类型                                                                                                               | 描述            |
|:---|:---|:---|
| engine   | String                                                                                                             | 消息引擎类型：kafka。 |
| versions | Array of strings                                                                                                   | 消息引擎支持的版本。    |
| products | Array of [ExtendProductInfoEntity] objects | 规格变更的产品信息。    |
   
 表4ExtendProductInfoEntity 
| 参数                | 参数类型                                                                                                                                     | 描述           |
|:---|:---|:---|
| type              | String                                                                                                                                   | 实例类型。        |
| product_id        | String                                                                                                                                   | 产品ID。        |
| ecs_flavor_id     | String                                                                                                                                   | 该产品使用的ECS规格。 |
| arch_types        | Array of strings                                                                                                                         | 支持的CPU架构类型。  |
| charging_mode     | Array of strings                                                                                                                         | 支持的计费模式类型。   |
| ios               | Array of [ExtendProductIosEntity] objects                         | 磁盘IO信息。      |
| support_features  | Array of [ExtendProductSupportFeaturesEntity] objects | 支持的特性功能。     |
| properties        | [ExtendProductPropertiesEntity] object                     | 产品规格属性描述。    |
| available_zones   | Array of strings                                                                                                                         | 有可用资源的可用区列表。 |
| unavailable_zones | Array of strings                                                                                                                         | 资源售罄的可用区列表。  |
   
 表5ExtendProductIosEntity 
| 参数                | 参数类型             | 描述           |
|:---|:---|:---|
| io_spec           | String           | 存储IO规格。      |
| available_zones   | Array of strings | 有可用资源的可用区列表。 |
| type              | String           | IO类型。        |
| unavailable_zones | Array of strings | 资源售罄的可用区列表。  |
   
 表6ExtendProductSupportFeaturesEntity 
| 参数         | 参数类型                 | 描述        |
|:---|:---|:---|
| name       | String               | 特性名称。     |
| properties | Map\<String,String\> | 功能特性的键值对。 |
   
 表7ExtendProductPropertiesEntity 
| 参数                       | 参数类型   | 描述               |
|:---|:---|:---|
| max_partition_per_broker | String | 每个Broker的最大分区数。  |
| max_broker               | String | Broker的最大个数。     |
| max_storage_per_node     | String | 每个节点的最大存储。单位为GB。 |
| max_consumer_per_broker  | String | 每个Broker的最大消费者数。 |
| min_broker               | String | Broker的最小个数。     |
| max_bandwidth_per_broker | String | 每个Broker的最大带宽。   |
| min_storage_per_node     | String | 每个节点的最小存储。单位为GB。 |
| max_tps_per_broker       | String | 每个Broker的最大TPS。  |
| product_alias            | String | product_id的别名。   |
   
#### 请求示例
查询实例的扩容规格列表。
```
GET https://{endpoint}/v2/{engine}/{project_id}/instances/{instance_id}/extend?type={type}
```
#### 响应示例
**状态码： 200**
查询实例的扩容规格列表成功。
```
{
  "engine" : "kafka",
  "versions" : [ "2.7" ],
  "products" : [ {
    "type" : "cluster",
    "product_id" : "c6.2u4g.cluster",
    "ecs_flavor_id" : "c3.large.2",
    "arch_types" : [ "X86" ],
    "charging_mode" : [ "monthly", "hourly" ],
    "ios" : [ {
      "io_spec" : "dms.physical.storage.high.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    }, {
      "io_spec" : "dms.physical.storage.ultra.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    } ],
    "support_features" : [ {
      "name" : "connector_obs",
      "properties" : {
        "max_task" : "10",
        "max_node" : "10",
        "min_task" : "1",
        "min_node" : "2"
      }
    } ],
    "properties" : {
      "max_partition_per_broker" : "250",
      "max_broker" : "30",
      "max_storage_per_node" : "10000",
      "max_consumer_per_broker" : "4000",
      "min_broker" : "3",
      "product_alias" : "kafka.2u4g.cluster",
      "max_bandwidth_per_broker" : "100",
      "min_storage_per_node" : "100",
      "max_tps_per_broker" : "30000"
    },
    "available_zones" : [ "xxx" ],
    "unavailable_zones" : [ ]
  }, {
    "type" : "cluster",
    "product_id" : "c6.2u4g.cluster.dec",
    "ecs_flavor_id" : "c6.large.2",
    "arch_types" : [ "X86" ],
    "charging_mode" : [ "monthly", "hourly" ],
    "ios" : [ {
      "io_spec" : "dms.physical.storage.high.dss.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    }, {
      "io_spec" : "dms.physical.storage.ultra.dss.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    }, {
      "io_spec" : "dms.physical.storage.ultra.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    }, {
      "io_spec" : "dms.physical.storage.high.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    } ],
    "support_features" : [ {
      "name" : "connector_obs",
      "properties" : {
        "max_task" : "10",
        "max_node" : "10",
        "min_task" : "1",
        "min_node" : "2"
      }
    } ],
    "properties" : {
      "max_partition_per_broker" : "100",
      "max_broker" : "30",
      "max_storage_per_node" : "400",
      "max_consumer_per_broker" : "4000",
      "min_broker" : "3",
      "product_alias" : "kafka.2u4g.cluster.dec",
      "max_bandwidth_per_broker" : "100",
      "min_storage_per_node" : "100",
      "max_tps_per_broker" : "30000"
    },
    "available_zones" : [ ],
    "unavailable_zones" : [ "xxx" ]
  }, {
    "type" : "cluster",
    "product_id" : "c6.4u8g.cluster",
    "ecs_flavor_id" : "c3.xlarge.2",
    "arch_types" : [ "X86" ],
    "charging_mode" : [ "monthly", "hourly" ],
    "ios" : [ {
      "io_spec" : "dms.physical.storage.high.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    }, {
      "io_spec" : "dms.physical.storage.ultra.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    } ],
    "support_features" : [ {
      "name" : "connector_obs",
      "properties" : {
        "max_task" : "10",
        "max_node" : "10",
        "min_task" : "1",
        "min_node" : "2"
      }
    } ],
    "properties" : {
      "max_partition_per_broker" : "500",
      "max_broker" : "30",
      "max_storage_per_node" : "20000",
      "max_consumer_per_broker" : "4000",
      "min_broker" : "3",
      "product_alias" : "kafka.4u8g.cluster",
      "max_bandwidth_per_broker" : "100",
      "min_storage_per_node" : "100",
      "max_tps_per_broker" : "100000"
    },
    "available_zones" : [ "xxx" ],
    "unavailable_zones" : [ ]
  }, {
    "type" : "cluster",
    "product_id" : "c6.8u16g.cluster",
    "ecs_flavor_id" : "c3.2xlarge.2",
    "arch_types" : [ "X86" ],
    "charging_mode" : [ "monthly", "hourly" ],
    "ios" : [ {
      "io_spec" : "dms.physical.storage.high.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    }, {
      "io_spec" : "dms.physical.storage.ultra.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    } ],
    "support_features" : [ {
      "name" : "connector_obs",
      "properties" : {
        "max_task" : "10",
        "max_node" : "10",
        "min_task" : "1",
        "min_node" : "2"
      }
    } ],
    "properties" : {
      "max_partition_per_broker" : "1000",
      "max_broker" : "30",
      "max_storage_per_node" : "30000",
      "max_consumer_per_broker" : "4000",
      "min_broker" : "3",
      "product_alias" : "kafka.8u16g.cluster",
      "max_bandwidth_per_broker" : "100",
      "min_storage_per_node" : "100",
      "max_tps_per_broker" : "150000"
    },
    "available_zones" : [ "xxx" ],
    "unavailable_zones" : [ ]
  }, {
    "type" : "cluster",
    "product_id" : "c6.12u24g.cluster",
    "ecs_flavor_id" : "c3.3xlarge.2",
    "arch_types" : [ "X86" ],
    "charging_mode" : [ "monthly", "hourly" ],
    "ios" : [ {
      "io_spec" : "dms.physical.storage.high.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    }, {
      "io_spec" : "dms.physical.storage.ultra.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    } ],
    "support_features" : [ {
      "name" : "connector_obs",
      "properties" : {
        "max_task" : "10",
        "max_node" : "10",
        "min_task" : "1",
        "min_node" : "2"
      }
    } ],
    "properties" : {
      "max_partition_per_broker" : "1500",
      "max_broker" : "30",
      "max_storage_per_node" : "30000",
      "max_consumer_per_broker" : "4000",
      "min_broker" : "3",
      "product_alias" : "kafka.12u24g.cluster",
      "max_bandwidth_per_broker" : "100",
      "min_storage_per_node" : "100",
      "max_tps_per_broker" : "200000"
    },
    "available_zones" : [ "xxx" ],
    "unavailable_zones" : [ ]
  }, {
    "type" : "cluster",
    "product_id" : "c6.16u32g.cluster",
    "ecs_flavor_id" : "c3.4xlarge.2",
    "arch_types" : [ "X86" ],
    "charging_mode" : [ "monthly", "hourly" ],
    "ios" : [ {
      "io_spec" : "dms.physical.storage.high.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    }, {
      "io_spec" : "dms.physical.storage.ultra.v2",
      "available_zones" : [ "xxx" ],
      "type" : "evs",
      "unavailable_zones" : [ ]
    } ],
    "support_features" : [ {
      "name" : "connector_obs",
      "properties" : {
        "max_task" : "10",
        "max_node" : "10",
        "min_task" : "1",
        "min_node" : "2"
      }
    } ],
    "properties" : {
      "max_partition_per_broker" : "2000",
      "max_broker" : "30",
      "max_storage_per_node" : "30000",
      "max_consumer_per_broker" : "4000",
      "min_broker" : "3",
      "product_alias" : "kafka.16u32g.cluster",
      "max_bandwidth_per_broker" : "100",
      "min_storage_per_node" : "100",
      "max_tps_per_broker" : "250000"
    },
    "available_zones" : [ "xxx" ],
    "unavailable_zones" : [ ]
  } ]
}
```
#### 状态码
| 状态码 | 描述             |
|:---|:---|
| 200 | 查询实例的扩容规格列表成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-kafka/ErrorCode.html)。