响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 instance_id String 参数解释： 实例ID。 取值范围： 不涉及。 dns_name String 参数解释： 实例域名。 取值范围： 不涉及。 dns_type String 参数解释： 域名类型。 取值范围： private ipv4_address String 参数解释： 实例域名绑定的vIP。 取值范围： 不涉及。 status String 参数解释： 域名状态。 取值范围： normal：正常。 正常响应样例 { "instance_id": "2de6315e7197418fbf2fdaed59d65da1in03", "dns_name": "2de6315e7197418fbf2fdaed59d65da1in03.internal.****.postgresql.rds.myhuaweicloud.com", "dns_type": "private", "ipv4_address": "192.168.6.105", "status": "normal" } 异常响应 请参见异常请求结果。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/dns 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 dns_type 是 参数解释： 域名类型。 约束限制： 不涉及。 取值范围： private 默认取值： 不涉及。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/no-index-tables 参数说明 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 String 参数解释： 要查询的实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 newest 是 Boolean 参数解释： 指定查询是否应侧重于检索最新的无索引表。 约束限制： 不涉及。 取值范围： true：查询时检索最新无索引表。 false：查询时不检索最新无索引表。 默认取值： 不涉及。 table_type 是 String 参数解释： 指定表类型。 约束限制： 不涉及。 取值范围： no_primary_key：无主键表。 默认取值： 不涉及。 offset 否 Integer 参数解释： 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 约束限制： 不涉及。 取值范围： 大于等于0的整数。 默认取值： 不涉及。 limit 否 Integer 参数解释： 查询记录数。 约束限制： 不涉及。 取值范围： 1~1000 默认取值： 不涉及。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 reset_view_last_time Long 参数解释： 最新重置时间。 取值范围： 不涉及。 total_count Integer 参数解释： SQL统计列表条数。 取值范围： 不涉及。 list Array of objects 参数解释： 调用结果。详情请参见表3。 表3 list字段说明 名称 参数类型 说明 user_name String 参数解释： 用户名称。 取值范围： 不涉及。 database String 参数解释： 数据库名称。 取值范围： 不涉及。 query_id String 参数解释： 由SQL的语法解析树计算出的内部哈希码。 取值范围： 不涉及。 calls Long 参数解释： 调用次数。 取值范围： 不涉及。 query String 参数解释： SQL语句的文本形式。 取值范围： 不涉及。 rows Long 参数解释： 扫描行数。 取值范围： 不涉及。 canUse double 参数解释： 是否可以执行SQL限流。 取值范围： 不涉及。 正常响应样例 { "reset_view_last_time": 1561561651651, "total_count": 1, "list": [ { "user_name": "root", "database": "data_test", "query_id": "4454541510", "calls": 1111, "query": "select pg_sleep(222);", "rows": 111, "canUse": true } ] }

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/sql-statistics 参数说明 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 offset 否 Integer 参数解释： 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 约束限制： 必须为数字，不能为负数。 取值范围： 大于等于0的整数。 默认取值： 0 limit 否 Integer 参数解释： 查询记录数。 约束限制： 不涉及。 取值范围： 默认为1000，不能为负数，最小值为1，最大值为1000。 默认取值： 1000

请求示例 创建数据库用户rds。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/a8abe84a41364097be7c233c39275087in04/db_user { "name": "rds", "password": "********", "instance_readonly": true }

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 name 是 String 参数解释： 数据库账号名称。 约束限制： 不涉及。 取值范围： 数据库账号名称在1到128个字符之间，不能和系统用户名称相同。 系统用户包括：rdsadmin, rdsuser, rdsbackup, rdsmirror。 默认取值： 不涉及。 password 是 String 参数解释： 数据库账号密码。 约束限制： 建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。 取值范围： 非空，密码长度在8到32个字符之间，至少包含大写字母、小写字母、数字、特殊字符~!@#$%^*-_+?,三种字符的组合，不能与账号名或倒序的账号名相同。 默认取值： 不涉及。 instance_readonly 否 Boolean 参数解释： 是否创建实例级只读账号，即创建的账号具备所有自定义数据库的只读权限。 约束限制： 不涉及。 取值范围： true：创建实例级只读账号。 false：不创建实例级只读账号。 默认取值： 不涉及。

URI URI格式 POST /v3/{project_id}/instances/{instance_id}/db_user 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

