接口约束 该接口仅支持MySQL、PostgreSQL引擎。 Serverless型实例不支持该接口。 RDS for PostgreSQ L实例 中存在异常节点，无法升级小版本。 对于RDS for PostgreSQL 11版本，如果内核小版本小于11.2，则不支持小版本升级。 RDS for PostgreSQL只支持立即升级，不支持可维护时间段内升级小版本。 RDS for PostgreSQL升级内核小版本后，有可能导致主备节点倒换。

响应示例 非包租期用户响应消息样例： { "job_id": "2b414788a6004883a02390e2eb0ea227" } 包租期用户响应消息样例： { "payInfo": { "payModel": null, "orderId": " CS 2105061116HNTVI", "period": null, "periodType": 5, "isAutoRenew": 0, "isAutoPay": 1 }, "job_id": null }

请求参数 表2 请求参数 名称 是否必选 参数类型 说明 expand_cluster 是 Object 请参见表3 表3 expand_cluster字段数据结构说明 名称 是否必选 参数类型 说明 coordinators 是 Array 请参见表4 isAutoPay 否 int 包周期用户需要填写该字段。 0：表示不自动支付扩容订单费用 1：表示自动支付扩容订单费用 不填写则保持默认。默认值：0 表4 azCode字段数据结构说明 名称 是否必选 参数类型 说明 az_code 是 String 新增CN横向扩容每个节点的可用区

请求示例 扩单CN。 https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/opengauss/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action { "expand_cluster": { "coordinators": [ { "az_code":"az1xahz" } ]， "isAutoPay":0 } } 扩多CN。 https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/opengauss/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action { "expand_cluster": { "coordinators": [ { "az_code":"az1xahz" }, { "az_code":"az2xahz" }, { "az_code":"az3xahz" } ] } }

