查询所有实例列表
功能介绍
查询租户的实例列表,支持按照条件查询。
URI
GET /v2/{project_id}/instances
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,获取方式请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| engine | 否 | String | 参数解释: 消息引擎类型。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| name | 否 | String | 参数解释: 实例名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| instance_id | 否 | String | 参数解释: 实例ID。获取方法如下:调用“查询所有实例列表”接口,从响应体中获取实例ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| status | 否 | String | 参数解释: 实例状态。 约束限制: 不涉及。 取值范围: 详细状态说明请参考实例状态说明。 默认取值: 不涉及。 |
| include_failure | 否 | String | 参数解释: 是否返回创建失败的实例数。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| exact_match_name | 否 | String | 参数解释: 是否按照实例名称进行精确匹配查询。 约束限制: 不涉及。 取值范围: 默认取值: 'false'。 |
| enterprise_project_id | 否 | String | 参数解释: 企业项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| limit | 否 | Integer | 参数解释: 查询返回实例的个数。 约束限制: 不涉及。 取值范围: 1~50。 默认取值: 10。 |
| offset | 否 | Integer | 参数解释: 偏移量,表示从此偏移量开始查询。 约束限制: 不涉及。 取值范围: 大于等于0。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| instances | Array of InstanceDetail objects | 参数解释: 实例列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| instance_num | Integer | 参数解释: 实例数量。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| name | String | 参数解释: 实例名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| engine | String | 参数解释: 消息引擎。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| status | String | 参数解释: 状态。 约束限制: 不涉及。 取值范围: 详细状态说明请参考实例状态说明。 默认取值: 不涉及。 |
| description | String | 参数解释: 消息描述。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| type | String | 参数解释: 实例类型。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| specification | String | 参数解释: 规格说明。 约束限制: 不涉及。 取值范围:
资源规格和其他参数取值请参考产品规格章节中对应版本的实例规格说明表。 默认取值: 不涉及。 |
| engine_version | String | 参数解释: 实例版本。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| instance_id | String | 参数解释: 实例ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| arch_type | String | 参数解释: 架构类型。 取值范围: |
| charging_mode | Integer | 参数解释: 付费模式。 约束限制: 不涉及。 取值范围: 1表示按需计费。 默认取值: 不涉及。 |
| vpc_id | String | 参数解释: 私有云ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| vpc_name | String | 参数解释: 私有云名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| created_at | String | 参数解释: 完成创建时间。 格式为时间戳,指从格林威治时间1970年01月01日00时00分00秒起至指定时间的偏差总毫秒数。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| product_id | String | 参数解释: RocketMQ实例规格。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| security_group_id | String | 参数解释: 安全组ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| security_group_name | String | 参数解释: 安全组名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| subnet_id | String | 参数解释: 子网ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| subnet_cidr | String | 参数解释: 子网路由。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| available_zones | Array of strings | 参数解释: 可用区ID列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| available_zone_names | Array of strings | 参数解释: 可用区名称列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| user_id | String | 参数解释: 用户ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| user_name | String | 参数解释: 用户名。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| maintain_begin | String | 参数解释: 维护时间窗开始时间,格式为HH:mm:ss。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| maintain_end | String | 参数解释: 维护时间窗结束时间,格式为HH:mm:ss。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| enable_log_collection | Boolean | 参数解释: 是否开启消息收集功能。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| storage_space | Integer | 参数解释: 存储空间,单位:GB。 约束限制: 不涉及。 取值范围: 不同的实例规格支持不同的存储配置。 默认取值: 不涉及。 |
| used_storage_space | Integer | 参数解释: 已用消息存储空间,单位:GB。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| enable_publicip | Boolean | 参数解释: 是否开启公网。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| publicip_id | String | 参数解释: 实例绑定的弹性IP地址的ID。 以英文逗号隔开多个弹性IP地址的ID。 如果开启了公网访问功能(即enable_publicip为true),该字段为必选。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| publicip_address | String | 参数解释: 公网IP地址。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| ssl_enable | Boolean | 参数解释: 是否开启SSL。 取值范围: |
| cross_vpc_info | String | 参数解释: 跨VPC访问信息。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| storage_resource_id | String | 参数解释: 存储资源ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| storage_spec_code | String | 参数解释: 存储规格代码。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| service_type | String | 参数解释: 服务类型。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| storage_type | String | 参数解释: 存储类型。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| extend_times | Long | 参数解释: 扩展时间。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| ipv6_enable | Boolean | 参数解释: 是否开启IPv6。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| support_features | String | 参数解释: 实例支持的特性功能。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| disk_encrypted | Boolean | 参数解释: 是否开启磁盘加密。 取值范围: |
| ces_version | String | 参数解释: 云监控版本。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| node_num | Integer | 参数解释: 节点数。(仅RocketMQ 4.8.0版本会显示此字段) 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| new_spec_billing_enable | Boolean | 参数解释: 是否启用新规格计费。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| enable_acl | Boolean | 参数解释: 是否开启访问控制列表。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| broker_num | Integer | 参数解释: Broker节点数。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| dns_enable | Boolean | 参数解释: 实例是否开启域名访问功能。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| namesrv_address | String | 参数解释: 元数据地址。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| namesrv_domain_name | String | 参数解释: 元数据域名。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| broker_address | String | 参数解释: 业务数据地址。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| public_namesrv_address | String | 参数解释: 公网元数据地址。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| public_namesrv_domain_name | String | 参数解释: 公网元数据域名。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| public_broker_address | String | 参数解释: 公网业务数据地址。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| grpc_address | String | 参数解释: grpc连接地址(仅RocketMQ 5.x版本会显示此字段)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| grpc_domain_name | String | 参数解释: grpc连接域名(仅RocketMQ 5.x版本会显示此字段)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| public_grpc_address | String | 参数解释: 公网grpc连接地址(仅RocketMQ 5.x版本会显示此字段)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| public_grpc_domain_name | String | 参数解释: 公网grpc连接域名(仅RocketMQ 5.x版本会显示此字段)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| enterprise_project_id | String | 参数解释: 企业项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| tags | Array of TagEntity objects | 参数解释: 标签列表。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| total_storage_space | Integer | 参数解释: 总存储空间。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| resource_spec_code | String | 参数解释: 资源规格。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| produce_portion | Integer | 参数解释: 生产TPS占比。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| consume_portion | Integer | 参数解释: 消费TPS占比。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| dr_enable | Boolean | 参数解释: 是否为容灾实例。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| quota_address | String | 参数解释: 流控地址。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| max_msg_process_tps | Integer | 参数解释: 最大消息TPS。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| config_ssl_need_restart_process | Boolean | 参数解释: 配置SSL是否需要重启。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| tls_mode | String | 参数解释: 实例使用的安全协议。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| enable_elastic_tps | Boolean | 参数解释: 弹性TPS开关状态。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
请求示例
查询所有实例的列表。
GET https://{endpoint}/v2/{project_id}/instances?engine=reliability 响应示例
状态码:200
查询所有实例列表成功。
{
"instances" : [ {
"name" : "reliability-ztest",
"engine" : "reliability",
"status" : "RUNNING",
"description" : "",
"type" : "cluster",
"specification" : "rocketmq.4u8g.cluster * 1 broker",
"engine_version" : "4.8.0",
"instance_id" : "68fdc9a8-805e-439d-8dd9-25adc1c58bf6",
"resource_spec_code" : "",
"charging_mode" : 1,
"vpc_id" : "3db8490c-4d6d-4d8f-8d3f-047b0de4c5cf",
"vpc_name" : "vpc-1101840",
"created_at" : "1636699753874",
"product_id" : "c6.4u8g.cluster",
"security_group_id" : "23c5977f-ff33-4b95-a73e-08d8a0bc4e6c",
"security_group_name" : "Sys-default",
"subnet_id" : "0a0f1fcb-f019-458d-b9e5-301867394d50",
"subnet_cidr" : "192.168.0.0/24",
"available_zones" : [ "9f1c5806706d4c1fb0eb72f0a9b18c77" ],
"available_zone_names" : [ "AZ3" ],
"user_id" : "0b01fbb53600d4671fa8c00673c71260",
"user_name" : "",
"maintain_begin" : "02:00:00",
"maintain_end" : "06:00:00",
"enable_log_collection" : false,
"storage_space" : 558,
"total_storage_space" : 600,
"used_storage_space" : 28,
"enable_publicip" : false,
"ssl_enable" : false,
"arch_type" : "X86",
"cross_vpc_info" : "{\"192.168.1.21\":{\"advertised_ip\":\"192.168.1.21\",\"broker_port\":\"-\",\"port_id\":\"fa020857-d899-497c-a5f8-8dd90ed67ff7\",\"namesrv_port\":\"8301\"},\"192.168.1.246\":{\"advertised_ip\":\"192.168.1.246\",\"broker_port\":\"10100\",\"port_id\":\"c0f0586f-a4ee-41b5-a7f1-b4e554bbf12d\",\"namesrv_port\":\"-\"},\"192.168.1.77\":{\"advertised_ip\":\"192.168.1.77\",\"broker_port\":\"10101\",\"port_id\":\"8eb1d144-4315-402f-8498-37c9a10b630c\",\"namesrv_port\":\"-\"},\"192.168.1.159\":{\"advertised_ip\":\"192.168.1.159\",\"broker_port\":\"-\",\"port_id\":\"d35b22af-a202-4329-bda4-26e1bdf2aa8e\",\"namesrv_port\":\"8300\"},\"192.168.1.14\":{\"advertised_ip\":\"192.168.1.14\",\"broker_port\":\"10102\",\"port_id\":\"5fcb50fd-3af5-4123-a455-a67f1b926026\",\"namesrv_port\":\"-\"}}",
"storage_resource_id" : "164bdaef-2e67-4fd5-be8b-a18f91d455a2",
"storage_spec_code" : "dms.physical.storage.ultra.v2",
"service_type" : "advanced",
"storage_type" : "hec",
"enterprise_project_id" : "0",
"extend_times" : 0,
"ipv6_enable" : false,
"support_features" : "features.log.collection",
"disk_encrypted" : true,
"disk_encrypted_key" : "********-b953-4875-a743-************",
"enable_acl" : true,
"ces_version" : "linux,v1,v2",
"node_num" : 5,
"new_spec_billing_enable" : true,
"broker_num" : 1,
"dr_enable" : false,
"namesrv_address" : "***",
"config_ssl_need_restart_process" : false,
"broker_address" : "***",
"public_namesrv_address" : "***",
"public_broker_address" : "***",
"grpc_address" : "***",
"public_grpc_address" : "***"
} ],
"instance_num" : 1
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询所有实例列表成功。 |
错误码
请参见错误码。