查询所有实例列表
功能介绍
查询租户的实例列表,支持按照条件查询。
URI
GET /v2/{project_id}/instances
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目ID,获取方式请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
engine |
是 |
String |
参数解释: 消息引擎。 约束限制: 不涉及。 取值范围: kafka。 默认取值: 不涉及。 |
|
name |
否 |
String |
参数解释: 实例名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
instance_id |
否 |
String |
参数解释: 实例ID。获取方法如下:调用“查询所有实例列表”接口,从响应体中获取实例ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
status |
否 |
String |
参数解释: 实例状态,详细状态说明请参考实例状态说明。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
include_failure |
否 |
String |
参数解释: 是否返回创建失败的实例数。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
|
exact_match_name |
否 |
String |
参数解释: 是否按照实例名称进行精确匹配查询。 约束限制: 不涉及。 取值范围:
默认取值: 'false'。 |
|
enterprise_project_id |
否 |
String |
参数解释: 企业项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
offset |
否 |
String |
参数解释: 偏移量,表示从此偏移量开始查询。 约束限制: 不涉及。 取值范围: 大于等于0。 默认取值: 不涉及。 |
|
limit |
否 |
String |
参数解释: 当次查询返回的实例最大个数。 约束限制: 不涉及。 取值范围: 1~50。 默认取值: 10。 |
请求参数
无
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
instances |
Array of ShowInstanceResp objects |
参数解释: 实例列表。 |
|
instance_num |
Integer |
参数解释: 实例数量。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
参数解释: 实例名称。 取值范围: 不涉及。 |
|
engine |
String |
参数解释: 引擎。 取值范围: kafka |
|
engine_version |
String |
参数解释: Kafka的版本。 取值范围:
|
|
description |
String |
参数解释: 实例描述。 取值范围: 不涉及。 |
|
specification |
String |
参数解释: 实例规格。 取值范围: 不涉及。 |
|
storage_space |
Integer |
参数解释: 消息存储空间,单位:GB。 取值范围:
|
|
partition_num |
String |
参数解释: Kafka实例的分区数量。 取值范围: 不涉及。 |
|
used_storage_space |
Integer |
参数解释: 已使用的消息存储空间,单位:GB。 取值范围: 不涉及。 |
|
dns_enable |
Boolean |
参数解释: 实例是否开启域名访问功能。 取值范围:
|
|
connect_address |
String |
参数解释: 实例连接IP地址。 取值范围: 不涉及。 |
|
port |
Integer |
参数解释: 实例连接端口。 取值范围: 不涉及。 |
|
status |
String |
参数解释: 实例的状态。详细状态说明请参考实例状态说明。 取值范围: 不涉及。 |
|
instance_id |
String |
参数解释: 实例ID。 取值范围: 不涉及。 |
|
resource_spec_code |
String |
参数解释: 资源规格标识。 取值范围:
|
|
charging_mode |
Integer |
参数解释: 付费模式。 取值范围:
|
|
vpc_id |
String |
参数解释: VPC ID。 取值范围: 不涉及。 |
|
vpc_name |
String |
参数解释: VPC的名称。 取值范围: 不涉及。 |
|
created_at |
String |
参数解释: 完成创建时间。 格式为时间戳,指从格林威治时间 1970年01月01日00时00分00秒起至指定时间的偏差总毫秒数。 取值范围: 不涉及。 |
|
subnet_name |
String |
参数解释: 子网名称。 取值范围: 不涉及。 |
|
subnet_cidr |
String |
参数解释: 子网网段。 取值范围: 不涉及。 |
|
user_id |
String |
参数解释: 用户ID。 取值范围: 不涉及。 |
|
user_name |
String |
参数解释: 用户名。 取值范围: 不涉及。 |
|
access_user |
String |
参数解释: 实例访问用户名。 取值范围: 不涉及。 |
|
order_id |
String |
参数解释: 订单ID,只有在包周期计费时才会有order_id值,其他计费方式order_id值为空。 取值范围: 不涉及。 |
|
maintain_begin |
String |
参数解释: 维护时间窗开始时间,格式为HH:mm:ss。 取值范围: 不涉及。 |
|
maintain_end |
String |
参数解释: 维护时间窗结束时间,格式为HH:mm:ss。 取值范围: 不涉及。 |
|
enable_publicip |
Boolean |
参数解释: 实例是否开启公网访问功能。 取值范围:
|
|
management_connect_address |
String |
参数解释: Kafka实例的Kafka Manager连接地址。 取值范围: 不涉及。 |
|
ssl_enable |
Boolean |
参数解释: 是否开启安全认证。 取值范围:
|
|
broker_ssl_enable |
Boolean |
参数解释: 是否开启broker间副本加密传输。 取值范围:
|
|
kafka_security_protocol |
String |
参数解释: Kafka使用的安全协议。 若实例详情中不存在port_protocols返回参数,则kafka_security_protocol同时代表内网访问、公网访问以及跨VPC访问的安全协议。 若实例详情中存在port_protocols返回参数,则kafka_security_protocol仅代表跨VPC访问的安全协议。内网访问公网访问的安全协议请参考port_protocols参数。 取值范围:
|
|
sasl_enabled_mechanisms |
Array of strings |
参数解释: 开启SASL后使用的认证机制。 |
|
ssl_two_way_enable |
Boolean |
参数解释: 是否开启双向认证。 取值范围:
|
|
cert_replaced |
Boolean |
参数解释: 是否开启证书替换。 取值范围:
|
|
public_management_connect_address |
String |
参数解释: 公网访问Kafka Manager连接地址。 取值范围: 不涉及。 |
|
enterprise_project_id |
String |
参数解释: 企业项目ID。 取值范围: 不涉及。 |
|
is_logical_volume |
Boolean |
参数解释: 实例扩容时用于区分老实例与新实例。 取值范围:
|
|
extend_times |
Integer |
参数解释: 实例扩容磁盘次数,如果超过20次则无法扩容磁盘。 取值范围: 不涉及。 |
|
enable_auto_topic |
Boolean |
参数解释: 是否开启自动创建Topic。 取值范围:
|
|
type |
String |
参数解释: 实例类型。 取值范围:
|
|
product_id |
String |
参数解释: 产品标识。 取值范围: 不涉及。 |
|
security_group_id |
String |
参数解释: 安全组ID。 取值范围: 不涉及。 |
|
security_group_name |
String |
参数解释: 安全组名称。 取值范围: 不涉及。 |
|
subnet_id |
String |
参数解释: 子网ID。 取值范围: 不涉及。 |
|
available_zones |
Array of strings |
参数解释: 实例节点所在的可用区,返回“可用区ID”。 |
|
available_zone_names |
Array of strings |
参数解释: 实例节点所在的可用区名称,返回“可用区名称”。 |
|
total_storage_space |
Integer |
参数解释: 总共消息存储空间,单位:GB。 取值范围: 不涉及。 |
|
public_connect_address |
String |
参数解释: 实例公网连接IP地址。当实例开启了公网访问,实例才包含该参数。 取值范围: 不涉及。 |
|
public_connect_domain_name |
String |
参数解释: 实例公网连接域名。当实例开启了公网访问,实例才包含该参数。 取值范围: 不涉及。 |
|
storage_resource_id |
String |
参数解释: 存储资源ID。 取值范围: 不涉及。 |
|
storage_spec_code |
String |
参数解释: IO规格。 取值范围: 不涉及。 |
|
service_type |
String |
参数解释: 服务类型。 取值范围: advanced |
|
storage_type |
String |
参数解释: 存储类型。 取值范围: 不涉及。 |
|
retention_policy |
String |
参数解释: 消息老化策略。 取值范围:
|
|
kafka_public_status |
String |
参数解释: Kafka公网开启状态。 取值范围:
|
|
public_bandwidth |
Integer |
参数解释: kafka公网访问带宽。 取值范围: 不涉及。 |
|
enable_log_collection |
Boolean |
参数解释: 是否开启消息收集功能。 取值范围:
|
|
new_auth_cert |
Boolean |
参数解释: 是否开启新证书。 取值范围:
|
|
cross_vpc_info |
String |
参数解释: 跨VPC访问信息。 取值范围: 不涉及。 |
|
ipv6_enable |
Boolean |
参数解释: 是否开启IPv6。 取值范围:
|
|
ipv6_connect_addresses |
Array of strings |
参数解释: IPv6的连接地址。 |
|
connector_enable |
Boolean |
参数解释: 是否开启转储。 取值范围:
|
|
connector_node_num |
Integer |
参数解释: connector节点数量。 取值范围: 2-16。 |
|
connector_id |
String |
参数解释: 转储任务ID。 取值范围: 不涉及。 |
|
rest_enable |
Boolean |
参数解释: 是否开启Kafka rest功能。 取值范围:
|
|
rest_connect_address |
String |
参数解释: Kafka rest连接地址。 取值范围: 不涉及。 |
|
public_boundwidth |
Integer |
参数解释: Kafka公网访问带宽。待删除版本。 取值范围: 不涉及。 |
|
message_query_inst_enable |
Boolean |
参数解释: 是否开启消息查询功能。 取值范围:
|
|
vpc_client_plain |
Boolean |
参数解释: 是否开启VPC明文访问。 取值范围:
|
|
support_features |
String |
参数解释: Kafka实例支持的特性功能。 取值范围: 不涉及。 |
|
trace_enable |
Boolean |
参数解释: 是否开启消息轨迹功能。 取值范围:
|
|
agent_enable |
Boolean |
参数解释: 是否开启代理。 取值范围:
|
|
pod_connect_address |
String |
参数解释: 租户侧连接地址。 取值范围: 不涉及。 |
|
disk_encrypted |
Boolean |
参数解释: 是否开启磁盘加密。 取值范围:
|
|
disk_encrypted_key |
String |
参数解释: 磁盘加密key,未开启磁盘加密时为空。 取值范围: 不涉及。 |
|
kafka_private_connect_address |
String |
参数解释: Kafka实例内网连接地址。 取值范围: 不涉及。 |
|
kafka_private_connect_domain_name |
String |
参数解释: Kafka实例内网连接域名。 取值范围: 不涉及。 |
|
ces_version |
String |
参数解释: 云监控版本。 取值范围: 不涉及。 |
|
public_access_enabled |
String |
参数解释: 区分实例什么时候开启的公网访问 取值范围:
|
|
node_num |
Integer |
参数解释: 节点数。 取值范围:
|
|
port_protocols |
PortProtocolsEntity object |
参数解释: 实例支持的连接方式及其连接地址。 |
|
enable_acl |
Boolean |
参数解释: 是否开启访问控制。 取值范围:
|
|
new_spec_billing_enable |
Boolean |
参数解释: 是否启用新规格计费。 取值范围:
|
|
broker_num |
Integer |
参数解释: 节点数量。 取值范围: 不涉及。 |
|
tags |
Array of TagEntity objects |
参数解释: 标签列表。 |
|
dr_enable |
Boolean |
参数解释: 是否为容灾实例。 取值范围:
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
private_plain_enable |
Boolean |
参数解释: 实例是否支持内网PLAINTEXT访问接入方式。 取值范围:
|
|
private_plain_address |
String |
参数解释: Kafka内网PLAINTEXT接入方式连接地址。 取值范围: 不涉及 |
|
private_plain_domain_name |
String |
参数解释: 内网明文连接域名。 取值范围: 不涉及 |
|
private_sasl_ssl_enable |
Boolean |
参数解释: 实例是否支持内网SASL_SSL访问接入方式。 取值范围:
|
|
private_sasl_ssl_address |
String |
参数解释: Kafka内网SASL_SSL接入方式连接地址。 取值范围: 不涉及 |
|
private_sasl_ssl_domain_name |
String |
参数解释: 内网SASL_SSL连接域名。 取值范围: 不涉及 |
|
private_sasl_plaintext_enable |
Boolean |
参数解释: 实例是否支持内网SASL_PLAINTEXT访问接入方式。 取值范围:
|
|
private_sasl_plaintext_address |
String |
参数解释: Kafka内网SASL_PLAINTEXT接入方式连接地址。 取值范围: 不涉及 |
|
private_sasl_plaintext_domain_name |
String |
参数解释: 内网SASL_PLAINTEXT连接域名。 取值范围: 不涉及 |
|
public_plain_enable |
Boolean |
参数解释: 实例是否支持公网PLAINTEXT访问接入方式。 取值范围:
|
|
public_plain_address |
String |
参数解释: Kafka公网PLAINTEXT接入方式连接地址。 取值范围: 不涉及 |
|
public_plain_domain_name |
String |
参数解释: 公网明文连接域名。 取值范围: 不涉及 |
|
public_sasl_ssl_enable |
Boolean |
参数解释: 实例是否支持公网SASL_SSL访问接入方式。 取值范围:
|
|
public_sasl_ssl_address |
String |
参数解释: Kafka公网SASL_SSL接入方式连接地址。 取值范围: 不涉及 |
|
public_sasl_ssl_domain_name |
String |
参数解释: 公网SASL_SSL连接域名。 取值范围: 不涉及 |
|
public_sasl_plaintext_enable |
Boolean |
参数解释: 实例是否支持公网SASL_PLAINTEXT访问接入方式。 取值范围:
|
|
public_sasl_plaintext_address |
String |
参数解释: Kafka公网SASL_PLAINTEXT接入方式连接地址。 取值范围: 不涉及 |
|
public_sasl_plaintext_domain_name |
String |
参数解释: 公网SASL_PLAINTEXT连接域名。 取值范围: 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
key |
String |
参数解释: 标签键。 约束限制:
取值范围: 不涉及。 默认取值: 不涉及。 |
|
value |
String |
参数解释: 标签值。 约束限制:
取值范围: 不涉及。 默认取值: 不涉及。 |
请求示例
查询所有实例列表
GET https://{endpoint}/v2/{project_id}/instances
响应示例
状态码:200
查询所有实例列表成功。
{
"instances" : [ {
"name" : "kafka-2085975099",
"engine" : "kafka",
"port" : 9092,
"status" : "RUNNING",
"description" : "",
"type" : "cluster",
"specification" : "kafka.2u4g.cluster * 3 broker",
"engine_version" : 2.7,
"connect_address" : "192.168.0.100,192.168.0.61,192.168.0.72",
"instance_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"resource_spec_code" : "",
"charging_mode" : 1,
"vpc_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"vpc_name" : "dms-test",
"created_at" : "1585618587087",
"product_id" : "c6.2u4g.cluster",
"security_group_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"security_group_name" : "Sys-default",
"subnet_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"available_zones" : [ "38b0f7a602344246bcb0da47b5d548e7" ],
"available_zone_names" : [ "AZ1" ],
"user_id" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"user_name" : "paas_dms",
"maintain_begin" : "02:00:00",
"maintain_end" : "06:00:00",
"enable_log_collection" : false,
"new_auth_cert" : false,
"storage_space" : 492,
"total_storage_space" : 600,
"used_storage_space" : 25,
"partition_num" : "750",
"enable_publicip" : false,
"ssl_enable" : false,
"broker_ssl_enable" : false,
"cert_replaced" : false,
"management_connect_address" : "https://192.168.0.100:9999",
"cross_vpc_info" : "{\"192.168.0.61\":{\"advertised_ip\":\"192.168.0.61\",\"port\":9011,\"port_id\":\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"},\"192.168.0.72\":{\"advertised_ip\":\"192.168.0.72\",\"port\":9011,\"port_id\":\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"},\"192.168.0.100\":{\"advertised_ip\":\"192.168.0.100\",\"port\":9011,\"port_id\":\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"}}",
"storage_resource_id" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"storage_spec_code" : "dms.physical.storage.ultra",
"service_type" : "advanced",
"storage_type" : "hec",
"enterprise_project_id" : "0",
"is_logical_volume" : true,
"extend_times" : 0,
"retention_policy" : "produce_reject",
"ipv6_enable" : false,
"ipv6_connect_addresses" : [ ],
"connector_enable" : false,
"connector_node_num" : 0,
"connector_id" : "",
"rest_enable" : false,
"rest_connect_address" : "",
"kafka_public_status" : "closed",
"public_bandwidth" : 0,
"message_query_inst_enable" : true,
"vpc_client_plain" : false,
"support_features" : "kafka.new.pod.port,feature.physerver.kafka.topic.modify,feature.physerver.kafka.topic.accesspolicy,message_trace_enable,features.pod.token.access,feature.physerver.kafka.pulbic.dynamic,roma_app_enable,features.log.collection,auto_topic_switch,feature.physerver.kafka.user.manager",
"trace_enable" : false,
"agent_enable" : false,
"pod_connect_address" : "100.86.75.15:9080,100.86.142.77:9080,100.86.250.167:9080",
"disk_encrypted" : false,
"kafka_private_connect_address" : "192.168.0.61:9092,192.168.0.100:9092,192.168.0.72:9092",
"enable_auto_topic" : false,
"new_spec_billing_enable" : false,
"ces_version" : "linux"
} ],
"instance_num" : 1
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询所有实例列表成功。 |
错误码
请参见错误码。