响应示例 实例列表： { "instances" : [ { "id" : "b331ed66cc3249f78bc20737308c01f4in14", "status" : "ACTIVE", "name" : "gauss-9e88", "port" : 8000, "type" : "enterprise", "ha" : { "consistency" : "strong", "replication_mode" : "sync" }, "region" : "cn-xianhz-1", "datastore" : { "type" : " GaussDB ", "version" : "2.7", "complete_version" : "2.7.2", "target_version" : "3.208.0", "complete_kernel_version" : "V500R002C10SPC610" }, "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", "component_names" : "cn_5001:" }, { "id" : "0a87b8ecbfeb46aba1409cfc0f0d5c34no14", "name" : "gauss-9e88_gaussdbv5cn_0", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "cn_5002:" }, { "id" : "2d9fec1ab3834936b074d63acf48b1f2no14", "name" : "gauss-9e88_gaussdbv5dn3_2", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6003:60073" }, { "id" : "48bb08a2d635435891ac0caa1c0bf2e3no14", "name" : "gauss-9e88_gaussdbv5dn1_0", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6001:60011" }, { "id" : "5df830f652204827ada32f8bc28b107eno14", "name" : "gauss-9e88_gaussdbv5dn1_1", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6002:60011" }, { "id" : "8a97a246cee841b38c5b47290d4c9c38no14", "name" : "gauss-9e88_gaussdbv5cn_1", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "cn_5003:" }, { "id" : "8c1a3f8eecca4d9e9974a868bb6dd942no14", "name" : "gauss-9e88_gaussdbv5dn2_0", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6004:60042" }, { "id" : "9bd0c80b8a684cc9bd7d99dd5adffb07no14", "name" : "gauss-9e88_gaussdbv5dn3_1", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6005:60073" }, { "id" : "9e2a3cd541e249d4af5aa57c5d3a7f39no14", "name" : "gauss-9e88_gaussdbv5dn1_2", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6006:60011" }, { "id" : "b046d28989ec4ae5a1a9ab20fe65f248no14", "name" : "gauss-9e88_gaussdbv5dn2_2", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6007:60042" }, { "id" : "b614cc12fd3742dbb230245f88a7bf00no14", "name" : "gauss-9e88_gaussdbv5dn3_0", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6008:60073" }, { "id" : "caba8e88c3c84ae58202f1f589490611no14", "name" : "gauss-9e88_gaussdbv5dn2_1", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6009:60042" } ], "private_ips" : [ "192.168.28.81 / 192.168.27.52 / 192.168.16.253" ], "public_ips" : [ ], "replice_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", "instance_mode" : "enterprise", "time_zone" : "UTC+08:00", "order_id" : "CS2101150917EUW8N", "disk_usage" : "0.9890", "mysql_compatibility" : { "port" : 3306 } }, { "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" : "2.7", "complete_version" : "2.7.2", "complete_kernel_version" : "V500R002C10SPC610", "target_version" : "3.208.0", "hotfix_version_infos" : [ { "version" : "2.7.2.1", "upgrade_finished_time" : "2020-12-23 03:21:41 UTC" }, { "version" : "2.7.2.2", "upgrade_finished_time" : "2020-12-23 03:22:41 UTC" } ] }, "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", "component_names" : "dn_6009:60072" }, { "id" : "21f41baba1e2454f82331b7cb5aeabe5no14", "name" : "UTS-gauss-ad53-2C3D_gaussdbv5dn1_2", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6008:60042" }, { "id" : "2909771a3b3e4e3998f9388e77d22391no14", "name" : "UTS-gauss-ad53-2C3D_gaussdbv5dn1_0", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6007:60011" }, { "id" : "2bd9a90a5da242a6b0743a7f597f6106no14", "name" : "UTS-gauss-ad53-2C3D_gaussdbv5dn2_2", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6006:60042" }, { "id" : "77092f1dadb74d3ea13d28269cdd3590no14", "name" : "UTS-gauss-ad53-2C3D_gaussdbv5dn3_2", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6005:60072" }, { "id" : "a46bfaa6d5a24355a60fce7432b964cano14", "name" : "UTS-gauss-ad53-2C3D_gaussdbv5dn3_0", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6004:60072" }, { "id" : "aa5277736f3844e2a7adeb9de529e2b1no14", "name" : "UTS-gauss-ad53-2C3D_gaussdbv5dn2_1", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6003:60042" }, { "id" : "b1d798e4ea7344dfa95032984bc6cfd7no14", "name" : "UTS-gauss-ad53-2C3D_gaussdbv5cn_1", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "cn_5002:" }, { "id" : "b9a46540186f4c0781eabaa2a79594cbno14", "name" : "UTS-gauss-ad53-2C3D_gaussdbv5dn1_1", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6002:60011" }, { "id" : "d283813030364060ab64371d50294977no14", "name" : "UTS-gauss-ad53-2C3D_gaussdbv5dn2_0", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6001:60042" }, { "id" : "eb7bce29b2284cd290405eaddc1b1a1eno14", "name" : "UTS-gauss-ad53-2C3D_gaussdbv5cn_0", "role" : "master", "status" : "FAILED", "availability_zone" : "az2xahz", "component_names" : "cn_5001:" } ], "private_ips" : [ "192.168.30.44 / 192.168.29.231" ], "public_ips" : [ "10.154.217.248" ], "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", "instance_mode" : "enterprise", "time_zone" : "UTC+08:00", "order_id" : "CS21010817315KY81", "disk_usage" : "1.0000", "mysql_compatibility" : { "port" : 3306 } }, { "id" : "706c65c3dd7d497ab16f5b3a113690abin14", "status" : "ACTIVE", "name" : "UTS-gauss-7362", "port" : 8000, "type" : "enterprise", "ha" : { "replication_mode" : "sync" }, "region" : "cn-xianhz-1", "datastore" : { "type" : "GaussDB", "version" : "2.7", "complete_version" : "2.7.2", "complete_kernel_version" : "V500R002C10SPC610", "target_version" : "3.208.0", "hotfix_version_infos" : [ { "version" : "2.7.2.1", "upgrade_finished_time" : "2020-12-23 03:21:41 UTC" }, { "version" : "2.7.2.2", "upgrade_finished_time" : "2020-12-23 03:22:41 UTC" } ] }, "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", "component_names" : "dn_6003:60011" }, { "id" : "ad6f02f31744422fa8ce487e81c9e7afno14", "name" : "UTS-gauss-7362_gaussdbv5cn_0", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "cn_5001:" }, { "id" : "b30c56582bf44a548e3bb5b5af6c4773no14", "name" : "UTS-gauss-7362_gaussdbv5dn1_1", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6002:60011" }, { "id" : "f79ea0600cba42b2888bd9bd67e52a79no14", "name" : "UTS-gauss-7362_gaussdbv5dn1_0", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6001:60011" } ], "private_ips" : [ "192.168.26.70" ], "public_ips" : [ ], "replice_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" : "postPaid" }, "backup_strategy" : { "start_time" : "16:00-17:00", "keep_days" : 7 }, "maintenance_window" : "18:00-22:00", "enterprise_project_id" : "0", "instance_mode" : "enterprise", "time_zone" : "UTC+08:00", "disk_usage" : "0.9940", "mysql_compatibility" : { "port" : 3306 } }, { "id" : "4ad42d079a3948d88c28d6236211b21ein14", "status" : "ACTIVE", "name" : "UTS-gauss-4336", "port" : 8000, "type" : "enterprise", "ha" : { "replication_mode" : "sync" }, "region" : "cn-xianhz-1", "datastore" : { "type" : "GaussDB", "version" : "2.7", "complete_version" : "2.7.2", "complete_kernel_version" : "V500R002C10SPC610", "target_version" : "3.208.0", "hotfix_version_infos" : [ { "version" : "2.7.2.1", "upgrade_finished_time" : "2020-12-23 03:21:41 UTC" }, { "version" : "2.7.2.2", "upgrade_finished_time" : "2020-12-23 03:22:41 UTC" } ] }, "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", "component_names" : "dn_6001:60011" }, { "id" : "6ad76d4db26443c2a93b280739a31558no14", "name" : "UTS-gauss-4336_gaussdbv5dn1_1", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az1xahz", "component_names" : "dn_6002:60011" }, { "id" : "9fdebf821bdf444a8689b19c0ff588ceno14", "name" : "UTS-gauss-4336_gaussdbv5cn_0", "role" : "master", "status" : "FAILED", "availability_zone" : "az1xahz", "component_names" : "cn_5001:" }, { "id" : "dd64bdbc02a542d88823b1582f772d25no14", "name" : "UTS-gauss-4336_gaussdbv5cn_1", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az1xahz", "component_names" : "cn_5002:" }, { "id" : "de3c41461045466faf6c2b96eb709540no14", "name" : "UTS-gauss-4336_gaussdbv5dn1_0", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az1xahz", "component_names" : "dn_6001:60011" } ], "private_ips" : [ "192.168.30.93 / 192.168.29.232" ], "public_ips" : [ ], "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", "instance_mode" : "basic", "time_zone" : "UTC+08:00", "disk_usage" : "1.0000", "mysql_compatibility" : { "port" : 3306 } } ], "total_count" : 4 } 实例详情 { "instances" : [ { "id" : "706c65c3dd7d497ab16f5b3a113690abin14", "status" : "ACTIVE", "name" : "UTS-gauss-7362", "port" : 8000, "type" : "enterprise", "ha" : { "replication_mode" : "sync" }, "region" : "cn-xianhz-1", "datastore" : { "type" : "GaussDB", "version" : "2.7", "complete_version" : "2.7.2", "complete_kernel_version" : "V500R002C10SPC610", "target_version" : "3.208.0", "hotfix_version_infos" : [ { "version" : "2.7.2.1", "upgrade_finished_time" : "2020-12-23 03:21:41 UTC" }, { "version" : "2.7.2.2", "upgrade_finished_time" : "2020-12-23 03:22:41 UTC" } ] }, "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", "component_names" : "dn_6003:60011" }, { "id" : "ad6f02f31744422fa8ce487e81c9e7afno14", "name" : "UTS-gauss-7362_gaussdbv5cn_0", "role" : "master", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "cn_6004:" }, { "id" : "b30c56582bf44a548e3bb5b5af6c4773no14", "name" : "UTS-gauss-7362_gaussdbv5dn1_1", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6002:60011" }, { "id" : "f79ea0600cba42b2888bd9bd67e52a79no14", "name" : "UTS-gauss-7362_gaussdbv5dn1_0", "role" : "slave", "status" : "ACTIVE", "availability_zone" : "az2xahz", "component_names" : "dn_6001:60011" } ], "private_ips" : [ "192.168.26.70" ], "public_ips" : [ ], "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", "disk_encryption_id" : "", "enterprise_project_id" : "0", "instance_mode" : "enterprise", "time_zone" : "UTC+08:00", "disk_usage" : "0.9670" } ], "total_count" : 1 }

请求示例 根据指定条件查询实例列表 GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.2/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 查询所有实例列表 GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.2/97b026aa9cc4417888c14c84a1ad9860/instances

响应参数 表3 响应参数 参数 参数类型 描述 instances Array of 表4 objects 实例信息。 total_count Integer 总记录数。 表4 ListInstancesResult 参数 参数类型 描述 id String 实例ID。 name String 创建的实例名称。 status String 实例状态。 取值： 值为“BUILD”，表示实例正在创建。 值为“ACTIVE”，表示实例正常。 值为“FAILED”，表示实例异常。 值为“FROZEN”，表示实例冻结。 值为“EXPANDING”，表示实例正在扩容CN或DN。 值为“REBOOTING”，表示实例正在重启。 值为“UPGRADING”，表示实例正在升级。 值为“RESTORING”，表示实例正在恢复。 值为“BACKING UP”，表示实例正在进行备份。 值为“REDUCING REPLICATION”，表示实例正在降副本。 值为“STORAGE FULL”，表示实例磁盘空间满。 值为“REPAIRING”，表示实例正在修复。 private_ips Array of strings 实例内网IP地址列表。分布式CN所在的弹性云服务器创建成功后该值存在，主备版DN所在的弹性云服务器创建成功后该值存在，其他情况下为空字符串。 public_ips Array of strings 实例外网IP地址列表。绑定弹性公网IP后，该值不为空。 port Integer 数据库端口号。 GaussDB数据库 端口设置范围为1024~39998（其中2378,2379,2380,4999,5000,5999,6000,6001,8097,8098,20049,20050,21731,21732被系统占用不可设置）。当不传该参数时，默认端口如下：8000。 type String 实例类型，取值为 "Enterprise"，对应于分布式实例（企业版）。取值为"Ha"，对应于主备版实例。 ha 表5 object 获取分布式/主备版实例时返回。 replica_num Integer 实例副本数。 region String 实例所在区域。 datastore 表6 object 数据库信息。 created String 创建时间，格式为“yyyy-mm-dd hh:mm:ss timezone”。 其中timezone是指时区。 说明：创建时该值为实例下发创建的时间，创建完成后，该值为创建完成时间。 updated String 更新时间，格式与“created”字段对应格式完全相同。 说明：创建时返回值为空，数据库实例创建成功后该值不为空。 db_user_name String 默认用户名。 vpc_id String 虚拟私有云ID。 subnet_id String 子网的网络ID信息。 security_group_id String 安全组ID。 flavor_ref String 规格码。参考查询数据库规格中“spec_code”字段获取。 flavor_info 表8 object 规格信息。 volume 表9 object Volume信息。 switch_strategy String 数据库切换策略。取值为“reliability”或“availability”，分别对应于可靠性优先和可用性优先。 若创建时没有选择切换策略，则不予显示。 backup_strategy 表10 object 备份策略。 maintenance_window String 可维护时间窗，为UTC时间。 nodes Array of 表11 objects 实例节点信息列表。 enterprise_project_id String 企业项目标签ID。非企业项目账号的实例，企业项目默认0。 instance_mode String basic为基础版 ，enterprise为企业版。 disk_encryption_id String 磁盘加密密钥ID。只有创建磁盘加密实例才会显示该参数。 charge_info 表12 object 计费类型信息，支持按需和包周期。 time_zone String 时区。 tags Array of 表13 objects 标签列表，没有标签不返回该参数。 disk_usage String 实例磁盘的可使用率，值范围[0-1]，值保留四位小数。 mysql_compatibility 表14 object 实例MySQL兼容配置。 表5 ListHaResult 参数 参数类型 描述 consistency String 数据库一致性类型，分布式模式实例仅有。取值为“strong”、“eventual”，分别表示强一致性、最终一致性。 枚举值： strong eventual replication_mode String 备机同步参数。 取值：非空。 GaussDB为 “sync” 说明： “sync”为同步模式。 表6 ListInstanceDatastore 参数 参数类型 描述 type String 数据库引擎。 version String 数据库大版本。 complete_version String 数据库小版本。 target_version String 数据库正在升级的目标版本。 complete_kernel_version String 数据库内核版本。 hotfix_version_infos Array of 表7 objects 热补丁信息列表。 表7 HotfixVersionInfo 参数 参数类型 描述 version String 热补丁版本。 upgrade_finished_time String 热补丁升级完成时间列表。 热补丁升级完成时间，格式为“yyyy-mm-dd hh:mm:ss timezone”。 其中timezone是指时区。 表8 ListFlavorInfo 参数 参数类型 描述 vcpu Integer CPU核数。 mem Integer 内存大小。 表9 ListVolume 参数 参数类型 描述 type String 磁盘类型。 size Integer 磁盘大小。 表10 OpenGaussBackupStrategyForListResponse 参数 参数类型 描述 start_time String 备份时间段。自动备份将在该时间段内触发。 当前时间指UTC时间。 keep_days Integer 已生成的备份文件可以保存的天数。 取值范围：1～732。 表11 NodeResult 参数 参数类型 描述 id String 节点ID。 name String 节点名称。 role String 节点类型，取值为“master”、“slave”，分别对应于主节点、备节点。 status String 节点状态。 availability_zone String 可用区。 private_ip String 节点内网IP。分布式实例类型下该参数仅针对CN节点有效，主备版实例类型下该参数对所有节点有效，且在弹性云服务器创建成功后参数值存在。 public_ip String 绑定的外网IP。分布式实例类型下该参数仅针对CN节点有效，主备版实例类型下该参数对所有节点有效，且在弹性云服务器创建成功并绑定弹性公网IP后参数值存在。 component_names String 节点上组件信息（例组件ID:分布式ID），多个组件信息用;隔开。 表12 OpenGaussChargeInfoListResponse 参数 参数类型 描述 charge_mode String 计费模式。 取值范围： postPaid：后付费，即按需付费。 prePaid：预付费，即包年/包月。 表13 TagResult 参数 参数类型 描述 key String 标签键。 value String 标签值。 表14 MySQLCompatibilityResult 参数 参数类型 描述 port String MySQL兼容端口。

URI GET https://{Endpoint}/v3.2/{project_id}/instances 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 id 否 String 实例ID。 “*”为系统保留字符，如果iID是以“*”起始，表示按照*后面的值模糊匹配，否则，按照ID精确匹配查询。不能只传入“*”。 name 否 String 实例名称。 “*”为系统保留字符，如果name是以“*”起始，表示按照*后面的值模糊匹配，否则，按照name精确匹配查询。不能只传入“*”。 type 否 String 按照实例类型查询。目前仅支持取值“Enterprise”（区分大小写），对应分布式实例（企业版）。当前支持取值"Ha"（区分大小写），对应主备式实例。 枚举值： Enterprise Ha datastore_type 否 String 数据库类型，区分大小写。 枚举值： GaussDB vpc_id 否 String 虚拟私有云ID。 方法1：登录虚拟私有云服务的控制台界面，在虚拟私有云的详情页面查找VPC ID。 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询VPC列表。 subnet_id 否 String 子网的网络ID信息。 方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找网络ID。 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询子网列表。 offset 否 Integer 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 limit 否 Integer 查询记录数。默认为100，不能为负数，最小值为1，最大值为100 tags 否 Array 根据实例标签键值对进行查询。 {key}表示标签键，不可以为空或重复。最大长度127个unicode字符。key不能为空或者空字符串，不能为空格，使用之前先trim前后半角空格。不能包含+/?#&=,%特殊字符。 {value}表示标签值，可以为空。最大长度255个unicode字符，使用之前先trim 前后半角空格。不能包含+/?#&=,%特殊字符。 如果value为空，则表示any_value（查询任意value）。 如果同时使用多个标签键值对进行查询，中间使用逗号分隔开，最多包含10组。 charge_mode 否 String 计费模式。 取值范围： postPaid：后付费，即按需付费。 prePaid：预付费，即包年/包月。

前提条件 需要获取待纳管数据库的管理员账号及密码。 需要具备AppStage服务运维岗位权限或数据库DBA角色权限，权限申请操作请参见申请权限。 已设置执行机。 同VPC执行机：将待纳管的数据库所在VPC下的主机设置为执行机。 跨VPC执行机：将待纳管数据库的自有服务下所属其他VPC的主机设置为执行机。 数据库纳管时系统会优先使用该数据库同VPC下的执行机，如果同VPC下没有执行机，随机选择服务关联的其他VPC下的执行机。跨VPC时，需保证执行机所在VPC与待接入运维中心的数据库所在VPC网络互通。请参见对等连接和安全组，连通服务关联的所有VPC，放通数据库和服务下所有执行机的安全组。

响应示例 状态码： 202 ACCEPTED { "instance_id" : "6a7d71827fd54572b1f31aa9548fcc81", "message" : "JOB_ASSIGNED_FOR_RESIZE_0086I:The job JOB-5acb75c7565e42c997954774456eac79 is assigned to resize instance.", "job_id" : "JOB-5acb75c7565e42c997954774456eac79" } 状态码： 401 Unauthorized { "error_code" : "APIC.7102", "error_msg" : "Incorrect token or token resolution failed" } 状态码： 403 Forbidden { "error_code" : "APIC.7106", "error_msg" : "No permissions to request for the method" } 状态码： 500 Internal Server Error { "error_code" : "APIC.9000", "error_msg" : "Failed to request internal service" }

响应参数 状态码： 202 表4 响应Body参数 参数 参数类型 描述 instance_id String 实例ID message String 实例扩容任务信息 job_id String 任务编号 状态码： 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

操作步骤 进入API网关控制台页面。 在左侧导航栏选择“实例管理”。 在待配置参数的实例上，单击“查看控制台”或实例名称。 单击“配置参数”页签，找到您需要调整的配置项并进行修改。不同的实例规格展示的配置参数会存在不同，具体以界面为准。 表1 实例配置参数说明 信息项 描述 ratelimit_api_limits API全局默认流控值，默认值为200次/秒。API未绑定流控策略时，执行此默认流控；API绑定流控策略时，则执行绑定的流控策略。流控策略的API流量限制值不能超过API全局默认流控值。 request_body_size API请求中允许携带的Body大小上限，默认值为12MB，可修改范围为1MB~9536MB。 backend_timeout 后端响应超时时间上限，默认值为60000ms，可修改范围为1ms~600000ms。 app_token app_token认证方式开关，默认关闭。启用后，可在API请求中使用获取的access_token进行API的调用认证。 app_token_expire_time：access_token的有效时间，在access_token到期前，请及时获取新的access_token并更新，避免影响正常使用。 refresh_token_expire_time：refresh_token的有效时间。refresh_token用于获取新的access_token。 app_token_uri：获取access_token的uri。 app_token_key：access_token的加密key。 app_api_key app_api_key认证方式开关，默认关闭。启用后，可在API请求中添加“apikey”参数，携带凭据的Key进行API的调用认证。 app_basic app_basic认证方式开关，默认关闭。启用后，在API请求中添加Header参数“Authorization”，参数值为"Basic"+base64(appkey:appsecret)，其中appkey和appsecret分别为凭据的Key和Secret。 app_secret app_secret认证方式开关，默认关闭。启用后，可在API请求中添加“X-HW-ID”和“X-HW-AppKey”参数，携带凭据的Key和Secret进行API的调用认证。 app_route 支持IP访问开关，默认关闭。启用后，非DEFAULT分组下的APP认证的API可以使用IP地址调用。 backend_client_certificate 后端双向认证开关，默认关闭。启用后，创建API配置后端服务时，可配置后端双向认证。 ssl_ciphers 支持配置https加密套件，默认所有的加密套件全部支持。当您绑定独立 域名 后，可根据需要选择支持的加密套件。 real_ip_from_xff 是否使用X-Forwarded-For头中的IP作为ACL、流控的判断依据，默认不使用。 xff_index：X-Forwarded-For头中IP的排序序号，值允许为正数、负数、0。 xff_index值为0或正数时，获取X-Forwarded-For头中对应索引的IP。 xff_index值为负数时，按倒序方式从X-Forwarded-For头中获取IP。 例如到达API网关的X-Forwarded-For头中依次有IP1，IP2，IP3三个IP地址，xff_index取0时获取IP1，xff_index取1时获取IP2，xff_index取-1时获取IP3，xff_index取-2时获取IP2。 vpc_name_modifiable 负载通道名称是否可修改，默认可修改。 须知： 负载通道名称可修改时，当前实例的负载通道无法通过项目级负载通道管理接口操作。 app_jwt_enable app_jwt认证方式开关，默认关闭。启用后，可在API请求中添加“Authorization”和“Timestamp”参数，携带凭据的Key和Secret以及时间戳进行API的调用认证。 app_jwt_auth_header：app_jwt认证头，即API请求中携带app_jwt认证信息的Header参数，默认为Authorization。 public_key_enable public_key类型签名密钥开关，默认关闭。启用后，可在签名密钥认证中使用public_key类型签名。 public_key_uri_prefix：获取public_key对应secret的uri前缀。具体uri格式为：https://{虚拟私有云访问地址}{public_key_uri_prefix}{public_key签名密钥名称}。 custom_auth_header 认证头域自定义配置开关，默认关闭。启用后，参数“app_auth_header”和“backend_sign_header”的初始值为空，与不启用效果一致。 如果配置“app_auth_header”的“参数运行值”，那么对于APP认证的API，请求header中携带APP认证信息的参数为此处“app_auth_header”的值；如果配置“backend_sign_header”的“参数运行值”，那么对于绑定HMAC或者Basic Auth类型签名密钥策略的API，API网关到后端服务的请求header中携带签名信息的参数为此处“backend_sign_header”的值。 须知： 配置后会影响当前实例下所有APP认证或签名密钥策略（HMAC/Basic Auth类型），请谨慎配置。 gzip 对响应请求使用gzip压缩，用于减少公网流量。默认未配置gzip压缩，配置后1分钟生效，请谨慎修改。 启用后，可配置comp_level参数，comp_level表示压缩级别，值越大表示性能消耗越大，一般默认为6。 须知： 响应请求体大于1KB时，您可以使用gzip压缩文件（即1KB以下的文件不做压缩）。 gzip压缩支持的文件类型有text/xml、text/plain、text/css、application/javascript、application/x-javascript、application/rss+xml、text/javascript、image/tiff、image/svg+xml、application/json、application/xml 启用gzip压缩后，须在请求中添加请求头“Accept-Encoding: gzip”。 gzip配置完成后，如需修改，至少需要1分钟后。 custom_log 自定义日志功能开关，默认关闭。开启自定义日志功能后，实例下所有API的调用日志中会在指定位置打印指定参数的值。 启用后，需单击“编辑”，添加需在调用日志中打印的参数。 须知： 自定义日志只支持打印由客户端发起的请求信息，不支持打印在APIG中定义的常量参数和系统参数。 自定义日志最多可配置10个字段，且字段大小总和不得超过2KB。 参数值中的部分特殊字符会进行编码，例如：加号（+）会被编码为空格“ ”，双引号（"）会被编码为“\x22”，反斜杠（\）会被编码为“\x5C”。 sse_strategy SSE传输策略开关，默认关闭。启用后，支持通过使用Server-Sent Events (SSE)按照流式输出API的响应内容，可以实现逐字符渲染。 须知： sse_strategy配置完成后，如需修改，至少需要1分钟后。 request_custom_config 支持自定义配置客户端请求相关参数。 HTTP/2：HTTP/2协议的开关，默认为开启状态。更多详情请参考支持HTTP2.0。 request_body_timeout：客户端请求体超时时间的修改，默认为8s。网络状况差或请求体过大的情况下可适当调整该参数。 须知： 客户端请求自定义配置修改完成后，如需修改，至少需要1分钟后。 api_uri_no_escape API的URL中的Path转义处理开关。默认关闭，表示URL中的Path会进行转义处理。 开启“api_uri_no_escape”开关后，使用Path不转义的功能请参见表2。 表2 Path不转义影响的功能 功能 描述 API前端定义的Path 请求发送时使用的Path api_uri_no_escape开关关闭 api_uri_no_escape开关开启 API定义 APIG进行匹配路由的Path /{path} /aa%2Faa /aa/aa /aa%2Faa 参数编排 后端服务参数使用的Path - - /aa/aa /aa%2Faa http到https重定向 重定向使用的Path - - /aa/aa /aa%2Faa 策略后端 策略条件为请求入参的Path - - /aa/aa /aa%2Faa 第三方认证策略 API绑定第三方认证策略后，传递到第三方的Path - - /aa/aa /aa%2Faa kafka日志推送策略 API绑定kafka日志推送策略后，使用的请求Path - - /aa/aa /aa%2Faa 负载通道 使用URI哈希分发算法的负载通道时，APIG用来转发的Path - - /aa/aa /aa%2Faa FunctionGraph后端 API的后端类型为FunctionGraph时，发送到函数请求Path - - /aa/aa /aa%2Faa 自定义认证 API认证方式选择自定义认证时，发送到函数请求Path - - /aa/aa /aa%2Faa

流控类型介绍 支持的流控类型有节点级流控，服务级流控，接口级流控，IP流控，自定义参数流控，多参数组合流控，配额流控及并发连接流控，流控类型介绍如表1所示。每种类型的流控只能添加一次，SLB流控的顺序按照页面从上往下匹配，页面支持上下移动流控的顺序。 表1 流控类型说明 类型 流控维度 窗口类型 限制 节点级流控 所有请求 漏桶 请求速率 服务级流控 以请求的Host字段为维度 漏桶 请求速率 接口级流控 以请求的uri路径为维度 漏桶 请求速率 IP流控 以取得的请求IP为维度 漏桶 请求速率 自定义参数流控 以自定义的单个参数为维度 漏桶 请求速率 多参数组合流控 以自定义的多个参数为维度 漏桶 请求速率 配额流控 以自定义的多个参数为维度 固定窗口。 请求量。 并发连接流控 以自定义的多个参数为维度 N/A 并发量。 窗口类型 漏桶：请求被均匀地限制，支持突发量配置。一般情况下，建议业务进行评估，并加上适当突发量，突发量一般不超过1秒的量。 固定窗口：只要在窗口内部超限即可。 例如同为100个/秒的限制，滑动窗口下，第0.1秒只能有10个请求，当然，滑动窗口下有个突发量的配置，在突发量10个的情况，可以在业务瞬间突发时额外再支持10个，突发池用满以后，即不可再用，只有等请求量下滑低于正常流控量时，再慢慢恢复突发池；固定窗口下，第0.1秒也可以允许100个请求。 限制类型 请求量：并不关注请求是否为并发，例如10个请求不论到来和处理的时间是否有并发情况，都记为10个。 并发量：只看某时间点，正在处理的请求的个数。如果请求1的开始时间到响应时间这个时间段，与请求2的开始时间到响应时间的时间段并不相互交叠，则请求1和请求2不是并发。否则存在并发关系。

云手机实例管理概述 在云手机实例管理页面，实例列表区域可以查看到实例详细信息。单击实例列表右上方设置按钮，可自定义实例列表展示参数，必选与可选项详见表1。 表1 参数说明 参数 是否必选 参数说明 云手机名称/ID 是 云手机名称：购买云手机时自定义的云手机名称。 云手机ID：系统会给云手机实例分配一个实例ID，用于标记该实例。 区域 是 云手机的物理数据中心所在的位置，区域不同即物理数据中心距离用户的物理距离不同，网络延迟不同。 说明： 云手机购买成功后不能更换区域。 规格信息 是 云手机的规格信息，包含vCPU、内存等。 运行状态 是 包含已停止、运行中、下线中、启动中、已关机。 登录状态 否 包含已登录、未登录。已登录指云机正在串流，未登录指云机无串流。 分配状态 否 包含已分配、未分配。 用户名 否 管理员为成员配置的用户姓名。 账号名 否 管理员为成员设置的账号名。 计费模式 是 显示包年/包月、按需计费，以及剩余到期时间或状态信息。 正常状态：显示距离到期时间的倒计时（包年/包月）；云手机实例创建时间（按需计费）。 到期冻结状态：显示已冻结以及距离删除时间的倒计时。 公安冻结状态：显示已冻结（违规）。 违规冻结状态：显示已冻结（违规）以及距离删除时间的倒计时。 您可以选择一台或多台云手机实例进行重启、开机、关机、续费、退订、应用卸载、删除。关于应用卸载的详细请参见应用卸载。 云手机ID，单击可切换为：云手机名称、区域、规格信息、用户名等参数。在搜索栏输入对应参数可进行筛选，或者单击运行状态旁的筛选按钮进行筛选。 单击右侧搜索按钮，可筛选出对应过滤条件的实例信息。 单击右上角的，可刷新到所有实例的最新信息。 父主题： 云手机实例管理

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 error_code String 响应码，错误码规范KOOPHONE.API.0001，数字递增 error_code为0时表示成功 error_msg String 响应描述 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 响应码，错误码规范KOOPHONE.API.0001，数字递增 error_code为0时表示成功 error_msg String 响应描述 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 响应码，错误码规范KOOPHONE.API.0001，数字递增 error_code为0时表示成功 error_msg String 响应描述