修改 DescribeBackupPolicy

2025-10-13

• 新增返回参数 DataIncrBackupPeriods，用于描述备份方式为正常增量时的备份频率，并提示实例未开启增量备份时则不返回该字段。
• 新增返回参数 HourlyIncrBackupEnable，用于描述是否开启高频备份功能。
• 修改返回参数 IncrementBackupFrequency 的描述，新增高频增量备份频率取值 12，并说明该参数仅在 HourlyIncrBackupEnable 取值为 true 时生效。

备份与恢复

修改 ModifyBackupPolicy

• 在 FullBackupPeriod 参数的提示信息中新增说明：每周至少选择一天进行全量备份。
• 新增参数 DataIncrBackupPeriods：用于设置增量备份的方式为正常增量时的备份频率，取值不能与全量备份的周期重叠，且每周最多可选择六天进行增量备份。
• 新增参数 HourlyIncrBackupEnable：用于控制是否开启高频备份功能。
• 修改 IncrementBackupFrequency 参数的描述：新增取值 12，并说明该参数仅在 HourlyIncrBackupEnable 取值为 true 时生效。

修改 DescribeDBInstances

2025-10-14

• 在 DescribeDBInstances 接口的 Body 参数中新增了 StorageType 参数，用于指定实例存储类型，取固定值 LocalSSD（本地 SSD 盘）。
• 在 AddressObject 结构中新增了 CrossRegionDomain 参数，用于表示可跨地域访问的私网地址，当无此地址时则不返回该字段。
• 在 AddressObject 结构中新增了 DomainVisibilitySetting 参数，用于表示私网地址类型，取值为 LocalDomain（本地域域名）或 CrossRegionDomain（可跨地域访问域名）。

实例管理

修改 DescribeDBInstanceDetail

• 在 AddressObject 中新增了 CrossRegionDomain 参数，用于描述可跨地域访问的私网地址。
• 在 AddressObject 中新增了 DomainVisibilitySetting 参数，用于描述私网地址类型，包括本地域域名和可跨地域访问域名。

修改 DescribeDBInstanceSpecs

2025-10-13

• 新增 StorageType 请求参数，用于指定实例存储类型，取固定值 LocalSSD（本地 SSD 盘）。
• 在返回参数 InstanceSpecObject 中新增 StorageType 字段，用于返回实例存储类型信息，取固定值 LocalSSD（本地 SSD 盘）。

修改 ModifyDBInstanceSpec

• 新增 EstimateOnly 参数，用于发起变配评估，当取值为 true 时，会返回 EstimationResult 参数说明此次变配的影响。
• 在返回参数中新增 EstimationResult 字段，用于描述按照当前配置变更后预估会对实例产生的影响。
• 在返回参数中对 OrderId 字段添加说明，当 EstimateOnly 取值为 true 时，该字段的返回值为空。
• 新增 ModifyDBInstanceSpecEstimationResult 对象，包含 Plans 和 Effects 字段，分别描述变更后对实例的影响和读写连接的影响。

新增 DescribeDBInstanceSSL

新增 DescribeDBInstanceSSL 接口，用于查询指定实例的 SSL 设置。该接口支持查询以下信息：

• 受保护地址
• 强制加密状态
• SSL 证书有效性
• SSL 功能开启状态
• SSL 证书到期时间
• 支持的 TLS 版本

数据安全

新增 ModifyDBInstanceSSL

新增 ModifyDBInstanceSSL 接口，用于修改指定实例的 SSL 配置。该接口支持以下功能：

• 开启或关闭 SSL 加密功能（通过 SSLEnable 参数）
• 更新 SSL 证书有效期（通过 ReloadSSLCertificate 参数）
• 开启或关闭 SSL 强制加密功能（通过 ForceEncryption 参数）

修改 DescribeAllowLists

• 新增请求参数 AllowListCategory，用于指定白名单分类，取值包括 Ordinary（普通白名单）和 Default（默认白名单），默认值为 Ordinary。
• 新增请求参数 AllowListDesc，用于通过描述信息模糊搜索白名单。
• 新增请求参数 AllowListId，用于指定白名单 ID 进行查询。
• 新增请求参数 AllowListName，用于指定白名单名称进行查询。
• 新增请求参数 IPAddress，支持按 IP 地址查询白名单，多个 IP 地址可用英文逗号分隔。
• 新增请求参数 PageNumber，用于指定当前页页码，默认值为 1。
• 新增请求参数 PageSize，用于指定每页记录数，无默认值。
• 新增返回参数 Total，表示白名单的总数。
• 在 AllowListObject 中新增字段 AllowListCategory，表示白名单分类。
• 在 AllowListObject 中新增字段 SecurityGroupBindInfos，表示白名单绑定的安全组信息，包含安全组 ID、名称、IP 列表和关联模式等信息。
• 新增数据结构 SecurityGroupBindInfo，用于描述安全组绑定信息，包括 IpList、BindMode、SecurityGroupId 和 SecurityGroupName 等字段。

-

修改 DescribeAllowListDetail

• 新增返回参数 AllowListCategory，用于标识白名单分类，取值包括 Ordinary（普通白名单）和 Default（默认白名单），默认值为 Ordinary。
• 新增返回参数 SecurityGroupBindInfos，用于描述该白名单绑定的安全组列表，包含安全组中的 IP、关联安全组的模式、安全组 ID 和安全组名称等信息。
• 新增返回参数 UserAllowList，用于描述安全组之外的、需要加入白名单的 IP 地址或 CIDR 格式的 IP 地址段。

