数据库引擎和版本 RDS for PostgreSQL目前支持的数据库引擎和版本如表1所示。 表1 数据库引擎和版本 数据库引擎 单机实例 主备实例 PostgreSQL 17（如需购买17版本的实例，请提交工单申请。） 16 15 14 13 12 11（不支持购买，仅存量经营） 10（不支持购买，仅存量经营） 9.6（不支持购买，仅存量经营） 9.5（不支持购买，仅存量经营） 17（如需购买17版本的实例，请提交工单申请。） 16 15 14 13 12 11（不支持购买，仅存量经营） 10（不支持购买，仅存量经营） 9.6（不支持购买，仅存量经营） 父主题： 实例说明

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/restore-time?date=2020-12-26 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 instance_id 是 实例ID。 date 否 所需查询的日期，为yyyy-mm-dd字符串格式，时区为UTC。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 restore_time Array of objects 可恢复时间段列表。 详情请参见表3。 表3 restore_time字段数据结构说明 名称 参数类型 说明 start_time Integer 可恢复时间段的起始时间点，UNIX时间戳格式，单位是毫秒，时区是UTC。 end_time Integer 可恢复时间段的结束时间点，UNIX时间戳格式，单位是毫秒，时区是UTC。 正常响应样例 { "restore_time": [ { "start_time": 1532001446987, "end_time": 1532742139000 } ] } 异常响应 请参见异常请求结果。

请求消息 请求参数 无。 URI样例 查询实例的所有可恢复时间段 GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/restore-time 根据指定日期查询实例的可恢复时间段 GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/restore-time?date=2020-12-26

API概览 通过使用RDS接口，您可以使用RDS的所有功能，包括创建实例、备份恢复、获取日志信息等。 类型 子类型 说明 RDS 接口 v3.1 API v3.1（推荐） 包括应用参数模板、修改指定实例的参数、恢复到已有实例等接口。 RDS 接口 v3 查询API版本 包括查询API版本列表和查询API版本信息接口。 RDS 接口 v3 查询数据库引擎的版本 获取指定数据库引擎对应的数据库版本信息。 RDS 接口 v3 查询数据库规格 获取指定数据库引擎版本对应的规格信息。 RDS 接口 v3 查询数据库磁盘类型 获取指定数据库引擎版本对应的磁盘类型。 RDS 接口 v3 获取磁盘空间使用量 获取单个实例的磁盘空间使用量。 RDS 接口 v3 实例管理 包括创建实例、调整实例容量、调整实例规格、重启实例、删除实例、获取实例列表、获取指定实例详细信息等接口。 RDS 接口 v3 灾备实例（PostgreSQL） 包括配置主实例容灾能力、配置灾备实例容灾能力、灾备实例升主等接口。 RDS 接口 v3 数据库安全性 包括设置SSL 数据加密 、修改数据库端口、修改安全组、修改内网地址等接口。 RDS 接口 v3 备份与恢复 包括设置自动备份策略、获取自动备份策略、创建手动备份、删除手动备份等接口。 RDS 接口 v3 大版本升级 包括查询实例可升级的目标版本、大版本升级检查、查询大版本检查状态或升级状态等接口。 RDS 接口 v3 获取日志信息 包括查询数据库错误日志和查询数据库慢日志接口。 RDS 接口 v3 实例诊断 包括获取诊断后的实例数和获取指定诊断项的诊断结果接口。 RDS 接口 v3 SQL限流（PostgreSQL） 包括新增SQL限流、删除SQL限流、修改SQL限流等接口。 RDS 接口 v3 数据库代理（MySQL） 包括开启数据库代理、关闭数据库代理、查询数据库代理信息等接口。 RDS 接口 v3 管理数据库和用户（MySQL） 包括创建数据库、查询数据库、创建用户、查询用户、删除数据库用户、授权数据库账号和解除账号权限等接口。 RDS 接口 v3 管理数据库和用户（PostgreSQL） 包括创建数据库、查询数据库、创建用户、查询用户等接口。 RDS 接口 v3 管理数据库和用户（SQL Server） 包括创建数据库、查询数据库、创建用户、查询用户、删除数据库用户、授权数据库账号和解除账号权限等接口。 RDS 接口 v3 参数管理 包括获取参数列表、获取配置参数信息、获取实例默认参数、设置配置参数、恢复默认参数、获取参数模板列表、获取参数模板等接口。 RDS 接口 v3 插件管理（PostgreSQL） 包括创建插件、查询插件、更新插件等接口。 RDS 接口 v3 配置只读延迟库（PostgreSQL） 包括获取wal日志延迟回放状态、中止/恢复wal日志回放接口。 RDS 接口 v3 回收站 包括设置回收站策略、查询回收站策略、查询回收站实例信息接口。 RDS 接口 v3 标签管理 包括批量添加标签、批量删除标签、查询项目标签等接口。 RDS 接口 v3 配额管理 包括查询配额接口。 RDS 接口 v3 获取任务信息 获取云数据库 RDS任务中心指定任务的信息。

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

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 db_name 是 String 数据库名称。 users 是 Array of objects 每个元素是与数据库相关联的账号。单次请求最多支持50个元素。 每个元素结构请参见表3。 表3 users列表元素数据结构说明 名称 是否必选 参数类型 说明 name 是 String 数据库账号名称。 数据库账号名称在1到32个字符之间，由字母、数字、中划线或下划线组成，不能包含其他特殊字符。 若数据库版本为RDS for MySQL 5.6，账号长度为1～16个字符。 若数据库版本为RDS for MySQL 5.7和8.0，账号长度为1～32个字符。

