修订记录

2024-08-26

第六十二次正式发布。包含以下修改点：

• 新增获取磁盘空间使用量。

2024-07-29

第六十一次正式发布。包含以下修改点：

• 新增创建数据库实例（v5接口）。

2024-07-10

第六十次正式发布。包含以下修改点：

• 新增查询数据库可变更规格接口。
• 新增解除节点只读状态。
• 新增解除实例容灾关系。

2024-06-14

第五十九次正式发布。包含以下修改点：

• 新增查询指定时间点可恢复的表（PostgreSQL）。
• 新增表级时间点恢复（PostgreSQL）。

2024-06-11

第五十八次正式发布。包含以下修改点：

• 新增获取wal日志延迟回放状态。
• 新增中止/恢复wal日志回放。

2024-05-29

第五十七次正式发布。包含以下修改点：

• 新增获取错误日志下载链接（PostgreSQL）。

2024-03-11

第五十六次正式发布。包含以下修改点：

• 新增新增SQL限流。
• 新增删除SQL限流。
• 新增修改SQL限流。
• 新增查询SQL限流列表。
• 新增开启/关闭/禁用所有SQL限流。

2024-03-05

第五十五次正式发布。包含以下修改点：

• 新增开启数据库代理。
• 新增查询数据库代理信息列表。
• 新增查询数据库代理规格信息。
• 新增设置读写分离路由模式。
• 新增关闭数据库代理。
• 新增停止创建备份（PostgreSQL）。
• 新增修改数据库owner。
• 新增授予用户角色。
• 新增撤回用户角色。
• 新增查询数据库角色信息。
• 新增更新插件。

2024-01-26

第五十四次正式发布。包含以下修改点：

• 查询数据库规格增加“is_serverless”参数。
• 创建数据库实例增加“serverless_info”参数。
• 查询数据库实例列表增加“serverless_info”参数。
• 恢复到新实例增加“serverless_info”参数。
• 查询回收站实例信息增加“is_serverless”参数。

2023-12-27

第五十三次正式发布。包含以下修改点：

新增收缩数据库日志。

2023-12-15

第五十二次正式发布。包含以下修改点：

• 新增开启实例TDE（SQL Server）。
• 新增查询实例TDE状态（SQL Server）。
• 新增查询实例可升级的目标版本（PostgreSQL）。
• 新增大版本升级检查（PostgreSQL）。
• 新增查询大版本检查状态或升级状态（PostgreSQL）。
• 新增查询实例大版本升级检查历史（PostgreSQL）。
• 新增大版本升级（PostgreSQL）。
• 新增查询实例大版本升级历史（PostgreSQL）。
• 新增收缩数据库日志（不推荐使用）。
• 新增设置数据库账号密码。

2023-11-06

第五十一次正式发布。包含以下修改点：

• 新增查询实例的pg_hba.conf文件配置。
• 新增修改pg_hba.conf文件的单个或多个配置。
• 新增覆盖当前pg_hba.conf文件的配置。
• 新增删除pg_hba.conf文件的单个或多个配置。
• 新增查询实例的pg_hba.conf文件修改历史。

2023-09-15

第五十次正式发布。包含以下修改点：

• 新增表级时间点恢复（MySQL）。
• 新增升级内核小版本。

2023-07-24

第四十九次正式发布。包含以下修改点：

• 表级时间点恢复（MySQL）增加“is_fast_restore”参数。
• 新增查询实例是否能在库表恢复时使用极速恢复（MySQL）。

2023-05-25

第四十八次正式发布。包含以下修改点：

查询数据库列表增加“recover_model”参数。

2023-03-17

第四十七次正式发布。包含以下修改点：

• 新增查询回收站策略。
• 新增查询回收站实例信息。

2023-02-24

第四十六次正式发布。包含以下修改点：

• 创建RDS for MySQL实例支持请求幂等性。
• 新增请求幂等性说明。

2023-02-08

第四十五次正式发布。包含以下修改点：

• 新增查询实例域名。
• 新增查询实例IPv6域名。
• 新增获取实例的复制状态。

2022-12-29

第四十四次正式发布。包含以下修改点：

• 新增批量查询容灾实例信息。
• 创建数据库请求消息增加“is_revoke_public_privilege”字段。
• 新增错误码DBS.200038、DBS.200039。

2022-12-19

第四十三次正式发布。包含以下修改点：

• 新增创建插件。
• 新增查询插件。
• 新增删除插件。
• 新增修改实例指定参数的值。
• 新增获取实例指定参数的值。

