查询产品规格列表

功能介绍

在创建Kafka实例时，需要配置订购的产品ID（即product_id），可通过该接口查询产品规格。

例如，要订购按需计费、基准带宽为100MB的Kafka实例，可从接口响应消息中，查找Hourly的消息体，然后找到bandwidth为100MB的记录对应的product_id，该product_id的值即是创建上述Kafka实例时需要配置的产品ID。

同时，unavailable_zones字段表示资源不足的可用区列表，如果为空，则表示所有可用区都有资源，如果不为空，则表示字段值的可用区没有资源。所以必须确保您购买的资源所在的可用区有资源，不在该字段列表内。

当前页面API为历史版本API，未来可能停止维护。请使用查询产品规格列表。

URI

GET /v2/products

表1 Query参数
参数	是否必选	参数类型	描述
engine	是	String	消息引擎的类型。当前只支持Kafka类型。

请求参数

无

响应参数

状态码： 200

表2 响应Body参数
参数	参数类型	描述
Hourly	Array of Hourly objects	表示按需付费的产品列表。
Monthly	Array of Monthly objects	表示包年包月的产品列表。当前暂不支持通过API创建包年包月的Kafka实例。

表3 Hourly
参数	参数类型	描述
name	String	消息引擎的名称，该字段显示为kafka。
version	String	消息引擎的版本，当前支持1.1.0、2.3.0和2.7。
values	Array of values objects	产品规格列表。

表4 values
参数	参数类型	描述
detail	Array of detail objects	规格详情。
name	String	实例类型。
unavailable_zones	Array of strings	资源售罄的可用区列表。
available_zones	Array of strings	有可用资源的可用区列表。

表5 detail
参数	参数类型	描述
tps	String	单位时间内的消息量最大值。
storage	String	消息存储空间。
partition_num	String	Kafka实例的分区数量。
product_id	String	产品ID。
spec_code	String	规格ID。
io	Array of io objects	IO信息。
bandwidth	String	Kafka实例的基准带宽。
unavailable_zones	Array of strings	资源售罄的可用区列表。
available_zones	Array of strings	有可用资源的可用区列表。
ecs_flavor_id	String	该产品规格对应的虚拟机规格。
arch_type	String	实例规格架构类型。当前仅支持X86。

表6 io
参数	参数类型	描述
io_type	String	IO类型。
storage_spec_code	String	IO规格。
available_zones	Array of strings	IO未售罄的可用区列表。
unavailable_zones	Array of strings	IO已售罄的不可用区列表。
volume_type	String	磁盘类型。

表7 Monthly
参数	参数类型	描述
name	String	消息引擎的名称，该字段显示为kafka。
version	String	消息引擎的版本，当前支持1.1.0、2.3.0和2.7。
values	Array of values objects	产品规格列表。

表8 values
参数	参数类型	描述
detail	Array of detail objects	规格详情。
name	String	实例类型。
unavailable_zones	Array of strings	资源售罄的可用区列表。
available_zones	Array of strings	有可用资源的可用区列表。

表9 detail
参数	参数类型	描述
tps	String	单位时间内的消息量最大值。
storage	String	消息存储空间。
partition_num	String	Kafka实例的分区数量。
product_id	String	产品ID。
spec_code	String	规格ID。
io	Array of io objects	IO信息。
bandwidth	String	Kafka实例的基准带宽。
unavailable_zones	Array of strings	资源售罄的可用区列表。
available_zones	Array of strings	有可用资源的可用区列表。
ecs_flavor_id	String	该产品规格对应的虚拟机规格。
arch_type	String	实例规格架构类型。当前仅支持X86。

**表10** io
参数	参数类型	描述
io_type	String	IO类型。
storage_spec_code	String	IO规格。
available_zones	Array of strings	IO未售罄的可用区列表。
unavailable_zones	Array of strings	IO已售罄的不可用区列表。
volume_type	String	磁盘类型。

请求示例

GET https://{endpoint}/v2/products?engine=kafka

响应示例

状态码： 200

查询产品规格列表成功。