修改 CreateAllowList

• AllowList 参数由必选改为可选，并新增提示信息：该字段不能与 UserAllowList 字段同时使用。
• 新增 AllowListCategory 参数，用于指定白名单分类，可选值为 Ordinary（普通白名单）和 Default（默认白名单），默认值为 Ordinary。
• 新增 SecurityGroupBindInfos 参数，用于为白名单绑定安全组信息，包含 IpList、BindMode、SecurityGroupId 和 SecurityGroupName 子参数。
• 新增 UserAllowList 参数，用于指定安全组之外需要加入白名单的 IP 地址，该字段不能与 AllowList 字段同时使用。
• 新增 SecurityGroupBindInfo 数据结构，包含 IpList、BindMode、SecurityGroupId 和 SecurityGroupName 字段。

创建白名单

修改 ModifyAllowList

• 在 ModifyMode 参数描述中新增了警告信息：如需修改的白名单绑定有安全组，或需要在修改白名单时为白名单绑定安全组，则 ModifyMode 只能取值为 Cover。
• 新增了 AllowListCategory 参数，用于指定白名单分类，取值为 Ordinary（普通白名单）或 Default（默认白名单），默认值为 Ordinary。
• 新增了 SecurityGroupBindInfos 参数，用于为白名单绑定安全组的信息，包含 IpList、BindMode、SecurityGroupId 和 SecurityGroupName 字段。
• 新增了 UpdateSecurityGroup 参数，用于控制是否更新白名单所绑定的安全组，取值为 true（更新）或 false（不更新），默认值为 false。
• 新增了 UserAllowList 参数，用于指定安全组之外的、需要加入白名单的 IP 地址，支持 IP 地址或 CIDR 格式的 IP 地址段。
• 新增了 SecurityGroupBindInfo 结构体，用于描述安全组绑定信息，包含 IpList、BindMode、SecurityGroupId 和 SecurityGroupName 字段。

修改白名单

修改 CreateBackup

• 新增请求参数 BackupScope、BackupMethod、BackupDescription、BackupMeta。
• 新增返回参数 BackupId。

创建数据备份

修改 DescribeBackups

• 新增请求参数 DownloadStatus、BackupMethod、BackupDatabaseName、BackupDescription、CreateType 和BackupScope。
• 新增返回参数 BackupId。

-

新增 公共结构体 - BackupMetaObject

新增结构体。

• CreateBackup
• DescribeBackups

修改 公共结构体 - BackupObject

• 新增参数 BackupDataSize、BackupDescription、BackupMeta、BackupMethod、BackupScope 和 DownloadStatus。
• 更新参数 BackupStatus、BackupType 和 CreateType 的取值范围。

• DescribeBackups

修改 ModifyDBEndpointReadWriteFlag

• 更新请求参数 ReadOnlyNodeMaxDelayTime 和 ReadOnlyNodeDistributionType 的描述信息。
• 新增请求参数 ReadWriteProxyConnection 和 WriteNodeHaltWriting。

修改 公共结构体 - ChargeInfoObject

更新参数 Number 的取值范围。

• CreateDBInstance
• DescribeDBInstancePriceDetail
• DescribeDBInstancePriceDifference
• RestoreToNewInstance

修改 公共结构体 - EndpointObject

新增参数 ReadWriteProxyConnection 和 WriteNodeHaltWriting。

• DescribeDBInstances
• DescribeDBInstanceDetail

修改 公共结构体 - InstanceInfoObject

• 更新参数 DBEngineVersion 的取值范围，增加 PostgreSQL_17 。
• 新增参数 Endpoints。

• DescribeBackups
• DescribeDetachedBackups

修改 公共结构体 - SchemaObject

更新参数 Owner 的描述信息。增加被禁用了 DDL 权限的高权限账号或被禁用了 DDL 权限的普通账号不能作为 Schema Owner 的信息。

• DescribeSchemas
• ModifySchemaOwner

修改 DescribeDBInstanceParameters

• 更新请求参数 ParameterName 的示例值。
• 更新接口的返回示例。
• 返回参数 Parameters 数据结构中新增 DescriptionZH 字段。

修改 DescribeSlots

• 新增请求参数 IPAddress。
• 返回参数 ReplicationSlots 数据结构中新增字段 IPAddress。

查看复制槽列表

修改 DescribeDBInstances

• 为接口增加注意事项。
• 更新请求参数 DBEngineVersion 的取值范围，增加 PostgreSQL_15 和 PostgreSQL_16。

-

修改 DescribeDBInstanceSpecs

• 为接口增加注意事项。
• 更新请求参数 DBEngineVersion 的取值范围，增加 PostgreSQL_15 和 PostgreSQL_16。

修改 ModifyDBEndpointAddress

为接口增加注意事项。

• 修改私网端口
• 修改私网地址前缀

修改 DescribeDBInstanceParameters

• 更新请求参数 ParameterName 的描述信息。
• 更新返回参数 DBEngineVersion 的取值范围，增加 PostgreSQL_15 和 PostgreSQL_16。

-

修改 DescribeBackups

• 更新请求参数 BackupId、BackupStartTime、BackupEndTime、BackupStatus、BackupType 的描述信息。
• 更新返回参数 DBEngineVersion 的取值范围，增加 PostgreSQL_15 和 PostgreSQL_16。

-

修改 ModifyDBEndpointAddress

2024-06-20

更新接口，增加使用限制。

• 修改私网地址前缀
• 修改私网端口