2022-12-15

第四十二次正式发布。包含以下修改点：

• 新增设置自动扩容策略。
• 新增查询自动扩容策略。
• 新增设置秒级监控策略。
• 新增查询秒级监控策略。
• 新增复制参数模板。
• 新增查询实例参数修改历史。
• 新增添加MSDTC。
• 新增查询MSDTC的hosts信息。

2022-09-21

第四十一次正式发布。包含以下修改点：

• 手动倒换主备请求消息增加“force”字段。
• 创建数据库用户请求消息增加“comment”字段。
• 查询数据库用户列表响应消息增加“comment”字段。
• 新增修改数据库用户的备注。

2022-07-30

第四十次正式发布。包含以下修改点：

• 支持RDS for PostgreSQL 14版本。
• 修改创建数据库实例和恢复到新实例接口中请求参数“security_group_id”的说明。

2022-06-30

第三十九次正式发布。包含以下修改点：

新增开启和关闭慢日志明文显示。

2022-04-15

第三十八次正式发布。包含以下修改点：

• 新增应用参数模板（v3.1版本）。
• 新增修改指定实例的参数（v3.1版本）。
• 新增删除数据库（SQL Server）（v3.1版本）。

2022-03-31

第三十七次正式发布。包含以下修改点：

• 新增停止实例。
• 新增开启实例。
• 原有应用参数模板接口待下线，新增应用参数模板。
• 新增错误码DBS.301132。

2022-01-28

第三十六次正式发布。包含以下修改点：

• 恢复到已有实例接口待下线。
• SQLServer支持低版本到高版本的跨版本恢复能力：恢复到新实例、恢复到已有实例。
• 单机转主备实例请求参数增加“ad_domain_info”，删除“password”。
• 迁移主备实例的备机添加支持本地盘实例的描述。

2021-11-30

第三十五次正式发布。包含以下修改点：

• MySQL原有查询错误日志和慢日志接口待下线，新增如下接口：
  • MySQL新增查询数据库错误日志（MySQL）。
  • MySQL新增查询数据库慢日志（MySQL）。
• MySQL新增升级内核小版本。

2021-11-04

第三十四次正式发布。包含以下修改点：

查询数据库实例列表响应消息增加“max_iops”和“expiration_time”字段。

2021-08-26

第三十三次正式发布。包含以下修改点：

• 创建数据库请求消息增加“comment”字段。
• 查询数据库列表响应消息增加“comment”字段。
• 授权数据库账号请求消息增加“readonly”字段。
• 新增接口修改指定实例的数据库备注。

2021-07-21

第三十二次正式发布。包含以下修改点：

• PostgreSQL支持极速云盘。
• MySQL支持修改实例备注。
• 查询数据库实例列表增加响应参数“alias”。

2021-06-22

第三十一次正式发布。包含以下修改点：

• PostgreSQL数据库实例名支持中文字符。
• MySQL支持设置Binlog本地保留时长。
• MySQL支持获取Binlog本地保留时长。
• MySQL数据库账号密码支持()和&。
• 新增查询配额。
• 新增错误码DBS.200311、DBS.280020、DBS.200037。
• 优化错误码DBS.200121。
• 删除数据库（SQL Server）增加请求参数“is_force_delete”，支持强制删除数据库。
• 查询数据库实例列表增加响应参数“complete_version”，PostgreSQL支持返回完整版本号。
• API概览增加配额管理接口说明。

2021-05-18

第三十次正式发布。包含以下修改点：

• 查询数据库规格的响应参数“groupType”支持极速型SSD。
• 查询数据库磁盘类型的响应参数“supportComputeGroupType”支持极速型SSD。
• 创建数据库实例的请求参数“volume”支持极速型SSD。
• 恢复到新实例的请求参数和响应参数“volume”支持极速型SSD。
• PostgreSQL支持设置跨区域备份策略。
• PostgreSQL支持查询跨区域备份策略。
• PostgreSQL支持查询跨区域备份列表。
• PostgreSQL支持查询跨区域备份实例列表。
• PostgreSQL支持查询跨区域备份可恢复时间段。
• PostgreSQL支持同云跨Region配置主实例容灾能力。
• PostgreSQL支持同云跨Region配置灾备实例容灾能力。
• PostgreSQL支持同云跨Region灾备实例升主。
• PostgreSQL支持同云跨Region查询容灾复制状态。

2021-05-06

