查询产品规格列表
功能介绍
在创建Kafka实例时,需要配置订购的产品ID(即product_id),可通过该接口查询产品规格。
例如,要订购按需计费、基准带宽为100MB的Kafka实例,可从接口响应消息中,查找Hourly的消息体,然后找到bandwidth为100MB的记录对应的product_id,该product_id的值即是创建上述Kafka实例时需要配置的产品ID。
同时,unavailable_zones字段表示资源不足的可用区列表,如果为空,则表示所有可用区都有资源,如果不为空,则表示字段值的可用区没有资源。所以必须确保您购买的资源所在的可用区有资源,不在该字段列表内。
当前页面API为历史版本API,未来可能停止维护。请使用查询产品规格列表。
URI
GET /v2/products
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
engine |
是 |
String |
消息引擎的类型。当前只支持Kafka类型。 |
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
Hourly |
Array of Hourly objects |
表示按需付费的产品列表。 |
Monthly |
Array of Monthly objects |
表示包年包月的产品列表。当前暂不支持通过API创建包年包月的Kafka实例。 |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
消息引擎的名称,该字段显示为kafka。 |
version |
String |
消息引擎的版本,当前支持1.1.0、2.3.0和2.7。 |
values |
Array of values objects |
产品规格列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
detail |
Array of detail objects |
规格详情。 |
name |
String |
实例类型。 |
unavailable_zones |
Array of strings |
资源售罄的可用区列表。 |
available_zones |
Array of strings |
有可用资源的可用区列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
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。 |
参数 |
参数类型 |
描述 |
---|---|---|
io_type |
String |
IO类型。 |
storage_spec_code |
String |
IO规格。 |
available_zones |
Array of strings |
IO未售罄的可用区列表。 |
unavailable_zones |
Array of strings |
IO已售罄的不可用区列表。 |
volume_type |
String |
磁盘类型。 |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
消息引擎的名称,该字段显示为kafka。 |
version |
String |
消息引擎的版本,当前支持1.1.0、2.3.0和2.7。 |
values |
Array of values objects |
产品规格列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
detail |
Array of detail objects |
规格详情。 |
name |
String |
实例类型。 |
unavailable_zones |
Array of strings |
资源售罄的可用区列表。 |
available_zones |
Array of strings |
有可用资源的可用区列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
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。 |
参数 |
参数类型 |
描述 |
---|---|---|
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" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "volume_type" : "SATA" }, { "io_type" : "high", "storage_spec_code" : "dms.physical.storage.high", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "available_zones" : [ ], "volume_type" : "SAS" }, { "io_type" : "ultra", "storage_spec_code" : "dms.physical.storage.ultra", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "available_zones" : [ ], "volume_type" : "SSD" } ], "bandwidth" : "100MB", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a" ], "available_zones" : [ "cn-north-7c" ], "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" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "volume_type" : "SATA" }, { "io_type" : "high", "storage_spec_code" : "dms.physical.storage.high", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "available_zones" : [ ], "volume_type" : "SAS" }, { "io_type" : "ultra", "storage_spec_code" : "dms.physical.storage.ultra", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "available_zones" : [ ], "volume_type" : "SSD" } ], "bandwidth" : "300MB", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a" ], "available_zones" : [ "cn-north-7c" ], "ecs_flavor_id" : "c3.medium.2", "arch_type" : "X86" } ], "name" : "cluster", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a" ], "available_zones" : [ "cn-north-7c" ] } ] } ], "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" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "volume_type" : "SATA" }, { "io_type" : "high", "storage_spec_code" : "dms.physical.storage.high", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "available_zones" : [ ], "volume_type" : "SAS" }, { "io_type" : "ultra", "storage_spec_code" : "dms.physical.storage.ultra", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "available_zones" : [ ], "volume_type" : "SSD" } ], "bandwidth" : "100MB", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a" ], "available_zones" : [ "cn-north-7c" ], "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" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "volume_type" : "SATA" }, { "io_type" : "high", "storage_spec_code" : "dms.physical.storage.high", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "available_zones" : [ ], "volume_type" : "SAS" }, { "io_type" : "ultra", "storage_spec_code" : "dms.physical.storage.ultra", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a", "cn-north-7c" ], "available_zones" : [ ], "volume_type" : "SSD" } ], "bandwidth" : "300MB", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a" ], "available_zones" : [ "cn-north-7c" ], "ecs_flavor_id" : "c3.medium.2", "arch_type" : "X86" } ], "name" : "cluster", "unavailable_zones" : [ "cn-north-7b", "cn-north-7a" ], "available_zones" : [ "cn-north-7c" ] } ] } ] }
状态码
状态码 |
描述 |
---|---|
200 |
查询产品规格列表成功。 |
错误码
请参见错误码。