RDS for PostgreSQL版本各阶段说明 版本公测阶段：您可以通过RDS for PostgreSQL公测版本体验最新的RDS for PostgreSQL版本特性，但需要注意该版本的稳定性未得到完全的验证，不适用于RDS for PostgreSQL服务SLA。 版本商用阶段：RDS for PostgreSQL商用版本经过充分验证，稳定可靠。您可以将该版本用于生产环境，享受RDS for PostgreSQL服务SLA保障。 版本EOS（停止服务）阶段：RDS for PostgreSQL版本EOS之后，RDS for PostgreSQL将不再支持对该版本的创建，同时不提供相应的技术支持，包含新特性更新、漏洞/问题修复、补丁升级等客户支持，不再适用于RDS for PostgreSQL服务SLA保障。

各版本生命周期 表1 各版本生命周期 PostgreSQL版本号 当前状态 社区发布时间 社区EOL时间 华为云发布时间 华为云EOM时间 华为云EOS时间 17 已商用 2024年9月 2029年11月 2025年3月 2030年5月 2030年11月 16 已商用 2023年9月 2028年11月 2024年4月 2029年5月 2029年11月 15 已商用 2022年10月 2027年11月 2023年9月 2028年5月 2028年11月 14 已商用 2021年9月 2026年11月 2022年7月 2027年5月 2027年11月 13 已商用 2020年9月 2025年11月 2021年4月 2026年5月 2026年11月 12 已停售 2019年10月 2024年11月 2020年3月 2025年5月 2025年11月 11 EOS 2018年10月 2023年11月 2019年1月 2024年7月 2024年11月 10 EOS 2017年10月 2022年11月 2018年11月 2024年7月 2024年11月 9.6 EOS 2016年9月 2021年11月 2018年2月 2023年6月 2024年7月 9.5 EOS 2016年1月 2021年2月 2017年10月 2023年6月 2024年7月 RDS for PostgreSQL增强版说明： RDS for PostgreSQL增强版基于PostgreSQL 11开发，当前PostgreSQL增强版已经进入存量经营。 华为云云数据库PostgreSQL增强版于2022年10月15日00:00（北京时间）停售，详见停售公告。 RDS for PostgreSQL一般会在社区版本生命周期结束（EOL）一年后也停止支持服务，如果有变化也会修正本文档，请以实际为准。 华为云RDS for PostgreSQL产品生命周期结束后，将不再售卖，并且对已经EOS（停止服务）的存量实例不提供相应的技术支持，包含新特性更新、漏洞/问题修复、补丁升级等，建议将已经EOS的存量实例尽快升级到最新的内核版本，避免出现严重影响实例安全和稳定的风险。 RDS for PostgreSQL会定期同步PostgreSQL社区的漏洞修复，当有对应的小版本更新时，请及时升级小版本。

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 statistics Array of objects 参数解释： 不同维度下的统计信息。 详情请参见表4。 表4 statistics元素结构说明 名称 参数类型 说明 keyword String 参数解释： 该类统计维度下提取到的限流关键字。 取值范围： 不涉及。 raw_sql_text String 参数解释： 随机选取符合SQL限流关键字的用户某条SQL样例。 取值范围： 不涉及。 ids Array of longs 参数解释： 符合该统计维度的线程ID。 取值范围： 不涉及。 count Integer 参数解释： 符合该统计维度的线程ID总数量。 取值范围： 不涉及。 total_time Double 参数解释： 符合该统计维度的线程总执行时间。 取值范围： 不涉及。 avg_time Double 参数解释： 符合该统计维度的线程平均执行时间。 取值范围： 不涉及。 max_time Double 参数解释： 符合该统计维度的线程最大执行时间。 取值范围： 不涉及。 strategy String 参数解释： 统计维度。 取值范围： top3_time：top3执行时长。 top3_count：top3出现次数。 top3_avg_time：top3平均执行时长。 advice_concurrency Integer 参数解释： 推荐最大并发数。 取值范围： 不涉及。 正常响应样例 { "statistics": [ { "keyword": "SELECT~FROM~table~WHERE~id", "raw_sql_text": "select *from db1", "ids": [ 123, 124, 125, 126 ], "count": 4, "total_time": 14, "avg_time": 3.5, "max_time": 5, "strategy": "top3_average", "advice_concurrency": "5" } ] } 异常响应 请参见异常请求结果。

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 total_count Integer 参数解释： Binlog合并下载文件数量。 取值范围： 不涉及。 pack_log_infos Array of objects 参数解释： Binlog合并下载文件信息。 详情请参见表4。 表4 pack_log_infos元素结构说明 名称 参数类型 说明 id String 参数解释： 文件唯一ID标识。 取值范围： 不涉及。 instance_id String 参数解释： 实例ID。 取值范围： 不涉及。 size Double 参数解释： 文件大小。 取值范围： 不涉及。 size_unit String 参数解释： 文件大小单位。 取值范围： 不涉及。 status String 参数解释： 状态。 取值范围： 不涉及。 query_start_time Long 参数解释： 合并时间段起始时间戳。 取值范围： 不涉及。 query_end_time Long 参数解释： 合并时间段结束时间戳。 取值范围： 不涉及。 file_name String 参数解释： 文件名。 取值范围： 不涉及。 正常响应样例 { "total_count": 100, "pack_log_infos": [ { "id": "815635c7-22ff-4d84-8be5-89602c8c154d", "instance_id": "e67d9956f8d143ab85dcff32484b68d8in01", "size": 982, "size_unit": "KB", "status": "Active", "query_start_time": 1715234525000, "query_end_time": 1715235844000, "file_name": "ef561226aee54ba89a2ee752cd9de2fx_e67d9956f8d143ab85dcff32484b68d8in01_PackLog_815635c7-22ff-4d84-8be5-89602c8c154d_1715067022363_.tar.gz" } ] } 异常响应 请参见异常请求结果。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 tags Array of objects 参数解释： 标签列表，没有标签默认为空数组。 详情请参见表3。 表3 tags字段数据结构说明 名称 参数类型 说明 key String 参数解释： 标签键。 取值范围： 不涉及。 value String 参数解释： 标签值。 取值范围： 不涉及。 tag_type String 参数解释： 标签类型。 取值范围： user：用户标签。 system：系统标签。 正常响应样例 { "tags": [{ "key": "keyName", "value": "keyValue", "tag_type": "user" }] } 异常响应 请参见异常请求结果。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/tags 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