第二十九次正式发布。包含以下修改点：

根据API规范优化错误码。

2021-04-19

第二十八次正式发布。包含以下修改点：

• 支持PostgreSQL 13。
• 查询数据库规格的响应参数“groupType”支持通用型和独享型。
• 查询数据库磁盘类型的响应参数“supportComputeGroupType”支持SSD云盘。
• 创建数据库实例的请求参数“volume”支持SSD云盘。
• PostgreSQL支持迁移主备实例的备机。

2021-03-22

第二十七次正式发布。包含以下修改点：

SQL Server恢复到已有实例和新实例时，数据库名支持多个。

2021-02-22

第二十六次正式发布。包含以下修改点：

• 原“重置数据库密码”章节名称修改为“重置数据库root账号密码”，并移动至管理数据库和用户（MySQL）目录下。
• SQL Server支持设置跨区域备份策略。
• SQL Server支持查询跨区域备份策略。
• SQL Server支持查询跨区域备份列表。
• SQL Server支持查询跨区域备份实例列表。
• SQL Server支持查询跨区域备份可恢复时间段。
• MySQL数据库实例名支持中文字符。
• MySQL数据库管理员密码支持$字符。
• MySQL和PostgreSQL设置可维护时间段的时间间隔支持一至四个小时。
• MySQL、PostgreSQL和SQL Server的包周期实例支持单机转主备实例。
• MySQL创建数据库实例时支持批量创建，增加请求参数“count”。
• MySQL创建数据库实例时支持参数和规格的预校验，增加请求参数“dry_run”。
• 查询数据库规格响应参数新增“groupType”。
• 查询数据库磁盘类型响应参数新增“supportComputeGroupType”。

2021-01-18

第二十五次正式发布。包含以下修改点：

• 新增V3接口申请内网域名。
• 新增V3接口修改内网域名。
• 新增V3接口设置跨区域备份策略。
• 新增V3接口查询跨区域备份策略。
• 新增V3接口查询跨区域备份列表。
• 新增V3接口查询跨区域备份实例列表。
• 新增V3接口查询跨区域备份可恢复时间段。
• V3接口创建数据库实例请求参数和响应参数新增“collation”。
• SQL Server创建实例时请求参数“password”支持$字符。
• V3接口恢复到新实例请求参数和响应参数新增“collation”和“charge_info”。
• PostgreSQL和SQL Server的包周期实例支持变更规格和扩容磁盘空间。

2020-12-15

第二十四次正式发布。包含以下修改点：

• 新增V3接口修改实例名称。
• 新增V3接口设置回收站策略。
• 新增V3接口查询数据库列表。
• 新增V3接口查询数据库用户列表。
• 新增V3接口查询数据库SCHEMA列表。
• V3接口查询数据库磁盘类型新增参数“ha_mode”。
• V3接口创建数据库请求参数新增“template”、“character_set”、“lc_collate”。
• V3接口查询数据库实例列表和获取备份列表响应参数新增“associated_with_ddm”。

2020-11-16

第二十三次正式发布。包含以下修改点：

• V3接口创建数据库实例的请求参数新增“data_vip”字段。
• 新增错误码DBS.280489和DBS.280490。
• 新增V3接口创建数据库。
• 新增V3接口创建数据库用户。
• 新增V3接口创建数据库SCHEMA。
• 新增V3接口授权数据库账号的读写权限。

2020-10-15

第二十二次正式发布。包含以下修改点：

• 新增V3接口查询数据库用户列表。
• 新增V3接口查询指定数据库的已授权用户。
• 包周期支持变更规格。

2020-09-15

第二十一次正式发布。包含以下修改点：

• 新增V3接口创建数据库用户。
• 新增V3接口删除数据库用户。
• 新增V3接口授权数据库账号。
• 新增V3接口解除数据库账号权限。
• 新增V3接口重置数据库账号密码。
• V3接口查询数据库实例列表的响应消息新增“order_id”字段。
• V3接口创建数据库实例的响请求参数新增“tags”字段。

2020-08-15

第二十次正式发布。包含以下修改点：

新增v3接口获取指定实例和时间范围的任务信息（SQL Server）。

2020-07-17

第十九次正式发布。包含以下修改点：

• 新增v3接口创建数据库。
• 新增v3接口查询数据库列表。
• 新增v3接口删除数据库（SQL Server）。

2020-05-30

第十八次正式发布。包含以下修改点：

• 新增v3接口设置可维护时间段。
• 新增v3接口修改安全组。
• 新增v3接口获取慢日志下载链接。