{
  "Hourly" : [ {
    "name" : "kafka",
    "version" : "1.1.0",
    "values" : [ {
      "detail" : [ {
        "tps" : "50000",
        "storage" : "200",
        "partition_num" : "300",
        "product_id" : "00300-30308-0--0",
        "spec_code" : "dms.instance.kafka.cluster.c3.mini",
        "io" : [ {
          "io_type" : "normal",
          "storage_spec_code" : "dms.physical.storage.normal",
          "available_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "volume_type" : "SATA"
        }, {
          "io_type" : "high",
          "storage_spec_code" : "dms.physical.storage.high",
          "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "available_zones" : [ ],
          "volume_type" : "SAS"
        }, {
          "io_type" : "ultra",
          "storage_spec_code" : "dms.physical.storage.ultra",
          "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "available_zones" : [ ],
          "volume_type" : "SSD"
        } ],
        "bandwidth" : "100MB",
        "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx" ],
        "available_zones" : [ "xx-xx-xx" ],
        "ecs_flavor_id" : "s6.large.2",
        "arch_type" : "X86"
      }, {
        "tps" : "100000",
        "storage" : "1200",
        "partition_num" : "900",
        "product_id" : "00300-30310-0--0",
        "spec_code" : "dms.instance.kafka.cluster.c3.small.2",
        "io" : [ {
          "io_type" : "normal",
          "storage_spec_code" : "dms.physical.storage.normal",
          "available_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "volume_type" : "SATA"
        }, {
          "io_type" : "high",
          "storage_spec_code" : "dms.physical.storage.high",
          "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "available_zones" : [ ],
          "volume_type" : "SAS"
        }, {
          "io_type" : "ultra",
          "storage_spec_code" : "dms.physical.storage.ultra",
          "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "available_zones" : [ ],
          "volume_type" : "SSD"
        } ],
        "bandwidth" : "300MB",
        "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx" ],
        "available_zones" : [ "xx-xx-xx" ],
        "ecs_flavor_id" : "c3.medium.2",
        "arch_type" : "X86"
      } ],
      "name" : "cluster",
      "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx" ],
      "available_zones" : [ "xx-xx-xx" ]
    } ]
  } ],
  "Monthly" : [ {
    "name" : "kafka",
    "version" : "1.1.0",
    "values" : [ {
      "detail" : [ {
        "tps" : "50000",
        "storage" : "200",
        "partition_num" : "300",
        "product_id" : "00300-30309-0--0",
        "spec_code" : "dms.instance.kafka.cluster.c3.mini",
        "io" : [ {
          "io_type" : "normal",
          "storage_spec_code" : "dms.physical.storage.normal",
          "available_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "volume_type" : "SATA"
        }, {
          "io_type" : "high",
          "storage_spec_code" : "dms.physical.storage.high",
          "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "available_zones" : [ ],
          "volume_type" : "SAS"
        }, {
          "io_type" : "ultra",
          "storage_spec_code" : "dms.physical.storage.ultra",
          "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "available_zones" : [ ],
          "volume_type" : "SSD"
        } ],
        "bandwidth" : "100MB",
        "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx" ],
        "available_zones" : [ "xx-xx-xx" ],
        "ecs_flavor_id" : "s6.large.2",
        "arch_type" : "X86"
      }, {
        "tps" : "100000",
        "storage" : "1200",
        "partition_num" : "900",
        "product_id" : "00300-30311-0--0",
        "spec_code" : "dms.instance.kafka.cluster.c3.small.2",
        "io" : [ {
          "io_type" : "normal",
          "storage_spec_code" : "dms.physical.storage.normal",
          "available_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "volume_type" : "SATA"
        }, {
          "io_type" : "high",
          "storage_spec_code" : "dms.physical.storage.high",
          "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "available_zones" : [ ],
          "volume_type" : "SAS"
        }, {
          "io_type" : "ultra",
          "storage_spec_code" : "dms.physical.storage.ultra",
          "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx", "xx-xx-xx" ],
          "available_zones" : [ ],
          "volume_type" : "SSD"
        } ],
        "bandwidth" : "300MB",
        "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx" ],
        "available_zones" : [ "xx-xx-xx" ],
        "ecs_flavor_id" : "c3.medium.2",
        "arch_type" : "X86"
      } ],
      "name" : "cluster",
      "unavailable_zones" : [ "xx-xx-xx", "xx-xx-xx" ],
      "available_zones" : [ "xx-xx-xx" ]
    } ]
  } ]
}