请求示例 DELETE https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/db_privilege { "db_name": "rds-test", "users": [ { "name": "rds" }, { "name": "rds001" } ] }

接口约束 实例在创建、变更规格、修改端口、异常或冻结状态下不能执行该操作。 除RDS界面和API以外的其他方式创建的数据库和账号，如果创建的数据库名和账号名不满足数据库命名规则（参见表2）和账号命名规则（参见表2），例如包含中文或不支持的特殊字符，那么该数据库和账号不支持RDS界面或API的数据库管理和账号管理功能。 如果源库的数据库名和账号名不满足数据库命名规则（参见表2）和账号命名规则（参见表2），迁移到目标库RDS for MySQL后，该数据库和账号也不支持RDS界面或API的数据库管理和账号管理功能。

请求示例 PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/e28979107ed04d3b8b2f1b819b8d2be3in03/hba-info [ { "type" : "host", "database" : "all", "user" : "all", "address" : "0.0.0.0/0", "mask" : "", "method" : "md5", "priority" : 0 } ]

请求消息 表2 请求参数 参数 是否必选 参数类型 描述 数组元素 否 Array of objects 参数解释： 修改参数。 详情请参见表3。 约束限制： 不涉及。 表3 参数说明 参数 是否必选 参数类型 描述 type 是 String 参数解释： 连接类型。 约束限制： 不涉及。 取值范围： 枚举值：host、hostssl、hostnossl。 默认取值： 不涉及。 database 是 String 参数解释： 数据库名。 约束限制： 不涉及。 取值范围： 除template0，template1的数据库名，多个以逗号隔开。 默认取值： 不涉及。 user 是 String 参数解释： 除内置用户（rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy）以外的用户名。 约束限制： 不涉及。 取值范围： 值为all：表示当前实例的所有数据库用户。 值为具体的用户名，多个以逗号隔开。 默认取值： 不涉及。 address 是 String 参数解释： 客户端IP地址。0.0.0.0/0表示允许用户从任意IP地址访问数据库。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 mask 否 String 参数解释： 掩码。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 空字符串。 method 是 String 参数解释： 认证方式。 约束限制： 不涉及。 取值范围： 枚举值：reject、md5、scram-sha-256。 默认取值： 不涉及。 priority 是 Integer 参数解释： 优先级，表示配置的先后。 约束限制： 不涉及。 取值范围： 修改或新增pg_hba.conf文件配置，以priority作为唯一标识。 priority不存在，表示新增文件配置。 priority存在，表示修改文件配置。 默认取值： 不涉及。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 instance_id String 实例ID。 dns_name String 实例 域名 。 dns_type String 实例域名类型：private ipv6_address String 实例域名绑定的vIP。 status String 域名状态。 正常响应样例 { "instance_id": "2de6315e7197418fbf2fdaed59d65da1in03", "dns_name": "2de6315e7197418fbf2fdaed59d65da1in03.ipv6.internal.***.mysql.rds-dev.myhuaweicloud.com", "dns_type": "private", "ipv6_address": "2001:db8:a583:3:2312:c71d:6e71:c952", "status": "normal" } 异常响应 请参见异常请求结果。

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 list List 扩展日志下载链接列表，详见表4。 count Integer 扩展日志链接数量。 表4 linkInfo字段数据结构说明 名称 参数类型 说明 file_name String 生成的下载文件名。 status String 链接的生成状态。 FINISH，表示下载链接已经生成。 EXPORTING，表示正在生成文件。 FAILED，表示存在日志文件准备失败。 file_size String 文件大小，单位：KB。 file_link String 下载链接，链接的生成状态为EXPORTING，或者FAILED时不予返回。 create_at String 生成时间。 update_at String 更新时间。 正常响应样例 正在生成扩展日志下载链接 { "list": [ { "file_name": "HkEngineEventFile_0_133337769850300000.xel", "status": "EXPORTING", "file_size": "0", "create_at": "2023-08-14T03:35:24+0000", "update_at": "2023-08-14T03:35:24+0000" } ], "count": 1 } 扩展日志下载链接获取成功 { "list": [ { "file_name": "HkEngineEventFile_0_133337769850300000.xel", "status": "SUC CES S", "file_size": "0", "file_link": "https://obs.xxx:443/xxx-7a95af72c4d54a31ae0663263f0e35ea/6e22b18b43a74e4486264194f6e09f66_EL_HkEngineEventFile_0_133337769850300000.xel?xxx", "create_at": "2023-08-14T03:35:41+0000", "update_at": "2023-08-14T03:35:41+0000" } ], "count": 1 } 异常响应 请参见异常请求结果。

