# 查询数据库实例列表（v3） #### 功能介绍 根据指定条件查询实例列表。 - 调用接口前，您需要了解API [认证鉴权](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_011.html)。 - 调用接口前，您需要提前获取到[地区和终端节点](https://developer.huaweicloud.com/endpoint)。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=GaussDBforopenGauss&api=ListInstances)中调试该接口。 #### URI GET /v3/{project_id}/instances 表1参数说明 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---| | project_id | String | 是 | **参数解释：** 租户在某一Region下的项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_196.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**： 不涉及。 | | id | String | 否 | **参数解释：** 实例ID。实例的唯一标识，可根据实例ID查询实例列表。 "\*"为系统保留字符，如果id是以"\*"起始，表示按照\*后面的值模糊匹配，否则，按照id精确匹配查询。不能只传入"\*"。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**： 不涉及。 | | name | String | 否 | **参数解释：** 实例名称。可根据实例名称查询实例列表。 "\*"为系统保留字符，如果name是以"\*"起始，表示按照\*后面的值模糊匹配，否则，按照name精确匹配查询。不能只传入"\*"。 **约束限制：** 不涉及。 **取值范围：** 实例名称长度在4\~64个字符之间，以字母开头，可以包含字母、数字、中划线或下划线，不能包含其他特殊字符。 **默认取值**： 不涉及。 | | type | String | 否 | **参数解释：** 实例类型。可根据实例类型查询实例列表。 **约束限制：** 不涉及。 **取值范围：** - Enterprise（区分大小写），对应分布式实例（独立部署）。 - Centralization_standard（区分大小写），对应集中式版实例。 **默认取值**： 不涉及。 | | datastore_type | String | 否 | **参数解释：** 数据库类型，不区分大小写。可根据数据库类型查询实例列表。 **约束限制：** 不涉及。 **取值范围：** GaussDB。 **默认取值**： 不涉及。 | | vpc_id | String | 否 | **参数解释：** 虚拟私有云ID，可按照实例所在的私有云查询实例列表，获取方法如下。 - 方法1：登录虚拟私有云服务的控制台界面，在虚拟私有云的详情页面查找VPC ID。 - 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考[查询VPC列表](https://support.huaweicloud.com/api-vpc/vpc_api01_0003.html)。 **约束限制：** 不涉及。 **取值范围：** UUID形式。 **默认取值**： 不涉及。 | | subnet_id | String | 否 | **参数解释：** 子网的网络ID信息。可按照实例所在的子网查询实例列表。 - 方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找网络ID。 - 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考[查询子网列表](https://support.huaweicloud.com/api-vpc/vpc_subnet01_0003.html)。 **约束限制：** 不涉及。 **取值范围：** UUID形式。 **默认取值**： 不涉及。 | | offset | Integer | 否 | **参数解释：** 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 **约束限制：** 不涉及。 **取值范围：** \[0, 2\^31-1\] **默认取值**： 默认为0（偏移0条数据，表示从第一条数据开始查询）。 | | limit | Integer | 否 | **参数解释：** 查询记录数。 **约束限制：** 不涉及。 **取值范围：** \[1, 100\] **默认取值**： 默认为100。 | | tags | String | 否 | **参数解释：** 根据实例标签键值对进行查询。 - {key}表示标签键。 - {value}表示标签值。 **约束限制：** 如果同时使用多个标签键值对进行查询，中间使用逗号分隔开，最多包含20组。 **取值范围：** - {key}最大长度127个unicode字符。key不能为空或者空字符串，不能为空格，使用之前先trim前后半角空格。不能包含+/?#\&=,%特殊字符。 - {value}可以为空。最大长度255个unicode字符，使用之前先trim 前后半角空格。不能包含+/?#\&=,%特殊字符。如果value为空，则表示any_value（查询任意value）。 **默认取值**： 不涉及。 | #### 请求参数 无。 #### 响应参数 表2响应参数 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | instances | Array of objects | **参数解释：** 实例信息。 详情请参见[表3]。 | | total_count | Integer | **参数解释：** 总记录数。 **取值范围：** \[0, 2\^31-1\]，取决于实际查询大小。 | 表3instances字段数据结构说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | id | String | **参数解释** **：** 实例ID。 **取值范围** **：** 只能由英文字母、数字组成，且长度为32个字符。 | | name | String | **参数解释** **：** 创建的实例名称。 **取值范围** **：** 实例名称长度在4\~64个字符之间，以字母开头，可以包含字母、数字、中划线或下划线，不能包含其他特殊字符。 | | status | String | **参数解释** **：** 实例状态。 **取值范围** **：** 值为"BUILD"，表示实例正在创建。 值为"BUILD_FAILED"，表示实例创建失败 值为"ACTIVE"，表示实例正常。 值为"FAILED"，表示实例异常。 值为"FROZEN"，表示实例冻结。 值为"MODIFYING"，表示实例正在扩容磁盘或者变更规格。 值为"EXPANDING"，表示实例正在添加只读节点或扩容CN或DN。 值为"REBOOTING"，表示实例正在重启。 值为"REDUCING", 表示实例正在删除只读节点。 值为"UPGRADING"，表示实例正在升级。 值为"RESTORING"，表示实例正在恢复。 值为"SWITCHOVER"，表示实例正在主备切换。 值为"MIGRATING"，表示实例正在迁移。 值为"BACKING UP"，表示实例正在进行备份。 值为"UPGRADE TO BE OBSERVED"，表示实例正在进行升级待观察。 值为"MODIFYING DATABASE PORT"，表示实例正在修改数据库端口。 值为"STORAGE FULL"，表示实例磁盘空间满。 值为"SHUTDOWN"，表示实例已停止。 值为"REPAIRING"，表示实例正在修复。 | | private_ips | List\ | **参数解释** **：** 实例内网IP地址列表。分布式CN所在的弹性云服务器创建成功后该值存在，集中式版DN所在的弹性云服务器创建成功后该值存在，其他情况下为空字符串。 | | public_ips | List\ | **参数解释** **：** 实例外网IP地址列表。绑定弹性公网IP后，该值不为空。 | | port | Integer | **参数解释** **：** 数据库端口号。 **取值范围** **：** GaussDB数据库端口设置范围为1024\~39998（其中2378,2379,2380,4999,5000,5999,6000,6001,8097,8098,20049,20050,21731,21732被系统占用不可设置）。 | | type | String | **参数解释** **：** 实例类型。 **取值范围** **：** 取值为 "Enterprise"，对应于分布式实例（企业版）。取值为"centralization_standard"，对应于集中式版实例。区分大小写。 | | ha | Object | **参数解释** **：** 实例的高可用参数。包括事务一致性类型、备机同步参数等。 详情请参见[表4]。 | | replica_num | Integer | **参数解释** **：** 实例副本数。 **取值范围** **：** 不涉及。 | | region | String | **参数解释** **：** 实例所在区域。 **取值范围** **：** 不涉及。 | | datastore | Object | **参数解释** **：** 数据库信息。 详情请参见[表5]。 | | created | String | **参数解释** **：** 创建时间，格式为"yyyy-mm-dd hh:mm:ss timezone"。 其中timezone是指时区。例如：2024-07-16 09:31:43 UTC。 创建时该值为实例下发创建的时间，创建完成后，该值为创建完成时间。 **取值范围** **：** 不涉及。 | | updated | String | **参数解释** **：** 更新时间，格式与"created"字段对应格式完全相同。例如：2024-07-16 09:31:43 UTC。 创建时返回值为空，数据库实例创建成功后该值不为空。 **取值范围** **：** 不涉及。 | | db_user_name | String | **参数解释** **：** 默认用户名。 **取值范围** **：** 默认是root。 | | vpc_id | String | **参数解释** **：** 实例所在的虚拟私有云ID。 **取值范围** **：** 符合UUID形式。 | | subnet_id | String | **参数解释** **：** 实例所在的子网ID。 **取值范围** **：** 符合UUID形式。 | | security_group_id | String | **参数解释** **：** 安全组ID。 **取值范围** **：** 符合UUID形式。 | | flavor_ref | String | **参数解释** **：** 规格码。参考[数据库实例规格](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_199.html)中GaussDB的"规格编码"列内容获取。 **取值范围** **：** 不涉及。 | | flavor_info | Object | **参数解释** **：** 规格信息。 详情请参见[表6] | | volume | Object | **参数解释** **：** Volume信息。 详情请参见[表7]。 | | switch_strategy | String | **参数解释** **：** 数据库切换策略。 **取值范围** **：** 取值为"Reliability"或"Availability"，分别对应于可靠性优先和可用性优先。 若创建时没有选择切换策略，则不予显示。 | | backup_strategy | Object | **参数解释** **：** 备份策略。 详情请参见[表8]。 | | maintenance_window | String | **参数解释** **：** 可维护时间窗，为UTC时间。格式为"hh:mm-HH:MM"，例如：18:00-22:00。 **取值范围** **：** 不涉及。 | | nodes | Array of objects | **参数解释** **：** 实例节点信息。 详情请参见[表9]。 | | disk_encryption_id | String | **参数解释** **：** 磁盘加密密钥ID。只有创建磁盘加密实例才会显示该参数。 **取值范围** **：** 不涉及。 | | enterprise_project_id | String | **参数解释** **：** 企业项目标签ID。 **取值范围** **：** 非企业项目账号的实例，企业项目默认0。 | | instance_mode | String | **参数解释** **：** 实例产品类型。 **取值范围** **：** enterprise代表数据库版本为企业版，standard为标准版，basic为基础版 。 | | time_zone | String | **参数解释** **：** 时区。 **取值范围** **：** 不涉及。 | | charge_info | Object | **参数解释** **：** 计费类型信息，支持按需和包周期。 详情请参见[表10]。 | | tags | Array of objects | **参数解释** **：** 标签列表，没有标签不返回该参数。 详情请参见[表11]。 | 表4ha字段数据结构说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | consistency | String | **参数解释** **：** 事务一致性类型。 **取值范围** **：** 取值为"strong"、"eventual"，分别表示强一致性、最终一致性。 | | replication_mode | String | **参数解释** **：** 备机同步参数。 **取值范围** **：** 固定取值为"sync"。表示数据同步方式为同步模式。 | 表5datastore字段数据结构说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | type | String | **参数解释** **：** 数据库引擎。 **取值范围** **：** GaussDB | | version | String | **参数解释** **：** 数据库版本。 **取值范围** **：** 取决于实例引擎版本，例如8.200。 | 表6flavor_info字段数据结构说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | vcpu | Integer | **参数解释** **：** cpu核数。 **取值范围** **：** 不涉及。 | | mem | Integer | **参数解释** **：** 内存大小，单位GB。 **取值范围** **：** 不涉及。 | 表7volume字段数据结构说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | type | String | **参数解释** **：** 磁盘类型。 **取值范围** **：** 仅支持ULTRAHIGH和ESSD，区分大小写，分别表示SSD和极速云盘。 | | size | Integer | **参数解释** **：** 磁盘大小。 **取值范围** **：** 不涉及。 | 表8backup_strategy字段数据结构说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | start_time | String | **参数解释** **：** 备份时间段。自动备份将在该时间段内触发。 当前时间指UTC时间。格式为"hh:mm-HH:MM"，例如"19:00-20:00"。 **取值范围** **：** 不涉及。 | | keep_days | Integer | **参数解释** **：** 已生成的备份文件可以保存的天数。 **取值范围** **：** \[1, 732\] | 表9nodes字段数据结构说明 | **名称** | **参数类型** | **说明** | |:---|:---|:---| | id | String | **参数解释** **：** 节点ID。 **取值范围** **：** 只能由英文字母、数字组成，且长度为36个字符。 | | name | String | **参数解释** **：** 节点名称。 **取值范围** **：** 以字母开头，可以包含字母、数字、中划线或下划线，不能包含其他特殊字符。 | | role | String | **参数解释** **：** 节点类型，代表节点在实例中所处的角色。 **取值范围** **：** 取值为"master"、"slave"，分别对应于主节点、备节点。 | | status | String | **参数解释** **：** 节点状态。 **取值范围** **：** 值为"BUILD_FAILED"，表示节点创建失败。 | | availability_zone | String | **参数解释** **：** 可用区。 **取值范围** **：** 不涉及。 | | private_ip | String | **参数解释** **：** 节点内网IP。分布式实例类型下该参数仅针对CN节点有效，集中式版实例类型下该参数对所有节点有效，且在弹性云服务器创建成功后参数值存在。 **取值范围** **：** 不涉及。 | | public_ip | String | **参数解释** **：** 绑定的公网IP。分布式实例类型下该参数仅针对CN节点有效，集中式版实例类型下该参数对所有节点有效，且在弹性云服务器创建成功并绑定弹性公网IP后参数值存在。 **取值范围** **：** 不涉及。 | 表10chargeInfo字段数据结构说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | charge_mode | 是 | String | **参数解释** **：** 计费模式。 **取值范围** **：** postPaid：后付费，即按需付费。 prePaid：预付费，即包年/包月。 | 表11tags字段数据结构说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | key | String | **参数解释** **：** 标签键。 **取值范围** **：** 不涉及。 | | value | String | **参数解释** **：** 标签值。 **取值范围** **：** 不涉及。 | #### 请求示例 - 查询所有实例列表 ``` https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/97b026aa9cc4417888c14c84a1ad9860/instances ``` - 根据指定条件查询实例列表 ``` https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/97b026aa9cc4417888c14c84a1ad9860/instances?id=ed7cc6166ec24360a5ed5c5c9c2ed726in14&name=hy&type=Enterprise&datastore_type=GaussDB&vpc_id=19e5d45d-70fd-4a91-87e9-b27e71c9891f&subnet_id=bd51fb45-2dcb-4296-8783-8623bfe89bb7&offset=0&limit=10 ``` #### 响应示例 - **实例列表：** ``` { "instances": [ { "id": "b331ed66cc3249f78bc20737308c01f4in14", "status": "ACTIVE", "name": "gauss-9e88", "port": 8000, "type": "Enterprise", "ha": { "consistency": "strong", "replication_mode": "sync" }, "region": "eu-de", "region": "aaa", "datastore": { "type": "GaussDB", "version": "1.3" }, "created": "2021-01-15 01:46:40 UTC", "updated": "2021-01-15 02:05:03 UTC", "volume": { "type": "ULTRAHIGH", "size": 120 }, "nodes": [ { "id": "02ebf757aaf94074855f49cc6e0e4712no14", "name": "gauss-9e88_gaussdbv5cn_2", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz", "private_ip": "192.168.16.253" }, { "id": "0a87b8ecbfeb46aba1409cfc0f0d5c34no14", "name": "gauss-9e88_gaussdbv5cn_0", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz", "private_ip": "192.168.28.81" }, { "id": "2d9fec1ab3834936b074d63acf48b1f2no14", "name": "gauss-9e88_gaussdbv5dn3_2", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "48bb08a2d635435891ac0caa1c0bf2e3no14", "name": "gauss-9e88_gaussdbv5dn1_0", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "5df830f652204827ada32f8bc28b107eno14", "name": "gauss-9e88_gaussdbv5dn1_1", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "8a97a246cee841b38c5b47290d4c9c38no14", "name": "gauss-9e88_gaussdbv5cn_1", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz", "private_ip": "192.168.27.52" }, { "id": "8c1a3f8eecca4d9e9974a868bb6dd942no14", "name": "gauss-9e88_gaussdbv5dn2_0", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "9bd0c80b8a684cc9bd7d99dd5adffb07no14", "name": "gauss-9e88_gaussdbv5dn3_1", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "9e2a3cd541e249d4af5aa57c5d3a7f39no14", "name": "gauss-9e88_gaussdbv5dn1_2", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "b046d28989ec4ae5a1a9ab20fe65f248no14", "name": "gauss-9e88_gaussdbv5dn2_2", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "b614cc12fd3742dbb230245f88a7bf00no14", "name": "gauss-9e88_gaussdbv5dn3_0", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "caba8e88c3c84ae58202f1f589490611no14", "name": "gauss-9e88_gaussdbv5dn2_1", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" } ], "private_ips": [ "192.168.16.253 / 192.168.28.81 / 192.168.27.52" ], "replica_num": 3, "db_user_name": "root", "vpc_id": "5f84a5c4-2f93-41de-8359-d7acedb585cc", "subnet_id": "300036af-a92f-4e9e-8e9f-7d20e7878b05", "security_group_id": "2dcfd40a-8f32-46b8-8a47-6cfab5eba163", "flavor_ref": "gaussdb.opengauss.ee.dn.m6.large.8.in", "flavor_info": { "vcpu": 2, "mem": 16 }, "switch_strategy": "Reliability", "charge_info": { "charge_mode": "prePaid" }, "backup_strategy": { "start_time": "19:00-20:00", "keep_days": 7 }, "maintenance_window": "18:00-22:00", "disk_encryption_id": "24ae42b5-4009-4ea2-b66a-0b211e424dab", "enterprise_project_id": "6e76681b-a2f5-4c5f-97c5-ba4fd3c0dfb2", "time_zone": "UTC+08:00", "instance_mode":"enterprise" }, { "id": "226b4afcfcc84c86bf1b9cb345d3b00fin14", "status": "ACTIVE", "name": "UTS-gauss-ad53-2C3D", "port": 8000, "type": "Enterprise", "ha": { "consistency": "strong", "replication_mode": "sync" }, "region": "cn-xianhz-1", "datastore": { "type": "GaussDB", "version": "1.3" }, "created": "2021-01-08 09:18:27 UTC", "updated": "2021-01-14 13:25:03 UTC", "volume": { "type": "ULTRAHIGH", "size": 120 }, "nodes": [ { "id": "07538a1def584cee99e2a5685eeab36ano14", "name": "UTS-gauss-ad53-2C3D_gaussdbv5dn3_1", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "21f41baba1e2454f82331b7cb5aeabe5no14", "name": "UTS-gauss-ad53-2C3D_gaussdbv5dn1_2", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "2909771a3b3e4e3998f9388e77d22391no14", "name": "UTS-gauss-ad53-2C3D_gaussdbv5dn1_0", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "2bd9a90a5da242a6b0743a7f597f6106no14", "name": "UTS-gauss-ad53-2C3D_gaussdbv5dn2_2", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "77092f1dadb74d3ea13d28269cdd3590no14", "name": "UTS-gauss-ad53-2C3D_gaussdbv5dn3_2", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "a46bfaa6d5a24355a60fce7432b964cano14", "name": "UTS-gauss-ad53-2C3D_gaussdbv5dn3_0", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "aa5277736f3844e2a7adeb9de529e2b1no14", "name": "UTS-gauss-ad53-2C3D_gaussdbv5dn2_1", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "b1d798e4ea7344dfa95032984bc6cfd7no14", "name": "UTS-gauss-ad53-2C3D_gaussdbv5cn_1", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz", "private_ip": "192.168.29.231" }, { "id": "b9a46540186f4c0781eabaa2a79594cbno14", "name": "UTS-gauss-ad53-2C3D_gaussdbv5dn1_1", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "d283813030364060ab64371d50294977no14", "name": "UTS-gauss-ad53-2C3D_gaussdbv5dn2_0", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "eb7bce29b2284cd290405eaddc1b1a1eno14", "name": "UTS-gauss-ad53-2C3D_gaussdbv5cn_0", "role": "master", "status": "FAILED", "availability_zone": "az2xahz", "private_ip": "192.168.30.44", "public_ip": "10.154.217.248" } ], "private_ips": [ "192.168.29.231 / 192.168.30.44" ], "public_ips": [ "10.154.217.248" ], "replica_num": 3, "db_user_name": "root", "vpc_id": "5f84a5c4-2f93-41de-8359-d7acedb585cc", "subnet_id": "300036af-a92f-4e9e-8e9f-7d20e7878b05", "security_group_id": "2dcfd40a-8f32-46b8-8a47-6cfab5eba163", "flavor_ref": "gaussdb.opengauss.ee.dn.m6.large.8.in", "flavor_info": { "vcpu": 2, "mem": 16 }, "switch_strategy": "Reliability", "charge_info": { "charge_mode": "prePaid" }, "backup_strategy": { "start_time": "18:00-19:00", "keep_days": 7 }, "maintenance_window": "18:00-22:00", "enterprise_project_id": "0", "time_zone": "UTC+08:00", "instance_mode":"enterprise" }, { "id": "706c65c3dd7d497ab16f5b3a113690abin14", "status": "ACTIVE", "name": "UTS-gauss-7362", "port": 8000, "type": "Enterprise", "ha": { "consistency": "strong", "replication_mode": "sync" }, "region": "cn-xianhz-1", "datastore": { "type": "GaussDB", "version": "1.2" }, "created": "2020-12-23 03:21:41 UTC", "updated": "2021-01-15 02:32:13 UTC", "volume": { "type": "ULTRAHIGH", "size": 80 }, "nodes": [ { "id": "25b7f16ee4084b7884d52f1bdfab4e68no14", "name": "UTS-gauss-7362_gaussdbv5dn1_2", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "ad6f02f31744422fa8ce487e81c9e7afno14", "name": "UTS-gauss-7362_gaussdbv5cn_0", "role": "master", "status": "ACTIVE", "availability_zone": "az2xahz", "private_ip": "192.168.26.70" }, { "id": "b30c56582bf44a548e3bb5b5af6c4773no14", "name": "UTS-gauss-7362_gaussdbv5dn1_1", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" }, { "id": "f79ea0600cba42b2888bd9bd67e52a79no14", "name": "UTS-gauss-7362_gaussdbv5dn1_0", "role": "slave", "status": "ACTIVE", "availability_zone": "az2xahz" } ], "private_ips": [ "192.168.26.70" ], "db_user_name": "root", "vpc_id": "5f84a5c4-2f93-41de-8359-d7acedb585cc", "subnet_id": "300036af-a92f-4e9e-8e9f-7d20e7878b05", "security_group_id": "2dcfd40a-8f32-46b8-8a47-6cfab5eba163", "flavor_ref": "gaussdb.opengauss.ee.dn.m6.large.8.in", "flavor_info": { "vcpu": 2, "mem": 16 }, "switch_strategy": "Reliability", "charge_info": { "charge_mode": "postPaid" }, "backup_strategy": { "start_time": "16:00-17:00", "keep_days": 7 }, "maintenance_window": "18:00-22:00", "enterprise_project_id": "0", "time_zone": "UTC+08:00", "instance_mode":"enterprise" }, { "id": "4ad42d079a3948d88c28d6236211b21ein14", "status": "ACTIVE", "name": "UTS-gauss-4336", "port": 8000, "type": "Enterprise", "ha": { "consistency": "strong", "replication_mode": "sync" }, "region": "cn-xianhz-1", "datastore": { "type": "GaussDB", "version": "1.2" }, "created": "2020-12-03 14:28:53 UTC", "updated": "2021-01-14 13:20:10 UTC", "volume": { "type": "ULTRAHIGH", "size": 40 }, "nodes": [ { "id": "254dbda6f03643519ad64b39481bd11cno14", "name": "UTS-gauss-4336_gaussdbv5dn1_2", "role": "master", "status": "ACTIVE", "availability_zone": "az1xahz" }, { "id": "6ad76d4db26443c2a93b280739a31558no14", "name": "UTS-gauss-4336_gaussdbv5dn1_1", "role": "slave", "status": "ACTIVE", "availability_zone": "az1xahz" }, { "id": "9fdebf821bdf444a8689b19c0ff588ceno14", "name": "UTS-gauss-4336_gaussdbv5cn_0", "role": "master", "status": "FAILED", "availability_zone": "az1xahz", "private_ip": "192.168.30.93" }, { "id": "dd64bdbc02a542d88823b1582f772d25no14", "name": "UTS-gauss-4336_gaussdbv5cn_1", "role": "master", "status": "ACTIVE", "availability_zone": "az1xahz", "private_ip": "192.168.29.232" }, { "id": "de3c41461045466faf6c2b96eb709540no14", "name": "UTS-gauss-4336_gaussdbv5dn1_0", "role": "slave", "status": "ACTIVE", "availability_zone": "az1xahz" } ], "private_ips": [ "192.168.30.93 / 192.168.29.232" ], "db_user_name": "root", "vpc_id": "5f84a5c4-2f93-41de-8359-d7acedb585cc", "subnet_id": "300036af-a92f-4e9e-8e9f-7d20e7878b05", "security_group_id": "2dcfd40a-8f32-46b8-8a47-6cfab5eba163", "flavor_ref": "gaussdb.opengauss.ee.dn.m6.large.8.in", "flavor_info": { "vcpu": 2, "mem": 16 }, "switch_strategy": "Reliability", "charge_info": { "charge_mode": "postPaid" }, "backup_strategy": { "start_time": "18:00-19:00", "keep_days": 7 }, "maintenance_window": "18:00-22:00", "enterprise_project_id": "0", "time_zone": "UTC+08:00", "instance_mode":"enterprise" } ], "total_count": 4 } ``` - **实例详情：** ``` { "instances": [ { "id": "706c65c3dd7d497ab16f5b3a113690abin14", "status": "ACTIVE", "name": "UTS-gauss-7362", "port": 8000, "type": "Enterprise", "ha": { "consistency": "strong", "replication_mode": "sync" }, "region": "aaa", "datastore": { "type": "GaussDB", "version": "1.4" }, "created": "2020-12-23 03:21:41 UTC", "updated": "2021-01-15 02:32:13 UTC", "volume": { "type": "ULTRAHIGH", "size": 80 }, "nodes": [ { "id": "25b7f16ee4084b7884d52f1bdfab4e68no14", "name": "UTS-gauss-7362_gaussdbv5dn1_2", "role": "master", "status": "ACTIVE", "region": "bbb", }, { "id": "ad6f02f31744422fa8ce487e81c9e7afno14", "name": "UTS-gauss-7362_gaussdbv5cn_0", "role": "master", "status": "ACTIVE", "region": "bbb", "private_ip": "192.168.26.70" }, { "id": "b30c56582bf44a548e3bb5b5af6c4773no14", "name": "UTS-gauss-7362_gaussdbv5dn1_1", "role": "slave", "status": "ACTIVE", "region": "bbb", }, { "id": "f79ea0600cba42b2888bd9bd67e52a79no14", "name": "UTS-gauss-7362_gaussdbv5dn1_0", "role": "slave", "status": "ACTIVE", "region": "bbb", } ], "private_ips": [ "192.168.26.70" ], "db_user_name": "root", "vpc_id": "5f84a5c4-2f93-41de-8359-d7acedb585cc", "subnet_id": "300036af-a92f-4e9e-8e9f-7d20e7878b05", "security_group_id": "2dcfd40a-8f32-46b8-8a47-6cfab5eba163", "flavor_ref": "gaussdb.opengauss.ee.dn.m6.2xlarge.8.in", "flavor_info": { "vcpu": 8, "mem": 64 }, "switch_strategy": "Reliability", "charge_info": { "charge_mode": "postPaid" }, "backup_strategy": { "start_time": "16:00-17:00", "keep_days": 7 }, "maintenance_window": "18:00-22:00", "enterprise_project_id": "0", "time_zone": "UTC+08:00", "instance_mode":"enterprise" } ], "total_count": 1 } ``` #### 状态码 - 正常 200 - 异常 请参见[状态码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_194.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_195.html)。