查询所有实例列表
功能介绍
查询租户的实例列表，支持按照条件查询。
URI
GET /v1.0/{project_id}/instances?engine={engine}&name={name}&status={status}&id={id}&includeFailure={includeFailure}&exactMatchName={exactMatchName}&enterprise_project_id={enterprise_project_id}
参数说明见表1。
|
参数 |
类型 |
必选 |
说明 |
|---|---|---|---|
|
project_id |
String |
是 |
项目ID。 |
|
engine |
String |
否 |
消息引擎：kafka。 |
|
name |
String |
否 |
实例名称。 |
|
id |
String |
否 |
实例ID。 |
|
status |
String |
否 |
实例状态。详细状态说明见实例状态说明。 |
|
includeFailure |
String |
否 |
是否返回创建失败的实例数。 当参数值为“true”时，返回创建失败的实例数。参数值为“false”或者其他值，不返回创建失败的实例数。 |
|
exactMatchName |
String |
否 |
是否按照实例名称进行精确匹配查询。 默认为“false”，表示模糊匹配实例名称查询。若参数值为“true”表示按照实例名称进行精确匹配查询。 |
|
enterprise_project_id |
String |
否 |
企业项目ID。 |
请求消息
请求参数
无。
请求示例
GET https://{dms_endpoint}/v1.0/{project_id}/instances?start=1&limit=10&name=&status=&id=&includeFailure=true&exactMatchName=false响应消息
响应参数
参数说明见表2。
|
参数 |
类型 |
说明 |
|---|---|---|
|
name |
String |
实例名称。 |
|
engine |
String |
引擎。 |
|
engine_version |
String |
版本。 |
|
specification |
String |
实例规格。 |
|
storage_space |
Integer |
消息存储空间，单位：GB。 |
|
partition_num |
String |
Kafka实例的最大topic数。 |
|
used_storage_space |
Integer |
已使用的消息存储空间，单位：GB。 |
|
connect_address |
String |
实例连接IP地址。 |
|
port |
Integer |
实例连接端口。 |
|
status |
String |
实例的状态。详细状态说明见实例状态说明。 |
|
instance_id |
String |
实例ID。 |
|
resource_spec_code |
String |
资源规格标识。
|
|
charging_mode |
Integer |
付费模式，1表示按需计费，0表示包年/包月计费。 |
|
vpc_id |
String |
VPC ID。 |
|
vpc_name |
String |
VPC的名称。 |
|
created_at |
String |
完成创建时间。 格式为时间戳，指从格林威治时间 1970年01月01日00时00分00秒起至指定时间的偏差总毫秒数。 |
|
user_id |
String |
用户id。 |
|
user_name |
String |
用户名。 |
|
access_user |
String |
实例的用户名。 |
|
order_id |
String |
订单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 |
是否开启安全认证。
|
|
enterprise_project_id |
String |
企业项目ID。 |
|
is_logical_volume |
Boolean |
实例扩容时用于区分老实例与新实例。
|
|
extend_times |
Integer |
实例扩容磁盘次数，如果超过20次则无法扩容磁盘。 |
|
enable_auto_topic |
Boolean |
是否打开kafka自动创建topic功能。
|
|
type |
String |
实例类型：集群，cluster。 |
|
product_id |
String |
产品标识。 |
|
security_group_id |
String |
安全组ID。 |
|
security_group_name |
String |
租户安全组名称。 |
|
subnet_id |
String |
子网ID。 |
|
available_zones |
Array |
实例节点所在的可用区，返回“可用区ID”。 |
|
total_storage_space |
Integer |
总共消息存储空间，单位：GB。 |
|
public_connect_address |
String |
实例公网连接IP地址。当实例开启了公网访问，实例才包含该参数。 |
|
storage_resource_id |
String |
存储资源ID。 |
|
storage_spec_code |
String |
IO规格。 |
|
service_type |
String |
服务类型。 |
|
storage_type |
String |
存储类型。 |
|
retention_policy |
String |
消息老化策略。 |
|
kafka_public_status |
String |
Kafka公网开启状态。 |
|
public_bandwidth |
Integer |
公网带宽。 |
|
kafka_manager_user |
String |
登录Kafka Manager的用户名。 |
|
enable_log_collection |
Boolean |
是否开启消息收集功能。 |
|
cross_vpc_info |
String |
跨VPC访问信息。 |
|
ipv6_enable |
Boolean |
是否开启ipv6。 |
|
ipv6_connect_addresses |
Array of strings |
IPv6的连接地址。 |
|
connector_enable |
Boolean |
是否开启转储。 |
|
connector_id |
String |
转储任务ID。 |
|
rest_enable |
Boolean |
是否开启Kafka rest功能。 |
|
rest_connect_address |
String |
Kafka rest地址。 |
|
message_query_inst_enable |
Boolean |
是否开启消息查询功能。 |
|
vpc_client_plain |
Boolean |
是否开启VPC明文访问。 |
|
support_features |
String |
Kafka实例支持的特性功能。 |
|
trace_enable |
Boolean |
是否开启消息轨迹功能。 |
|
pod_connect_address |
String |
租户侧连接地址。 |
|
disk_encrypted |
Boolean |
是否开启磁盘加密。 |
|
kafka_private_connect_address |
String |
Kafka实例私有连接地址。 |
|
ces_version |
String |
云监控版本。 |
|
tags |
Array<Object> |
标签列表。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
key |
String |
标签的键。 |
|
value |
String |
标签的值。 |
响应示例
{
"instances": [
{
"name": "kafka-l00230526",
"engine": "kafka",
"port": 9092,
"status": "RUNNING",
"type": "cluster",
"specification": "100MB",
"engine_version": "XXX",
"connect_address": "192.168.1.116,192.168.1.152,192.168.1.78",
"instance_id": "ef84dd5f-3ece-4336-8c99-987defd62e3a",
"resource_spec_code": "dms.instance.kafka.cluster.c3.mini",
"charging_mode": 1,
"vpc_id": "2477879f-aebf-496f-a08a-67812885ce9b",
"vpc_name": "vpc-y00502467",
"created_at": "1568797295209",
"product_id": "00300-30308-0--0",
"security_group_id": "008a08e2-10cc-4d9b-90ab-3f3b8f6c3333",
"security_group_name": "z00417080-cce-node-na7j",
"subnet_id": "5ca08fb7-7522-4d95-9fa5-ff6b3592a29d",
"available_zones": [
"ae04cf9d61544df3806a3feeb401b204"
],
"user_id": "2b4af4428ec840dfa1f0f1a32e965567",
"user_name": "laiyh",
"kafka_manager_user": "root",
"maintain_begin": "22:00",
"maintain_end": "02:00",
"storage_space": 492,
"total_storage_space": 600,
"used_storage_space": 25,
"partition_num": "300",
"ssl_enable": false,
"management_connect_address": "https://192.168.1.116:9999",
"storage_resource_id": "81982562-ce8b-490a-95fa-2b225c292271",
"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": [],
"rest_enable": false,
"rest_connect_address": "",
"message_query_inst_enable": true,
"vpc_client_plain": false,
"support_features": "feature.physerver.kafka.topic.accesspolicy,message_trace_enable,features.pod.token.access,feature.physerver.kafka.pulbic.dynamic,feature.physerver.kafka.user.manager",
"trace_enable": false,
"agent_enable": false,
"pod_connect_address": "100.113.16.105:9100,100.113.5.197:9100,100.113.15.231:9100",
"disk_encrypted": false,
"enable_auto_topic": true
}
],
"instance_num": 1
}