响应消息 正常响应要素说明 表2 参数说明 名称 参数类型 说明 job Object 参数解释： 任务信息，请参见表3。 表3 job字段数据结构说明 名称 参数类型 说明 id String 参数解释： 任务ID。 取值范围： 不涉及。 name String 参数解释： 任务名称。 取值范围： 不涉及。 status String 参数解释： 任务执行状态。 取值范围： Running：表示任务正在执行。 Completed：表示任务执行成功。 Failed：表示任务执行失败。 created String 参数解释： 创建时间。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 ended String 参数解释： 结束时间。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 process String 参数解释： 任务执行进度。 取值范围： 执行中状态才返回执行进度，例如“60%”，表示任务执行进度为60%，否则返回""。 instance Object 参数解释： 执行任务的实例信息。 请参见表4。 entities Object 参数解释： 根据不同的任务，显示不同的内容。 请参见表表5。 说明： 未有entities字段说明的异步任务，返回为{}。 fail_reason String 参数解释： 任务执行失败时的错误信息。 取值范围： 不涉及。 表4 instances字段数据结构说明 名称 参数类型 说明 id String 参数解释： 实例ID。 取值范围： 不涉及。 name String 参数解释： 实例名称。 取值范围： 不涉及。 表5 entities字段数据结构说明 名称 参数类型 说明 instance Object 参数解释： 创建实例，单转主备，创建只读实例任务想要实现的实例信息。 请参见表6。 resource_ids Array of strings 参数解释： 任务涉及到的资源ID。 取值范围： 不涉及。 volume Object 参数解释： 调整实例容量任务的磁盘信息。 详情请参见表8。 public_ip String 参数解释： 任务实现的弹性公网IP。 取值范围： 不涉及。 switch_strategy String 参数解释： 主备倒换策略。 取值范围： 不涉及。 表6 entities.instance字段数据结构说明 名称 参数类型 说明 endpoint String 参数解释： 实例的连接地址。 取值范围： 不涉及。 type String 参数解释： 实例类型。 取值范围： Single：单机实例。 Ha：主备实例。 Replica：只读实例。 datastore Object 参数解释： 数据库信息，请参见表7。 replica_of String 参数解释： 主实例ID，仅创建只读实例的时候返回。 取值范围： 不涉及。 表7 datastore字段数据结构说明 名称 参数类型 说明 type String 参数解释： 数据库引擎。 取值范围： mysql postgresql sqlserver version String 参数解释： 数据库版本。 取值范围： 不涉及。 表8 volume字段数据结构说明 名称 参数类型 说明 type String 参数解释： 磁盘类型。 取值范围： ULTRAHIGH，表示超高IO型磁盘。 LOCALSSD，表示本地SSD盘。 CLOUDSSD，表示SSD云盘，仅支持通用型和独享型规格实例。 ESSD，表示极速型SSD。 original_size String 参数解释： 实例原本的磁盘大小（单位：GB）。 取值范围： 不涉及。 target_size String 参数解释： 任务的目标磁盘大小（单位：GB）。 取值范围： 不涉及。 响应样例中取任务中心部分任务作为示例。 正常响应样例 创建实例： { "job": { "id": "31b8ae23-c687-4d80-b7b4-42a66c9bb886", "name": "CreateMysqlSingleHAInstance", "status": "Completed", "created": "2018-08-06T10:41:14+0000", "ended": "2018-08-06T16:41:14+0000", "process": "", "instance": { "id": "a48e43ff268f4c0e879652d65e63d0fbin01", "name": "DO-NOT-TOUCH-mgr2-mysql-single" }, "entities": { "instance": { "endpoint": "192.168.1.203:3306", "type": "Single", "datastore": { "type": "mysql", "version": "5.7" } }, "resource_ids": ["a48e43ff268f4c0e879652d65e63d0fbin01.vm", "a48e43ff268f4c0e879652d65e63d0fbin01.volume"] } } } 创建只读实例： { "job": { "id": "31b8ae23-c687-4d80-b7b4-42a66c9bb886", "name": " CreateMysqlReplicaInstance", "status": "Completed", "created": "2018-08-06T10:41:14+0000", "ended": "2018-08-06T16:41:14+0000", "process": "", "instance": { "id": "288caaa9d05f4ec1a1f58de2e0945685in01", "name": "mysql-replica" }, "entities": { "instance": { "endpoint": "192.168.1.203:3306", "type": "replica", "datastore": { "type": "mysql", "version": "5.7" }, "replica_of": "a48e43ff268f4c0e879652d65e63d0fbin01" }, "resource_ids": ["288caaa9d05f4ec1a1f58de2e0945685in01.vm", "288caaa9d05f4ec1a1f58de2e0945685in01.volume"] } } } 绑定弹性公网IP： { "job": { "id": "31b8ae23-c687-4d80-b7b4-42a66c9bb886", "name": "MysqlBindEIP", "status": "Completed", "created": "2018-08-06T10:41:14+0000", "ended": "2018-08-06T16:41:14+0000", "process": "", "instance": { "id": "a48e43ff268f4c0e879652d65e63d0fbin01", "name": "DO-NOT-TOUCH-mgr2-mysql-single" }, "entities": { "public_ip": "10.10.10.1" } } } 重启实例： { "job": { "id": "31b8ae23-c687-4d80-b7b4-42a66c9bb886", "name": " RestartMysqlInstance", "status": "Completed", "created": "2018-08-06T10:41:14+0000", "ended": "2018-08-06T16:41:14+0000", "process": "", "instance": { "id": "a48e43ff268f4c0e879652d65e63d0fbin01", "name": "DO-NOT-TOUCH-mgr2-mysql-single" }, "entities": {} } } 任务正在执行中： { "job": { "id": "31 b8ae23 - c687 - 4 d80 - b7b4 - 42 a66c9bb886", "name": "CreateMysqlSingleHAInstance”，“ status”: “Running", "created": "2018-08-06T10:41:14+0000", "process": "60 % ", "instance": { "id": "a48e43ff268f4c0e879652d65e63d0fbin01", "name": "DO-NOT-TOUCH-mgr2-mysql-single" }, "entities": { "instance": { "type": "Single", "datastore": { "type": "mysql", "version": "5.7" } } } } } 任务执行失败： { "job": { "id": "31 b8ae23 - c687 - 4 d80 - b7b4 - 42 a66c9bb886", "name": "CreateMysqlSingleHAInstance", "status": "Failed", "created": "2018-08-06T10:41:14+0000", "ended": "2018-08-06T16:41:14+0000", "process": "", "instance": { "id": "a48e43ff268f4c0e879652d65e63d0fbin01", "name": "DO-NOT-TOUCH-mgr2-mysql-single" }, "entities": { "instance": { "type": "Single", "datastore": { "type": "mysql", "version": "5.7" } } }, "fail_reason": "createVM failed." } } 异常响应 请参见异常请求结果。