请求示例 变更MySQL、PostgreSQL按需单机实例为主备实例。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action { "single_to_ha": { "az_code_new_node": "az2xahz" } } 变更MySQL、PostgreSQL包周期单机实例为主备实例。 { "single_to_ha": { "az_code_new_node": "az1xahz", "is_auto_pay": true } } 变更SQL Server按需单机实例为主备实例。 { "single_to_ha": { "az_code_new_node": "az2xahz", "ad_domain_info": { "dns_server_ip": "192.168.0.1", "domain_admin_account_name": "Administrator", "domain_admin_pwd": "password@123", "dc_domain_name": "test.com" } } } 变更SQL Server包周期单机实例为主备实例。 { "single_to_ha": { "az_code_new_node": "az2xahz", "is_auto_pay": true, "ad_domain_info": { "dns_server_ip": "192.168.0.1", "domain_admin_account_name": "Administrator", "domain_admin_pwd": "password@123", "dc_domain_name": "test.com" } } } 变更DeC用户单机实例为主备实例。 { "single_to_ha": { "az_code_new_node": "az2xahz", "password": "Test@1234567", "dsspool_id":"23728728428374823748327482r" } }

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 single_to_ha 是 Object 详情请参见表3。 表3 single_to_ha字段数据结构说明 名称 是否必选 参数类型 说明 az_code_new_node 是 String 实例节点可用区码（AZ）。 dsspool_id 否 String Dec用户专属存储ID，每个az配置的专属存储不同，实例节点所在专属存储ID，仅支持DEC用户创建时使用。 is_auto_pay 否 Boolean 仅包周期实例进行单机转主备时可指定，表示是否自动从客户的账户中支付。 true，为自动支付。 false，为手动支付，默认该方式。 ad_domain_info 否 Object 域信息，加域实例单机转主备时必填，非加域实例不需要填写。 仅RDS for SQL Server支持。 详细字段结构请参见表4。 表4 ADDomainInfo字段数据结构说明 参数 是否必选 参数类型 描述 domain_admin_account_name 是 String 域管理员账号名。 domain_admin_pwd 是 String 域管理员密码。