2020-05-13

第十七次正式发布。包含以下修改点：

• 新增v3接口设置SSL数据加密。
• 新增v3接口修改数据库端口。
• 新增v3接口修改内网地址。

2020-03-31

第十六次正式发布。包含以下修改点：

• v1 接口资料下线。
• 新增接口：切换主备实例的倒换策略。
• 新增接口：手动倒换主备。
• 新增接口：更改主备实例的数据同步方式。
• 新增接口：迁移主备实例的备机。
• 新增接口：表级时间点恢复（MySQL）。
• 新增接口：获取慢日志统计信息（MySQL）。

2020-03-06

第十五次正式发布。包含以下修改点：

• 新增接口绑定和解绑弹性公网IP。
• 新增接口重置数据库root账号密码。

2019-12-17

第十四次正式发布。包含以下修改点：

• 在接口“查询数据库实例列表”响应中新增“backup_used_space”和“storage_used_space”字段。
• 新增接口查询SQL Server可用字符集。

2019-11-30

第十三次正式发布。包含以下修改点：

• 在接口查询数据库实例列表请求中，新增tag查询条件。
• 新增接口批量添加标签。
• 新增接口批量删除标签。
• 新增接口查询项目标签。

2019-10-15

第十二次正式发布。包含以下修改点：

• 新增接口设置审计日志策略。
• 新增接口查询审计日志策略。
• 新增接口获取审计日志列表。
• 新增接口生成审计日志下载链接。

2019-09-20

第十一次正式发布。包含以下修改点：

• 在接口查询数据库规格响应消息中，新增“az_status”字段。
• 新增查询数据库磁盘类型接口。

2019-08-31

第十次正式发布。包含以下修改点：

• 完善v3接口的URI格式，增加URI样例。
• 在“使用前必读”中，增加“调用说明”、“终端节点”、“约束限制”、“API版本选择建议”等主要章节。
• 在“如何调用API”中，增加“构造请求”、“认证鉴权”和“返回结果”章节。
• 修改“模板”为“参数模板”。
• 对于白名单用户，创建MySQL主实例和只读实例，可选最大存储空间调整为6000GB，可扩容最大存储容量为10000GB。

2019-08-13

第九次正式发布。包含以下修改点：

新增3个v1接口：创建标签、查询标签、删除标签。

2019-07-03

第八次正式发布。包含以下修改点：

在接口查询可恢复时间段中新增date字段。

2019-05-06

第七次正式发布。包含以下修改点：

在修改MySQL参数相关场景中，增加修改敏感参数的注意事项。

2019-03-30

第六次正式发布。包含以下修改点：

• 获取任务信息中新增实例磁盘空间满的状态“STORAGE FULL”。

2019-02-15

第五次正式发布。包含以下修改点：

• 新增v3接口重启数据库实例。
• 新增v3接口查询数据库错误日志。
• 将v1和v3接口按章节进行分类。

2018-11-20

第四次正式发布。包含以下修改点：

• 新增v3接口获取参数模板列表。
• 新增v3接口获取指定实例的参数模板。
• 新增v3接口获取指定参数模板的参数。
• 新增v3接口创建参数模板。
• 新增v3接口应用参数模板
• 新增v3接口修改参数模板参数。
• 新增v3接口修改指定实例的参数。
• 新增v3接口删除参数模板。
• 新增v3接口查询可恢复时间段。
• 修改恢复到新实例。
• 修改恢复到已有实例。
• 修改创建数据库实例。
• 新增AK/SK鉴权方式。
• 新增错误码：DBS.200203、DBS.200506和DBS.212032。

2018-09-30

第三次正式发布。包含以下修改点：

• 新增v3接口创建数据库实例。
• 新增v3接口删除数据库实例。
• 新增v3接口查询数据库实例列表。
• 新增v3接口获取任务信息。
• 新增v3接口设置自动备份策略。
• 新增v3接口查询自动备份策略。
• 新增v3接口创建手动备份。
• 新增v3接口创建手动备份。
• 新增v3接口获取备份列表。
• 新增v3接口删除手动备份。
• 新增v3接口恢复到新实例。
• 新增v3接口恢复到已有实例。
• 新增v3错误码。
• 新增v3异常请求结果。

2018-06-15

第二次正式发布。包含以下修改点：

• 修改参数“keepDays”的取值范围。
• 修改参数“keepday”的取值范围。

2018-05-04

第一次正式发布。