文档中心

云数据库 MySQL 版

V2（2022-01-01）

SDK 发布历史

2026 年 06 月

发布 Python（v5.0.36）、GO（v1.2.37）、Java（v2.0.14）三个版本的 SDK。本次发布涉及的更新如下：

变更类型	API	变更记录
修改	CreateDBInstance	新增可选的请求参数 AutoUpgradeMinorVersion。更新请求参数 DBEngineVersion 的描述信息。更新返回参数 DBEngineVersion 的描述信息。
修改	DescribeDBInstances	更新请求参数 DBEngineVersion 的描述信息。更新返回参数 DBEngineVersion 的描述信息。
修改	DescribeDBInstanceDetail	更新返回参数 DBEngineVersion 的描述信息。
修改	DescribeDBInstanceAttribute	更新返回参数 DBEngineVersion 的描述信息。
修改	DescribeDBInstanceSpecs	更新请求参数 DBEngineVersion 的描述信息。更新返回参数 DBEngineVersion 的描述信息。
修改	RestoreToCrossRegionInstance	新增可选的请求参数 AutoUpgradeMinorVersion。
修改	DescribeDBInstanceParameters	新增返回参数 TemplateId、TemplateName 和 TemplateSource。
修改	DescribeDBInstanceParametersLog	新增返回参数 TemplateId、TemplateName 和 TemplateSource。
修改	ModifyDBInstanceChargeType	更新请求参数 InstanceId 的描述信息（补充最多可填写 20 个实例 ID 的限制内容）。
修改	DeleteDBNodes	更新请求参数 DBNodeIds 的描述信息（新增说明内容第一条）。更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	ModifyDBInstanceType	更新请求参数 TypeConvertPath 的描述信息（新增 SingleToDouble 取值：单节点实例类型转换为双节点实例）。更新请求参数 NodeInfoObject 结构体中 NodeOperateType 参数的描述信息（新增说明内容第三条）。
修改	UpgradeDBInstanceEngineMinorVersion	更新请求参数 SpecifiedSwitchStartTime 的描述信息（新增说明内容第二条）。更新请求参数 SpecifiedSwitchEndTime 的描述信息（新增说明内容第三条）。
修改	CreateDrDBInstance	新增调用接口创建灾备实例的注意事项。新增可选的请求参数 AutoUpgradeMinorVersion。
修改	UpgradeDBInstanceEngineMajorVersionPrecheck	更新请求参数 TargetMajorVersion 的示例值和描述信息（8.0.32 > 8.0.43）。更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	DescribeUpgradeEngineMajorVersionPrecheckResult	更新返回参数 TargetMajorVersion 的示例值和描述信息（8.0.32 > 8.0.43）。
修改	StopDBInstance	新增调用接口暂停实例的注意事项。
修改	DescribeDBInstanceNodes	更新返回参数 NodeStatus 的描述信息（新增取值 InOperation：运维锁定中）。更新返回参数 SpaceUsedPercentage 的描述信息（新增说明内容）。
修改	CreateDBBlueGreenInstance	新增调用接口创建蓝绿实例的注意事项。新增可选的请求参数 AutoUpgradeMinorVersion。更新请求参数 InstanceName 的描述信息（新增说明内容）。更新请求参数 DBParamGroupId 的描述信息（新增说明内容）。更新请求参数 ProxyNodeCustom 的描述信息（新增说明内容第二、三条）。
修改	SwitchDBPrecheckBlueGreen	更新接口的请求类型（同步请求 > 异步请求）。
修改	DeleteDBBlueGreenRelation	更新接口的请求类型（同步请求 > 异步请求）。
修改	CreateDBEndpoint	更新调用接口的注意事项（新增：多节点实例仅支持创建 3 个自定义读写直连终端）。更新请求参数 ConnectionPoolType、ReadWriteSpliting、ReadOnlyNodeDistributionType、ReadOnlyNodeWeight、ReadOnlyNodeMaxDelayTime、MultiStatementsMode、OverloadProtection、MasterProtectorTimeout、MasterNodeRouting、ImplicitTransSplit 和EnableConnectionPersistent 参数的描述信息（新增说明内容）。
修改	ModifyDBEndpoint	新增调用接口的注意事项。更新请求参数 Description 的描述信息（补充字段长度限制）。
修改	DescribeDBProxyConfig	更新返回参数 DBProxyStatus 的描述信息（新增取值 Updating：代理变更中）。
修改	DeleteDBEndpoint	更新调用接口的注意事项。
修改	ModifyReadOnlyNodeDelayReplicationTime	更新调用接口的注意事项（新增注意事项第二条）。
修改	ModifyDBProxy	更新调用接口的注意事项（新增注意事项第四条）。更新请求参数 EnableDBProxy 的必填属性（选填 > 必填）。
修改	ModifyDBProxySpec	更新调用接口的注意事项（新增注意事项第二条）。更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	AddDiagnosticsEntity	更新请求参数 EcsInstanceIds 和 PublicIpAddresses 的描述信息（新增说明内容第二条）。
修改	CreateBackup	更新调用接口的注意事项。更新请求参数 BackupMethod、BackupType 和 BackupMeta 的描述信息。
修改	RestoreToNewInstance	更新调用接口的注意事项。新增可选的请求参数 AutoUpgradeMinorVersion。
修改	RestoreToExistedInstance	新增调用接口的注意事项。
修改	DeleteDataBackup	新增调用接口的注意事项。
修改	DescribeResourcePackageDetail	更新请求参数 QueryStartTime 的描述信息（新增说明内容）。
修改	CreateResourcePackage	新增调用接口的注意事项。更新请求参数 PeriodUnit 和 Period 的必填属性（选填 > 必填）。
修改	ListResourcePackages	更新请求参数 PageSize 和 OrderBy 的描述信息。
修改	ModifyDBInstanceSpec	更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	ModifyDBNodeTemporarySpec	更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	ModifyDBNodeSpec	更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	CreateDBNodes	更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	MigrateToOtherZone	更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	RestartDBInstance	更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	SwitchDBBlueGreen	更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	ModifyDBProxySpec	更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	ModifyDBInstanceSSL	更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。
修改	ModifyDBInstanceTDE	更新请求参数 SwitchType、SpecifiedSwitchStartTime和SpecifiedSwitchEndTime 的描述信息。

2026 年 03 月

发布 Python（v5.0.19）、GO（v1.2.21）、Java（v1.0.16）三个版本的 SDK。本次发布涉及的更新如下：

变更类型	API	变更记录
新增	DescribeNonWhiteSessionList	新增接口。
新增	CleanNonWhiteSession	新增接口。
新增	RebuildDBGreenInstance	新增接口。
修改	CreateDBInstance	新增可选的请求参数 PrivateIpAddress。
修改	RebuildDBInstance	新增可选的请求参数 PrivateIpAddress。
修改	CreateDrDBInstance	新增可选的请求参数 PrivateIpAddress。
修改	CreateDBBlueGreenInstance	新增可选的请求参数 PrivateIpAddress。
修改	RestoreToNewInstance	新增可选的请求参数 PrivateIpAddress。
修改	RestoreToCrossRegionInstance	新增可选的请求参数 PrivateIpAddress。
修改	DescribeDBInstanceHAConfig	新增返回参数 AutoStorageScalingConfig。
修改	CreateDBAccount	新增可选的请求参数 AuthenticationType。
修改	DescribeAllowLists	更新请求参数 DescribeAllowLists 描述信息。
修改	DescribeAllowListDetail	新增返回参数 ProjectName。
修改	DescribeBackupPolicy	新增返回参数 LockDDLTimeSecond。
修改	ModifyBackupPolicy	新增请求参数 LockDDLTimeSecond。新增返回参数 LockDDLTimeSecond。更新请求参数 LockDDLTime 的描述信息。
修改	ModifyDBInstanceParameters	新增请求参数 TemplateId。
修改	SaveAsParameterTemplate	新增请求参数 ProjectName。新增返回参数 TemplateId。
新增	公共结构体 - AutoStorageScalingConfigObject	新增结构体。
修改	公共结构体 - AccountObject	新增参数 AuthenticationType。
修改	公共结构体 - TemplateInfoObject	新增参数 ProjectName。
修改	公共结构体 - AllowListObject	新增参数 ProjectName。

2025 年 12 月

发布 Python（v4.0.42）、GO（v1.1.54）、Java（v0.2.53）三个版本的 SDK。本次发布涉及的更新如下：

变更类型	API	变更记录
修改	CreateDBInstance	更新请求参数 StorageSpace 的描述信息（GB > GiB）。新增请求参数 EnableExternalReplication 和 EngineType。
修改	DescribeDBInstances	新增请求参数 EngineType。
修改	DescribeResourceUsage	更新返回参数 BackupFreeQuotaSize、BackupUse、StorageSpace 和 StorageUse 的描述信息（GB > GiB）。
修改	DescribeDBInstancePriceDetail	更新返回参数 BackupFreeQuotaSize、BackupUse、StorageSpace 和 StorageUse 的描述信息（GB > GiB）。
修改	ModifyDBNodeSpec	更新返回参数 BackupFreeQuotaSize、BackupUse、StorageSpace 和 StorageUse 的描述信息（GB > GiB）。
修改	ModifyDBInstanceType	新增注意事项内容：将单节点实例变更为双节点实例。
修改	RestartDBInstance	新增请求参数 RestartWithProxy。
修改	RebuildDBInstance	更新请求参数 StorageSpace 的描述信息（GB > GiB）。
修改	CreateDrDBInstance	更新请求参数 StorageSpace 的描述信息（GB > GiB）。
修改	CreateDBAccount	更新请求参数 AccountPassword 的描述信息（更新特殊符号）。更新请求参数 DryRun 的描述信息（新增说明内容第二条）。
修改	ResetDBAccount	更新请求参数 AccountPassword 的描述信息（更新特殊符号）。
修改	GrantDBAccountPrivilege	更新请求参数 DryRun 的描述信息（新增说明内容第二条）。
修改	DeleteDatabase	新增请求参数 KeepAccountPrivileges。
修改	DescribeAllowLists	更新请求参数 RegionId 的描述信息（新增部分说明内容）。
修改	DescribeAllowListDetail	新增返回参数 ProjectName。更新返回参数 SecurityGroupBindInfos 的描述信息（新增说明内容）。
修改	DescribeBackups	更新请求参数 StorageSpace 的描述信息（GB > GiB）。新增请求参数 EnableExternalReplication。
修改	DescribeRecoverableTime	更新返回参数 RecoverableTimeInfo 的描述信息（+0800 > UTC 时间）。
修改	DescribeBackupPolicy	更新返回参数 BinlogSpaceLimitEnable 的描述信息（GB > GiB）。更新返回参数 DataKeepDaysAfterReleased 的描述信息（删除"当前仅支持取值为 `7`。"的相关内容）。更新返回参数 LockDDLTime 的描述信息（删除说明内容）。新增返回参数 LockDDLTimeSecond。
修改	ModifyBackupPolicy	更新请求参数 BinlogSpaceLimitEnable 的描述信息（GB > GiB）。更新请求参数 LockDDLTime 的描述信息（删除说明内容）。新增请求参数 LockDDLTimeSecond。更新返回参数 BinlogSpaceLimitEnable 的描述信息（GB > GiB）。更新返回参数 DataKeepDaysAfterReleased 的描述信息（删除"当前仅支持取值为 `7`。"的相关内容）。新增返回参数 LockDDLTimeSecond。
修改	RestoreToCrossRegionInstance	更新请求参数 NodeInfo 的描述信息（“实例规格配置”修改为”实例的节点配置“，删除“主节点和备节点有且只有 1 个，只读节点可选 0~10个。更新请求参数 StorageSpace 的描述信息（GB > GiB）。
修改	DescribeCrossRegionBackupDBInstances	更新请求参数 EnableAfterTime 的描述信息。更新请求参数 EnableBeforeTime 的描述信息。
修改	ModifyDBInstanceParameters	更新请求参数 TemplateId 的描述信息。新增请求参数 TemplateId 的示例值。
修改	CreateParameterTemplate	新增请求参数 EngineType。
修改	ListParameterTemplates	新增请求参数 EngineType。
修改	SaveAsParameterTemplate	新增请求参数 ProjectName。变更返回参数显示状态（隐藏 > 显示）。
修改	CreateResourcePackage	更新请求参数 EffectiveTime 的描述信息（添加格式内容）。
修改	公共结构体 - InstanceInfoObject	更新参数 StorageSpace 的描述信息（GB > GiB）。新增参数 EngineType。
修改	公共结构体 - DBInstanceAttribute	更新参数 Memory 的描述信息（GB > GiB）。更新参数 StorageSpace 的描述信息（GB > GiB）。新增参数 EngineType。
修改	公共结构体 - AutoStorageScalingConfigObject	更新参数 StorageUpperBound 的描述信息（GB > GiB）。
修改	公共结构体 - NodeDetailInfoObject	更新参数 Memory 的描述信息（GB > GiB）。
修改	公共结构体 - InstanceSpecsInfoObject	更新参数 Memory、StorageMax、StorageMin 和 StorageStep 的描述信息（GB > GiB）。
修改	公共结构体 - AutoStorageScalingConfig	更新请求参数 StorageUpperBound 的描述信息（GB > GiB）。
修改	公共结构体 - ChargeItemPriceObject	更新参数 ChargeItemValue 的描述信息（GB > GiB）。
修改	公共结构体 - NodeDetailInfoObject	更新参数 Memory 的描述信息（GB > GiB）。更新参数 UpdateTime 的描述信息（新增时间格式）。
修改	公共结构体 - AllowListObject	更新参数 ProjectName 的示例值（空 > default）和描述信息（新增说明内容）。更新参数 SecurityGroupBindInfos 的描述信息（新增说明内容）。
修改	公共结构体 - BackupObject	新增参数 EngineType。
修改	公共结构体 - RecoverableTimeInfoObject	更新参数 EarliestRecoverableTime 的描述信息（+0800 > UTC 时间，添加格式内容）。更新参数 LatestRecoverableTime 的描述信息（+0800 > UTC 时间，添加格式内容）。
修改	公共结构体 - UsageStat	更新参数 StatTime 的描述信息（添加格式内容）。
修改	公共结构体 - DeletedDBInstanceInfo	更新参数 BackupExpirationTime 的描述信息（添加格式内容）。更新参数 DeletionTime 的描述信息（添加格式内容）。更新参数 StorageSpace 的描述信息（GB > GiB）。
修改	公共结构体 - ParameterTemplateInfo	更新参数 CreateTime 的描述信息（添加格式内容）。更新参数 ProjectName 的描述信息（添加说明内容）。新增请求参数 EngineType。
修改	公共结构体 - TaskInfoObject	更新参数 CreateTime 的描述信息（添加格式内容）。更新参数 FinishTime 的描述信息（添加格式内容）。

2025 年 09 月

发布 Python（v4.0.21）、GO（v 1.1.35）、Java（v0.2.35）三个版本的 SDK。本次发布涉及的更新如下：

变更类型	API	变更记录
新增	DescribeDBInstanceAttribute	新增接口。
新增	DescribeDBInstanceEndpoints	新增接口。
新增	DescribeResourceUsage	新增接口。
新增	DescribeDBInstanceChargeDetail	新增接口。
新增	DescribeDBInstanceHAConfig	新增接口。
新增	DescribeDBProxy	新增接口。
新增	DescribeDBDisasterRecoveryInstances	新增接口。
新增	StopDBInstance	新增接口。
新增	StartDBInstance	新增接口。
新增	ModifyBackupName	新增 ModifyBackupName 接口，用于修改数据备份的名称。该接口包含以下必填参数： InstanceId：实例ID BackupId：数据备份的ID BackupName：备份名称，命名规则如下：不能以中划线（-）开头只能包含中文、字母、数字、下划线（_）和中划线（-）长度需要在1~128个字符之间
修改	CreateDBInstance	InstanceType 参数新增 SingleNode 单节点类型选项，并补充了关于蓝色实例与绿色实例类型选择的说明。 StorageType 参数新增说明：当 InstanceType 取值为 SingleNode 时，StorageType 取值只能为 CloudESSD_FlexPL 或 CloudESSD_PL0。 NodeInfoObject 中的 NodeSpec 参数新增说明：如 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0，NodeSpec 只能传入通用规格。 ProxyNodeCustom 参数说明中补充了 SingleNode 类型不生效的情况。
修改	DescribeDBInstances	StorageType 参数新增了限制条件：当 InstanceType 取值为 SingleNode 时，StorageType 取值只能为 CloudESSD_FlexPL 或 CloudESSD_PL0。 InstanceType 参数新增了取值 SingleNode（单节点类型），并补充了实例类型选择的提示信息。 AddressObject 新增了参数 EipLocked，用于表示连接终端使用的 EIP 是否因欠费关停。
修改	DescribeDBInstanceSpecs	InstanceType 参数新增了 SingleNode（单节点类型）选项，并补充了关于蓝色实例与绿色实例实例类型选择的说明。 StorageType 参数新增了限制条件：当 InstanceType 取值为 SingleNode 时，StorageType 取值只能为 CloudESSD_FlexPL 或 CloudESSD_PL0。从 StorageType 参数的接口限制中移除了 CreateDBBlueGreenInstance 接口的说明。
修改	DescribeDBInstancePriceDetail	StorageType 参数新增了取值范围：CloudESSD_FlexPL（FlexPL 云盘）和 CloudESSD_PL0（PL0 云盘），并详细说明了在不同接口中该参数的取值规则。新增返回参数 HidePriceInfo，用于控制是否隐藏价格信息。当设置为 true 时，价格信息将以 *** 代替显示。 StorageType 参数新增了限制条件：当 InstanceType 取值为 SingleNode 时，StorageType 取值只能为 CloudESSD_FlexPL 或 CloudESSD_PL0。 NodeSpec 参数新增了限制条件：如 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0，NodeSpec 只能传入通用规格。移除了 CreateDBBlueGreenInstance 接口在 StorageType 参数中的限制说明。
修改	ModifyDBNodeTemporarySpec	在 NodeInfoObject 的 NodeSpec 参数描述中新增了提示内容：如 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0，NodeSpec 只能传入通用规格。
修改	ModifyDBNodeSpec	StorageType 参数新增了取值范围：CloudESSD_FlexPL 和 CloudESSD_PL0，并详细说明了在不同接口中的使用限制和变更规则。 StorageType 参数的描述从简单的 "实例存储类型。取值为 LocalSSD，表示本地 SSD 盘。" 扩展为包含多种存储类型和详细使用规则的说明。 StorageType 参数新增了限制说明：当 InstanceType 取值为 SingleNode 时，StorageType 取值只能为 CloudESSD_FlexPL 或 CloudESSD_PL0。 NodeSpec 参数新增了限制说明：如 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0，NodeSpec 只能传入通用规格。
修改	CreateDBNodes	NodeSpec 参数新增了限制说明：如 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0，NodeSpec 只能传入通用规格。
修改	MigrateToOtherZone	NodeSpec 参数的描述中新增了关于存储类型的限制说明：当 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0 时，NodeSpec 只能传入通用规格。
修改	RestartDBInstance	新增 ForceRestartMaster 参数，用于控制是否进行强制重启。当实例为单节点实例时，该参数必须设置为 true。
修改	RebuildDBInstance	StorageType 参数描述更新，新增了取值范围 CloudESSD_FlexPL 和 CloudESSD_PL0，并详细说明了在不同接口中的使用规则。 StorageType 参数新增了限制条件：当 InstanceType 取值为 SingleNode 时，StorageType 取值只能为 CloudESSD_FlexPL 或 CloudESSD_PL0。 NodeSpec 参数新增了限制条件：如 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0，NodeSpec 只能传入通用规格。
修改	DeleteDBInstance	新增 KeepCrossBackupEnableAfterReleased 参数，用于控制是否保留跨地域备份，取值为 true 或 false，云盘实例暂不支持该功能。 DataKeepDays 参数描述中新增取值范围说明，明确取值范围为 7~3650 天，默认为 7 天。
修改	UpgradeDBInstanceEngineMinorVersion	新增 ObservationHours 参数，用于设定实例升级后的观测时长，支持设置为 0~72 之间的整数值，单位为小时，默认值为 0。移除了返回参数 PreparedMinutes 的描述中关于 EstimateOnly 取值影响的说明。
修改	CreateDrDBInstance	新增 StorageType 参数，用于指定实例的存储类型，可选值为 LocalSSD（本地盘）、CloudESSD_FlexPL（FlexPL 云盘）或 CloudESSD_PL0（PL0 云盘）。该参数在设定 StorageSpace 时为必传，且在不同接口中有不同的取值范围和使用限制。移除 AutoStorageScalingConfig 参数，不再支持实例的自动扩容配置功能。在 NodeInfoObject 的 NodeSpec 参数描述中新增关于 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0 时的限制说明，此时 NodeSpec 只能传入通用规格。
修改	DescribeDBProxyPriceDetail	新增返回参数 HidePriceInfo，用于控制是否隐藏价格信息。当设置为 true 时，价格信息将以 *** 替代具体数值。在 ChargeItemPriceObject 的 ChargeItemType 参数中新增了 StoragePackage 计费项类型，用于表示存储包。在 ChargeItemPriceObject 的 ChargeItemValue 参数描述中新增了对 StoragePackage 类型的说明，表示资源包的大小，单位为 GB。
修改	CreateDBEndpoint	新增 CustomRouteStrategy 参数，用于设置连接终端的 SQL 转发规则。在 ConnectionPoolType 参数的描述中新增提示：单节点实例不支持该功能。在 ReadOnlyNodeDistributionType 参数的描述中新增提示：单节点实例不支持该功能。在 MultiStatementsMode 参数的描述中新增提示：单节点实例不支持该功能。
修改	ModifyDBEndpoint	新增 CustomRouteStrategy 参数，用于自定义路由转发规则，包含 KeywordRouteStrategy 子参数，支持设置 SQL 转发规则的关键字和目标节点。在 AutoAddNewNodes 参数的提示信息中新增说明：单节点实例不支持该功能。在 ReadWriteSpliting 参数的提示信息中新增说明：单节点实例不支持该功能。在 ReadOnlyNodeDistributionType 参数的提示信息中新增说明：单节点实例不支持该功能。在 IdleConnectionReclaim 参数的提示信息中新增说明：单节点实例不支持该功能。在 ConnectionPoolType 参数的提示信息中新增说明：单节点实例不支持该功能。在 MultiStatementsMode 参数的提示信息中新增说明：单节点实例不支持该功能。在 OverloadProtection 参数的提示信息中新增说明：单节点实例不支持该功能。在 MasterNodeRouting 参数的提示信息中新增说明：单节点实例不支持该功能。
修改	ModifyDBEndpointConnectionMode	新增 CustomRouteStrategy 参数，用于设置连接终端的 SQL 转发规则。新增 KeywordRouteStrategy 参数，用于定义 SQL 转发规则的具体配置，包括转发目标和关键字设置。
修改	CreateBackup	BackupMethod 参数的描述进行了修改，新增了对实例存储类型为云盘时仅支持快照备份 Snapshot 的说明，并区分了本地盘和云盘支持的备份类型。 BackupType 参数的描述进行了修改，新增了对备份类型为快照备份 Snapshot 时备份方式只能选择为 Full 的说明，并进一步明确了不同备份类型对应的备份方式。新增 BackupName 参数，用于设置备份的名称。命名规则如下：不能以中划线（-）开头。只能包含中文、字母、数字、下划线（_）和中划线（-）。长度需要在 1~128 个字符之间。如不设置，则采用备份 ID 作为备份名称。
修改	DescribeBackups	BackupMethod 参数新增了 Snapshot 取值，表示快照备份类型。 BackupObject 中的 BackupMethod 参数同样新增了 Snapshot 取值，与请求参数保持一致。新增 BackupName 请求参数，用于查询指定名称的备份。在返回参数 BackupObject 中新增 BackupName 字段，用于返回备份的名称。
修改	RestoreToNewInstance	StorageType 参数新增了取值范围：CloudESSD_FlexPL 和 CloudESSD_PL0，并详细说明了在不同接口中该参数的取值范围限制。 StorageType 参数新增了关于存储类型变更的规则说明，包括原实例存储类型为 LocalSSD 或 CloudESSD_FlexPL 时的不支持变更情况，以及原实例存储类型为 CloudESSD_PL0 时的可变更选项。 StorageType 参数的描述中新增了关于 InstanceType 取值为 SingleNode 时的限制说明：当 InstanceType 取值为 SingleNode 时，StorageType 取值只能为 CloudESSD_FlexPL 或 CloudESSD_PL0。 NodeSpec 参数的描述中新增了关于 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0 时的限制说明：如 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0，NodeSpec 只能传入通用规格。
修改	DescribeBackupPolicy	新增 HighFrequencySnapshotBackupEnable 参数，用于控制云盘实例的高频增量快照备份功能的开启状态。新增 HighFrequencySnapshotBackupSecondPeriod 参数，用于设置高频增量快照备份的频率，单位为秒。 DataBackupEncryptionEnabled 参数的描述新增了提示信息："云盘实例暂不支持此功能"。 DataBackupRetentionDay 参数的描述进行了扩展，区分了本地盘实例和云盘实例的备份保留天数范围：本地盘实例为 7~3650 天，云盘实例当前仅支持保留 7 天。 DataIncrBackupPeriods 参数的描述新增了"本地盘实例"的说明。 HourlyIncrBackupEnable 参数的描述新增了"本地盘实例"的说明。 IncrBackupHourPeriod 参数的描述新增了"本地盘实例"的说明。 LogBackupRetentionDay 参数的描述进行了扩展，区分了本地盘实例和云盘实例的备份保留天数范围：本地盘实例为 7~3650 天，云盘实例为 7~720 天。 HighFrequencySnapshotBackupSecondPeriod 参数的提示信息修改为："当 HighFrequencySnapshotBackupEnable 的值为 false 时，该字段的值为 0"。新增返回参数 KeepCrossBackupEnableAfterReleased，用于控制释放实例时是否保留跨地域备份。取值包括 true（是）和 false（否）。
修改	ModifyBackupPolicy	更新请求参数 IncrBackupHourPeriod 和 LockDDLTime 的描述信息。新增 HighFrequencySnapshotBackupEnable 参数，用于控制是否开启高频增量快照备份功能。新增 HighFrequencySnapshotBackupSecondPeriod 参数，用于设置高频增量快照备份的频率（单位为秒），可选值包括 3600（1小时）、7200（2小时）、10800（3小时）、14400（4小时）、19200（6小时）、28800（8小时）、38400（12小时）。更新 DataBackupRetentionDay 参数的描述，明确区分了本地盘实例和云盘实例的备份保留天数范围：本地盘实例：7~3650 天。云盘实例：仅支持 7 天。更新 LogBackupRetentionDay 参数的描述，明确区分了本地盘实例和云盘实例的日志备份保留天数范围：本地盘实例：7~3650 天。云盘实例：7~720 天。更新 HourlyIncrBackupEnable 参数的描述，明确说明该功能仅适用于本地盘实例。更新 IncrBackupHourPeriod 参数的描述，明确说明该功能仅适用于本地盘实例。更新 DataBackupEncryptionEnabled 和 BinlogBackupEncryptionEnabled 参数的描述新增提示，说明云盘实例暂不支持该功能。新增 KeepCrossBackupEnableAfterReleased 参数，用于控制是否保留跨地域备份，当前仅支持本地盘实例使用该功能。在返回参数中新增 KeepCrossBackupEnableAfterReleased 字段，用于展示跨地域备份保留状态。
修改	DescribeCrossBackupPolicy	BackupEnabled 参数的描述由“是否开启跨地域备份”修改为“是否开启了跨地域备份。取值：”，并补充了取值说明。新增返回参数 CrossBackupAllRetention，用于表示实例释放前是否长期保留跨地域备份，取值为 true 或 false。 Retention 参数的取值范围由 7~1825 天扩展为 7~3650 天，并补充说明当 CrossBackupAllRetention 为 true 时该字段返回值无效。
修改	ModifyCrossBackupPolicy	Retention 参数取值范围由 7~1825 天调整为 7~3650 天，并新增默认值为 7 天。新增 CrossBackupAllRetention 参数，用于设置实例释放前是否长期保留跨地域备份，取值为 true 或 false。返回参数中新增 CrossBackupAllRetention 参数，描述与请求参数一致。
修改	RestoreToCrossRegionInstance	StorageType 参数描述新增了取值范围：CloudESSD_FlexPL 和 CloudESSD_PL0，并详细说明了在不同接口中的使用限制。新增接口的注意事项，说明云盘实例暂不支持该功能。 StorageType 参数描述新增了关于 InstanceType 取值为 SingleNode 时的限制说明：当 InstanceType 取值为 SingleNode 时，StorageType 取值只能为 CloudESSD_FlexPL 或 CloudESSD_PL0。 NodeSpec 参数描述新增了关于 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0 时的限制说明：如 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0，NodeSpec 只能传入通用规格。
修改	DescribeCrossRegionBackupDBInstances	新增返回参数 CrossBackupAllRetention，用于表示实例释放前是否长期保留跨地域备份。修改返回参数 Retention 的描述，新增说明：当 CrossBackupAllRetention 取值为 true 时，该字段的返回值无效。
修改	CreateDBEndpoint	新增请求参数 EnableConnectionPersistent。
修改	ModifyDBEndpoint	新增请求参数 EnableConnectionPersistent。
修改	CreateDBInstance	StorageType 参数新增了两种存储类型：CloudESSD_FlexPL 和 CloudESSD_PL0，并详细说明了在不同接口中的使用限制。 StorageSpace 参数的描述进行了优化，明确说明不同存储类型和规格对应的存储空间取值范围不同。
修改	DescribeDBInstances	StorageType 参数新增了取值范围：CloudESSD_FlexPL 和 CloudESSD_PL0，并详细说明了在不同接口中的使用限制。 StorageType 参数的描述中新增了在不同接口中的取值范围规则，包括：在 CreateDBBlueGreenInstance和RestoreToCrossRegionInstance 接口中，StorageType 的取值只能为 LocalSSD。在 RebuildDBInstance、RestoreToNewInstance 和 ModifyDBNodeSpec 接口中，StorageType 的取值与原实例的存储类型有关。
修改	DescribeDBInstanceSpecs	StorageType 参数描述更新，新增了存储类型选项：CloudESSD_FlexPL 和 CloudESSD_PL0，并详细说明了在不同接口中的取值范围限制。 StorageType 参数在返回参数 InstanceSpecsInfoObject 中的描述同步更新，新增了存储类型选项和接口限制说明。
修改	DescribeDBInstanceAttribute	StorageType 参数新增了取值范围：CloudESSD_FlexPL（FlexPL 云盘）和 CloudESSD_PL0（PL0 云盘）。
修改	DescribeDeletedDBInstances	StorageType 参数新增了两种存储类型：CloudESSD_FlexPL 和 CloudESSD_PL0，分别表示 FlexPL 云盘和 PL0 云盘。
修改	ModifyCrossBackupPolicy	新增接口的注意事项，说明云盘实例暂不支持该功能。
修改	DescribeDBInstanceDetail	为接口增加注意事项——该接口已弃用。
修改	DescribeAllowLists	新增请求参数 WithIpList，用于控制是否返回白名单包含的 IP 地址和 IP 地址段的列表。取值为 true 时返回，取值为 false 或不传值时默认不返回。在返回参数 AllowListObject 中新增 IpList 字段，用于返回白名单包含的 IP 地址和 IP 地址段的列表。该字段仅在请求参数 WithIpList 取值为 true 时返回，否则返回为 null。
修改	公共结构体 - EndpointsObject	新增参数 EnableConnectionPersistent。

2025 年 06 月

发布 Python（v3.0.15）、GO（v1.1.18）、Java（v0.2.18）三个版本的 SDK。本次发布涉及的更新如下：

变更类型	API	变更记录
新增	CreateDrDBInstance	新增接口。
新增	DescribeDBAccountTableColumnInfo	新增接口。
新增	DescribeDBInstanceNodes	新增接口。
新增	DescribeDBNodeParameterDifferences	新增接口。
新增	DescribeDBProxyPriceDetail	新增接口。
新增	DescribeDisasterRecoveryRegions	新增接口。
新增	DescribeTaskDetail	新增接口。
新增	ifyDBInstanceDeletionProtectionPolicy	新增接口。
新增	ModifyBackupPublicAccessPolicy	新增接口。
新增	ModifyDBEndpointConnectionMode	新增接口。
新增	RebuildDrInstance	新增接口。
新增	SwitchDrInstanceToMaster	新增接口。
新增	SyncAllowList	新增接口。
新增	公告结构体 - ColumnPrivilegeObject	新增结构体。
新增	公共结构体 - AccountTableColumnPrivilegeObject	新增结构体。
新增	公共结构体 - AutoStorageScalingConfigObject	新增结构体。
新增	公共结构体 - DescribeDBInstancePriceDetailStrObject	新增结构体。
新增	公共结构体 - DisasterRecoveryInstanceObject	新增结构体。
新增	公共结构体 - MasterInstance	新增结构体。
新增	公共结构体 - NodeDifferentParameterObject	新增结构体。
新增	公共结构体 - NodeParameterValueDetailObject	新增结构体。
新增	公共结构体 - TableInfoObject	新增结构体。
新增	公共结构体 - TablePrivilegeObject	新增结构体。
修改	CreateAllowList	为 AllowList、UserAllowList、SecurityGroupIds 和 SecurityGroupBindInfos 新增限制信息。
修改	CreateBinlogBackup	新增返回参数 InstanceId 和 BackupId。
修改	CreateDBEndpoint	为接口增加注意事项。新增请求参数 MasterNodeRouting、ImplicitTransSplit、OverloadProtection 和 MasterProtectorTimeout。更新请求参数 ReadOnlyNodeDistributionType 的取值范围。
修改	CreateDBInstance	新增请求参数 ProxyNodeCustom。更新请求参数 InstanceType 的取值范围。更新请求参数 InstanceName 的描述信息。修改 StorageSpace 的取值范围的描述。新增关于删除保护功能的请求参数 DeletionProtection 和关于自动扩容功能的请求参数 AutoStorageScalingConfig。
修改	CreateDBNodes	更新请求参数 SwitchType 在多节点实例下的取值范围。
修改	CreateParameterTemplate	更新请求参数 TemplateType 和 TemplateTypeVersion 为可选。
修改	DeleteDBEndpoint	为接口增加注意事项。
修改	DeleteDBInstance	新增请求参数 DataKeepDays。更新请求参数 DataKeepPolicy 的取值范围。
修改	DeleteDBNodes	更新请求参数 SwitchType 在多节点实例下的取值范围。更新请求参数 DBNodeIds 在多节点实例和双节点实例下的取值范围。
修改	DeleteParameterTemplate	新增返回参数 TemplateId。
修改	DescribeBackupPolicy	新增返回参数 PublicDownloadEnable。更新返回参数 DescribeBackupPolicy 的取值范围。
修改	DescribeBackups	更新请求参数 PageSize 的取值范围。
修改	DescribeDatabases	更新请求参数 PageSize 的取值范围。
修改	DescribeDBAccounts	更新请求参数 PageSize 的取值范围。
修改	DescribeDBInstanceParametersLog	更新请求参数 PageSize 的取值范围。
修改	DescribeDBInstancePriceDetail	新增请求参数 ProxyNodeCustom。新增返回参数 DescribeDBInstancePriceDetailStrObject。移除返回参数 BillingMethod、Chargeltem Prices、CouponAmount、Currency、DiscountPrice、OriginalPrice、PayablePrice、Quantity 和 RefundAmount。
修改	DescribeDBInstances	新增请求参数 StorageType。新增返回参数 DisasterRecoveryInstances。更新请求参数 PageSize 的取值范围。
修改	DescribeDBInstanceSpecs	更新请求参数 InstanceType 的取值范围。
修改	DescribeTagsByResource	更新请求参数 PageNumber 和 PageSize 的描述信息。
修改	ListParameterTemplates	新增请求参数 TemplateName。
修改	MigrateToOtherZone	为接口新增注意事项。
修改	ModifyAllowList	为参数 SecurityGroupIds 与 SecurityGroupBindInfos 新增限制信息。
修改	ModifyBackupPolicy	新增返回参数 PublicDownloadEnable。更新请求参数 DataKeepPolicyAfterReleased 的取值范围。
修改	ModifyDBEndpoint	更新请求参数 Nodes、AutoAddNewNodes、ReadOnlyNodeDistributionType、OverloadProtection、MasterProtectorTimeout、MasterNodeRouting、ConnectAllSlaveNodes、ConnectionMode 的描述信息。新增请求参数 MasterNodeRouting、ImplicitTransSplit、OverloadProtection 和 MasterProtectorTimeout。更新请求参数 ReadOnlyNodeDistributionType 的取值范围。
修改	ModifyDBInstanceParameters	更新请求参数 ParamApplyScope 的描述信息。
修改	ModifyDBInstanceSSL	新增请求参数 SwitchType、SpecifiedSwitchStartTime 和 SpecifiedSwitchEndTime。
修改	ModifyDBNodeSpec	更新请求参数 StorageSpace 的描述信息。
修改	ModifyDBProxy	新增请求参数 ConvertDefaultEndpoint。为接口增加注意事项。
修改	ModifyDBProxySpec	移除接口失效的注意事项。新增返回参数 OrderId。
修改	ModifyParameterTemplate	新增返回参数 TemplateId。
修改	ModifyReadOnlyNodeDelayReplicationTime	为接口增加注意事项。
修改	ModifyTask	为接口增加取消任务的注意事项。
修改	RebuildDBInstance	新增请求参数 ProxyNodeCustom、BackupId、StorageType、StorageSpace、VpcId、InstanceName、DBParamGroupId、ChargeInfo、NodeInfo、SubnetId、InstanceTags、AllowListIds、Port、AutoStorageScalingConfig 和 DeletionProtection。新增 InstanceId 和 OrderId。
修改	RestoreToCrossRegionInstance	新增请求参数 ProxyNodeCustom。
修改	RestoreToExistedInstance	新增请求参数 FastMode。
修改	RestoreToNewInstance	新增请求参数 ProxyNodeCustom。
修改	SaveAsParameterTemplate	新增返回参数 TemplateId。
修改	CopyParameterTemplate	新增请求参数 CopyParameterTemplate。新增返回参数 TemplateId。
修改	公共结构体 - AccountPrivilegeObject	更新字段 DBName、AccountPrivilege 和 AccountPrivilegeDetail 的描述信息。更新 AccountPrivilege 和 AccountPrivilegeDetail 的取值范围。
修改	公共结构体 - AccountsObject	新增参数 HasTableColumnPrivilegeDBNames。
修改	公共结构体 - BackupInfoObject	新增参数 DBEngineVersion。
修改	公共结构体 - BasicInfoObject	新增参数 DeletionProtection。新增灾备实例功能相关参数 DrDtsTaskId、MasterRegion、DrDtsTaskName、DrDtsTaskStatus、MasterInstanceId、MasterInstanceName 和 DrSecondsBehindMaster。更新参数 InstanceType 的取值范围。
修改	公共结构体 - DeletedDBInstanceInfoObject	更新参数 InstanceType 的取值范围。
修改	公共结构体 - EndpointsObject	新增参数 ConnectionInfoTags、MasterNodeRouting、ImplicitTransSplit、OverloadProtection 和 MasterProtectorTimeout。更新 ReadOnlyNodeDistributionType 字段的取值范围。
修改	公共结构体 - InstanceInfoObject	更新参数 InstanceType 的取值范围。新增删除保护功能相关参数 DeletionProtection。新增灾备实例功能相关参数 DrDtsTaskId、MasterInstance 和 DisasterRecoveryInstances。
修改	公共结构体 - NodeInfoObject	更新参数 NodeType、NodeSpec、NodeOperateType 和 ZoneId 的描述信息。
修改	公共结构体 - ProxyNodeCustomObject	更新参数 CpuNum 在多节点实例和双节点实例下的取值范围。
修改	公共结构体 - ReadOnlyNodeWeightObject	修改参数 NodeType 的描述信息与取值范围。
修改	公共结构体 - TagFilterObject	新增参数 Values。

2025-03-06

发布 Python（v1.0.128）、GO（v1.0.185）、Java（v0.1.155）三个版本的 SDK。本次发布涉及的更新如下：

API	变更记录
AddDiagnosticsEntity	新增接口。
CreateDBNodes
CreateDiagnosticsTask
DeleteDBNodes
DescribeBackupStats
DescribeCrossRegionBackupDBInstances
DescribeDBInstanceEngineMinorVersions
DescribeDeletedDBInstances
DescribeDiagnosticsInfos
ModifyDBInstanceAutoUpgradeEngineMinorVersion
ModifyDBInstanceGlobalReadOnly
ModifyDBNodeSpec
ModifyDBNodeTemporarySpec
ModifyDBProxy
ModifyDBProxySpec
RemoveDiagnosticsEntity
UpgradeDBInstanceEngineMinorVersion
公共结构体 - BackupExtraOptionObject	新增结构体。
公共结构体 - CheckModifyDBProxyAllowedV2Object
公共结构体 - CRBackupServingInstanceInfoObject
公共结构体 - DeletedDBInstanceInfoObject
公共结构体 - DiagnosticsEcsInfoObject
公共结构体 - DiagnosticsEndpointInfo
公共结构体 - DiagnosticsInfoObject
公共结构体 - DiagnosticsItemInfoObject
公共结构体 - DiagnosticsPublicAddressInfoObject
公共结构体 - ProxyInfoObject
公共结构体 - ProxyNodeCustomObject
公共结构体 - ProxyResourceInfoObject
公共结构体 - UsageStatObject
CopyParameterTemplate	增加可选请求参数 ProjectName。
CreateAllowList	增加可选请求参数 ProjectName。
CreateDBAccount	新增请求参数 DryRun。新增返回参数 CreateAccountSQL。更新请求参数 AccountName 的描述信息，增加取值规则。
CreateDBInstance	请求参数 StorageSpace 由可选调整为必选。更新请求参数 InstanceTags 的描述信息。
CreateDBEndpoint	新增以下请求参数： ConnectionMode ConnectionPoolType IdleConnectionReclaim MultiStatementsMode ReadOnlyNodeDistributionType ReadOnlyNodeMaxDelayTime ReadOnlyNodeWeight ReadWriteSpliting 更新以下请求参数的描述信息： ReadWriteMode
CreateParameterTemplate	增加可选请求参数 ProjectName。
DeleteAllowList	增加可选请求参数 ProjectName。
DeleteDBInstance	更新请求参数 DataKeepPolicy 的取值范围。
DeleteParameterTemplate	增加可选请求参数 ProjectName。
DescribeAllowListDetail	增加可选请求参数 ProjectName。
DescribeAllowLists	新增请求参数 QueryDefault。增加可选请求参数 ProjectName。新增请求参数 IPAddress。
DescribeBackupPolicy	新增以下返回参数： BinlogBackupAllRetention BinlogBackupEnabled BinlogBackupEncryptionEnabled DataBackupAllRetention DataBackupEncryptionEnabled DataFullBackupStartUTCHour DataKeepDaysAfterReleased DataKeepPolicyAfterReleased HourlyIncrBackupEnable IncrBackupHourPeriod RetentionPolicySynced 更新以下返回参数的描述信息： DataBackupRetentionDay DataFullBackupTime DataIncrBackupPeriods LogBackupRetentionDay 更新以下返回参数的取值范围信息： DataBackupRetentionDay LogBackupRetentionDay 更新返回示例。
DescribeBackups	更新请求参数 InstanceId 的可选性，并修改其描述信息。新增请求参数 Option。更新返回参数 DBTableInfos 的描述信息。更新请求参数 BackupStartTime 和 BackupEndTime 的描述信息。
DescribeBinlogFiles	新增请求参数 ResultSorter。更新请求参数 Context 为可选。
DescribeDBInstanceDetail	新增返回参数 ProxyDetail。
DescribeDBInstancePriceDetail	增加可选请求参数 ProjectName。
DescribeDBInstances	新增请求参数 PrivateNetworkIpAddress、KernelVersion 和 PrivateNetworkVpcId。更新请求参数 InstanceStatus 的取值范围。更新请求参数 PageNumber 和 PageSize 的描述信息。
DescribeDBProxyConfig	新增返回参数 CheckModifyDBProxyAllowedV2 和 ProxyResourceInfo。更新返回参数 BinlogDump、DBProxyStatus 和 CheckModifyDBProxyAllowed 的描述信息。
DescribeParameterTemplate	增加可选请求参数 ProjectName。
DescribePlannedEvents	增加可选请求参数 ProjectName。更新请求参数 Status 的取值范围。
DescribeRecoverableTime	更新请求参数 RestoreType 的描述信息。
DescribeTasks	更新请求参数 TaskStatus 和 TaskCategory 的取值范围。
GetBackupDownloadLink	请求参数 BackupFileSize 的类型从 Integer 更新为 Long。
GrantDBAccountPrivilege	新增请求参数 DryRun。新增返回参数 CreateAccountSQL。
ListParameterTemplates	增加可选请求参数 ProjectName。
MigrateToOtherZone	修改请求参数 SwitchType 的描述信息。新增请求参数 SpecifiedSwitchStartTime 和 SpecifiedSwitchEndTime。
ModifyAllowList	新增请求参数 IgnoreInstanceStatus。增加可选请求参数 ProjectName。
ModifyBackupPolicy	新增以下请求参数： DataFullBackupStartUTCHour BinlogBackupAllRetention BinlogBackupEnabled BinlogBackupEncryptionEnabled DataBackupAllRetention DataBackupEncryptionEnabled DataKeepDaysAfterReleased DataKeepPolicyAfterReleased HourlyIncrBackupEnable IncrBackupHourPeriod RetentionPolicySynced 更新以下请求参数的描述信息： DataFullBackupPeriods DataBackupRetentionDay DataFullBackupTime DataIncrBackupPeriods BinlogFileCountsEnable BinlogLimitCount BinlogLocalRetentionHour BinlogSpaceLimitEnable BinlogStoragePercentage LogBackupRetentionDay 更新以下请求参数的取值范围： DataBackupRetentionDay LogBackupRetentionDay 新增以下返回参数： BinlogBackupAllRetention BinlogBackupEnabled BinlogBackupEncryptionEnabled DataBackupAllRetention DataBackupEncryptionEnabled DataFullBackupStartUTCHour DataKeepDaysAfterReleased DataKeepPolicyAfterReleased HourlyIncrBackupEnable IncrBackupHourPeriod RetentionPolicySynced 更新以下返回参数的描述信息： DataFullBackupTime DataIncrBackupPeriods LogBackupRetentionDay 更新接口的请求示例和返回示例。
ifyCrossBackupPolicy	更新请求参数 BackupEnabled 与 LogBackupEnabled 的默认值。
ModifyDBEndpoint	新增以下请求参数： ConnectionMode MultiStatementsMode 修改以下请求参数的描述信息： ReadWriteMode
ModifyDBInstanceSpec	为接口增加注意事项，该接口已弃用。
ModifyParameterTemplate	增加可选请求参数 ProjectName。
ModifyPlannedEventExecuteTime	增加可选请求参数 ProjectName 和 TaskEventOperation。增加必选请求参数 InstanceId。修改请求参数 ModifyBeginTime 和 ModifyEndTime 为可选。
ModifyTask	新增请求参数 TaskEventOperation、ModifyBeginTime、ModifyEndTime 和 ProjectName。移除请求参数 ModifyType 和 SwitchTime。
RebuildDBInstance	新增请求参数 RequestSource。更新请求参数 ProjectName 的描述信息。
RestartDBInstance	修改请求参数 SwitchType 的描述信息。新增请求参数 SpecifiedSwitchStartTime 和 SpecifiedSwitchEndTime。
RestoreToCrossRegionInstance	更新请求参数 StorageType 和 InstanceTags 的描述信息。
RestoreToExistedInstance	更新请求参数 RestoreType 的描述信息。
RestoreToNewInstance	更新请求参数 StorageType 和 InstanceTags 的描述信息。
公共结构体 - AccountsObject	新增字段 AccountPrivilegesSQL 和 GlobalAccountPrivileges。
公共结构体 - AccountPrivilegesObject	更新字段 DBName 的描述信息。
公共结构体 - AllowListObject	修改字段 AllowListCategory 的描述信息。
公共结构体 - AssociatedInstanceObject	新增字段 InstanceStatus 和 IsLatest。
公共结构体 - BasicInfoObject	新增参数 BasicBackupBinlogSize、BasicBackupDataSize、BackupFreeQuotaSize、CurrentKernelVersion 和 AutoUpgradeMinorVersion。更新参数 InstanceStatus 的描述信息。
公共结构体 - BackupExtraOption	新增请求参数 ResultSorter。
公共结构体 - ChargeInfo	修改 ChargeType、AutoRenew、PeriodUnit、Period 和 Number 字段的描述信息。
公共结构体 - EndpointObject	新增以下字段： ConnectionMode ConnectionPoolType MultiStatementsMode ReadOnlyNodeDistributionType ReadOnlyNodeMaxDelayTime
公共结构体 - InstanceInfoObject	- CurrentKernelVersion 字段。
公共结构体 - InstanceSpecsInfoObject	更新 SpecFamily 字段取值的描述信息（实例规格类型名称更新）。
公共结构体 - NodeInfoObject	更新字段 NodeId、ZoneId、NodeType 和 NodeOperateType 的描述信息。
公共结构体 - NodeObject	新增字段 DelayReplicationTime 和 SyncDelay。
公共结构体 - PlannedEvent	新增字段 PlannedSwitchBeginTime 和 PlannedSwitchEndTime。移除字段 IsUrgent。
公共结构体 - RegionObject	更新字段 RegionName 的示例值。
公共结构体 - TableMetaObject	更新字段 NewDBName 的描述信息，增加该字段的取值规则。
公共结构体 - TagObject	更新字段 Key 和 Value 的描述信息。
公共结构体 - TableObject	更新字段 NewTableName 的描述信息，增加该字段的取值规则。
公共结构体 - TaskInfoObject	新增字段 ScheduledExecuteEndTime、ScheduledExecuteStartTime、ScheduledSwitchEndTime 和 ScheduledSwitchStartTime。更新字段 TaskCategory 和 TaskStatus 的取值范围。移除字段 ConfigInfos。

2024-10-31

发布 Python（v1.0.107）、GO（v1.0.163）、Java（v0.1.134）三个版本的 SDK。本次发布涉及的更新如下：

API	变更记录
DescribeBackupPolicy	更新返回参数 DataFullBackupTime 在返回参数列表中的示例值。
DescribeDBInstanceTDE	从 SDK 移除。
ModifyDBInstanceTDE	从 SDK 移除。
CreateParameterTemplate	新增返回参数 TemplateId。修改请求参数 TemplateType 的取值为 Mysql。更新返回示例。
ModifyDBEndpoint	增加请求参数 IdleConnectionReclaim。
CreateDBInstance	修改请求参数 VpcId 的描述信息，增加对不支持共享 VPC 的限制。
RestoreToNewInstance	修改请求参数 VpcId 的描述信息，增加对不支持共享 VPC 的限制。
RestoreToCrossRegionInstance	修改请求参数 VpcId 的描述信息，增加对不支持共享 VPC 的限制。
数据结构 - InstanceParamObject	新增参数 ExpectValue 和 Expression。
数据结构 - ParameterChangeLogObject	在DescribeDBInstanceParametersLog 接口返回的新增字段 CustomNodeIds 和 ParamApplyScope。
数据结构 - ParametersObject	移除字段 CheckingCode、ForceRestart、ParameterDefaultValue、ParameterDescription 和 Expression。
数据结构 - InstanceParametersObject	更新 DescribeDBInstanceParameters 接口返回参数 Parameters 关联的结构体为 InstanceParametersObject。
数据结构 - EndpointObject	在 DescribeDBInstanceDetail 接口返回的 EndpointObject 增加 IdleConnectionReclaim 参数。
数据结构 - NodeInfoObject	更新 NodeInfoObject 参数 NodeSpec 和 ZoneId 的描述信息。

2024-08-08

发布 Python（v1.0.95）、GO（v1.0.151）、Java（v0.1.123）三个版本的 SDK。本次发布涉及的更新如下：

API	变更记录
ModifyAllowList	修改请求参数 ApplyInstanceNum 为必填的限定条件。
RestoreToExistedInstance	请求参数 RestoreType 和 TableMeta 由可选改必选。
ModifyBackupEncryptionPolicy	新增接口。
DescribeBackupEncryptionStatus	新增接口。
DescribeBackupDecryptionKey	新增接口。

2024-07-25

发布 Python（v1.0.94）、GO（v1.0.150）、Java（v0.1.122）三个版本的 SDK。本次发布涉及的接口更新如下：

API	变更记录
AssociateAllowList	更新请求参数 InstanceIds 和 AllowListIds 的描述信息，增加数量限制信息。
CreateBackup	为请求参数 BackupMethod 增加取值 Logical。为请求参数 BackupType 增加取值 DumpAll，并更新相关描述信息。为请求参数 BackupMeta 补充前提条件、互斥情况和数量限制。增加示例：创建备份方式为全库备份的逻辑备份、创建备份方式为库表备份的逻辑备份更新返回参数。
CreateDBAccount	更新请求参数 AccountPassword 的取值范围。
CreateDBEndpoint	修改请求参数 EndpointType 的取值，移除可取值 Primary。
CreateDBInstance	新增请求参数 MaintenanceWindow，并更新请求示例。更新参数 SuperAccountPassword 的取值范围。
DeleteDataBackup	移除该接口的使用限制。
DescribeBackups	新增请求参数 CreateType。为请求参数 BackupMethod 补充取值 Logical，并更新请求示例。为请求参数 BackupType 增加取值 DumpAll，并更新相关描述信息。为请求参数 BackupId、BackupStatus、BackupMethod、BackupType 补充默认值相关的说明。更新返回示例。
DescribeDBInstanceParameters	增加请求参数 NodeId。
DescribeDBInstances	新增请求参数 InstanceType、NodeSpec 和 TagFilters。更新返回示例。
DescribeDBInstanceSSL	新增返回参数 Address，并更新返回示例。
DescribeFailoverLogs	新增请求参数 EndTime 和 StartTime。
DescribeReadOnlyNodeDelay	修改返回参数 DelayReplicationTime 的类型为 Long。
GetBackupDownloadLink	修改返回参数 DownloadProgress 的类型为 Long。更新接口注意事项。更新请求参数 BackupId 的描述信息。新增返回参数 InnerBackupDownloadLink。更新返回参数 BackupFileName 和 BackupId 的描述信息。更新返回参数 BackupFileSize 的单位。更新返回示例。
ModifyAllowList	新增请求参数 UpdateSecurityGroup。
ModifyDBInstanceParameters	新增请求参数 ParamApplyScope 和 CustomNodeIds。
ModifyReadOnlyNodeDelayReplicationTime	修改请求参数 DelayReplicationTime 的类型为 Long。
ResetDBAccount	更新请求参数 AccountPassword 的取值范围。
RestoreToExistedInstance	更新请求参数 BackupId 的描述信息。
RestoreToNewInstance	更新请求参数 BackupId 的描述信息。
数据结构 - BackupMetaObject	增加参数 TableNames。
数据结构 - BackupObject	新增 IsEncrypted 参数。修改参数 BackupFileSize 的类型为 Long。为参数 BackupType 增加取值 DumpAll。
数据结构 - BasicInfoObject	修改参数 StorageSpace 的类型为 Long。为参数 InstanceStatus 增加取值 ChargeTypeChanging：计费类型变更中。为参数 InstanceStatus 增加取值：NetWorkChanging：网络变更中。为 InstanceStatus 增加以下取值： Recycled：已回收。 TDEUpdating：TDE 修改中。 Closed：关停。 Maintaining：维护中。 CreateFailed：创建失败。 Closing：关停中。 SSLUpdating：SSL 变更中。 AllowListMaintaining：白名单变更中。 Unknown：未知。 ProxyCreating：代理开启中。 ProxyDeleting：代理关闭中。更新取值 MasterChanging 的描述信息。
数据结构 - BinlogFilesObject	新增 IsEncrypted 参数。修改参数 FileSize 的类型为 Long。
数据结构 - ChargeItemPriceObject	修改参数 ChargeItemValue 的类型为 Long。
数据结构 - ConfigItemPriceObject	修改参数 Quantity 的类型为 Long。
数据结构 - EndpointObject	修改参数 EndpointType 的取值，移除可取值 Primary 和 Cluster。修改参数 Description 的示例值和描述信息。修改参数 EndpointName 的示例值。
数据结构 - InstanceObject	为参数 InstanceStatus 增加取值：NetWorkChanging：网络变更中。更新参数 ZoneId 的描述信息。增加参数 NodeCPUUsedPercentage、NodeMemoryUsedPercentage 和 NodeSpaceUsedPercentage。增加参数 Tags 和 ZoneIds。为 InstanceStatus 增加以下取值： Recycled：已回收。 TDEUpdating：TDE 修改中。 Closed：关停。 Maintaining：维护中。 CreateFailed：创建失败。 Closing：关停中。 SSLUpdating：SSL 变更中。 AllowListMaintaining：白名单变更中。 Unknown：未知。 ProxyCreating：代理开启中。 ProxyDeleting：代理关闭中。 ChargeTypeChanging：计费类型变更中。更新取值 MasterChanging 的描述信息。
数据结构 - MaintenanceWindowObject	删除参数 DayOfMonth。
数据结构 - ParameterTemplateInfoObject	修改参数 ParameterNum 的类型为 Long。
数据结构 - TaskInfoObject	修改参数 CostTimeMS 的类型为 Long。

2024-05-23

发布 Python（v1.0.83）、GO（v1.0.137）、Java（v0.1.111）三个版本的 SDK。本次发布涉及的接口更新如下：

API	变更记录
CreateDatabase	修改请求字段 DBName 的描述信息。
CreateDBAccount	修改请求字段 AccountName 的描述信息。
CreateDBInstance	新增请求字段 Port，更新请求示例（新增 Port 字段）。更新请求字段 VpcId 和 SubnetId 的示例值和描述信息。修改请求字段 SuperAccountName 的描述信息。
DescribeBinlogFiles	更新返回字段 BinlogFiles 的示例值。更新返回示例，为每个返回的 BinlogFilesObject 增加 NodeId。修改字段 BackupFileNumber 的取值上限。
ModifyDBEndpointAddress	在接口描述新增说明事项。在请求字段 Port 的描述信息增加说明。
ModifyDBInstanceChargeType	修改接口的描述信息。修改请求字段 PeriodUnit 和 Period 为可选。
ModifyDBInstanceName	更新请求参数 InstanceNewName 的描述信息。
ModifyTask	新增请求字段 InstanceId。更新请求示例和返回示例。
RestoreToCrossRegionInstance	新增接口。
RestoreToNewInstance	新增请求字段 Port，更新请求示例（新增 Port 字段）。更新请求字段 VpcId 和 SubnetId 的示例值和描述信息。
数据结构 - BinlogFilesObject	增加字段 NodeId。
数据结构 - NodeInfoObject	为字段 ZoneId 补充描述信息。

2024-04-11

发布 Python（v1.0.74）、GO（v1.0.131）、Java（v0.1.105）三个版本的 SDK。本次发布涉及的接口更新如下：

APIAPI	变更记录
ModifyDBEndpointAddress	修改接口的使用说明（支持修改公网端口）和请求字段 Port 的描述信息。
CreateAllowList	新增请求参数 SecurityGroupBindInfos、AllowListCategory、UserAllowList。
ModifyAllowList	新增请求参数 SecurityGroupBindInfos、AllowListCategory、UserAllowList，修改接口的使用限制。
DescribeAllowLists	更新接口文档的返回示例。
DescribeAllowListDetail	新增返回参数 AllowListCategory、SecurityGroupBindInfos 和 UserAllowList。
DescribePlannedEvents	为请求参数 EventType 新增取值 HostOffline。
CreateParameterTemplate	更新请求参数 TemplateTypeVersion 的取值和接口的请求示例。
ModifyParameterTemplate	更新请求参数 TemplateParams 的描述信息，增加说明。
DescribeParameterTemplate	更新接口的请求示例。
ListParameterTemplates	更新请求参数 TemplateTypeVersion 的取值。
数据结构 - InstanceParamObject	增加说明和字段 DefaultValue、Description、Restart 和 ValueRange。
数据结构 - ParameterTemplateInfoObject	为字段 TemplateParams 增加示例值。

2024-03-14

发布 Python（v1.0.69）、Go（v1.0.125）、Java（v0.1.101）三个版本的 SDK。该版本的改动点如下：

新增

该版本 SDK 新增了以下接口：

API	变更记录
MigrateToOtherZone	调用 MigrateToOtherZone 接口将指定实例的节点迁移至同一地域下的其他可用区。
DescribeReadOnlyNodeDelay	调用 DescribeReadOnlyNodeDelay 接口查询只读节点的延迟复制配置。
ModifyReadOnlyNodeDelayReplicationTime	调用 ModifyReadOnlyNodeDelayReplicationTime 接口配置只读节点的延迟复制功能。
ModifyDBAccountHost	调用 ModifyDBAccountHost 接口修改普通数据库账号可访问数据库的 IP 地址。
DownloadSSLCertificate	调用 DownloadSSLCertificate 接口下载指定 MySQL 实例的 SSL 证书。
DeleteDataBackup	调用 DeleteDataBackup 接口删除指定 MySQL 实例的手动备份文件。
ListParameterTemplates	调用 ListParameterTemplates 接口查询 MySQL 实例的参数模板列表。
DescribeTasks	调用 DescribeTasks 接口查询任务。
ModifyTask	调用 ModifyTask 接口编辑任务。
DescribePlannedEvents	调用 DescribePlannedEvents 接口查询计划内事件的列表信息。
ModifyPlannedEventExecuteTime	调用 ModifyPlannedEventExecuteTime 接口推迟计划内运维事件执行的时间。
DescribeFailoverLogs	调用 DescribeFailoverLogs 接口查询 MySQL 实例的主备切换日志。

修改

该版本 SDK 对以下接口进行了修改：

API	变更记录
CopyParameterTemplate	更新请求参数 TemplateName 为必选项。
CreateAllowList	更新请求参数 AllowList 为非必选项。
CreateBackup	更新返回参数为空。
CreateDBAccount	新增必选请求参数 AccountType。更新请求参数 AccountName、AccountPassword 为必选项。删除了请求参数 AccountPrivilegesInfo。
CreateDBEndpoint	更新请求参数为必选项 EndpointType。
CreateDBInstance	更新请求参数 DBEngineVersion、StorageSpace、StorageType、SubnetId、VpcId 为必选项。
CreateDatabase	更新请求参数 DBName 为必选项。删除了请求参数 DatabasePrivilegesInfo。
CreateParameterTemplate	更新请求参数 TemplateName 为必选项。
DescribeAllowLists	更新请求参数 RegionId 为必选项。
DescribeAvailabilityZones	删除了请求参数 RegionId。
DescribeAvailableCrossRegion	更新请求参数 RegionId 为必选项。
DescribeBinlogFiles	更新请求参数 EndTime、InstanceId、StartTime 为必选项。
DescribeCrossBackupPolicy	更新请求参数 InstanceId 为必选项。
DescribeDBAccounts	返回参数删除了 AccountsInfo 字段。返回参数 Accounts 嵌套对象删除了字段AccountPrivilegesInfo。
DescribeDBInstanceDetail	返回参数结构体删除了 ConnectionInfo、NodeDetailInfo。
DescribeDBInstancePriceDetail	更新请求参数 ChargeType、StorageSpace、StorageType 为必选项。
DescribeDBInstanceTDE	新增了必选参数 InstanceId。
DescribeDBInstances	删除返回参数 InstancesInfo。
DescribeDBProxyConfig	更新请求参数 InstanceId 为必选项。
DescribeDatabases	更新请求参数 InstanceId 为必选项。返回参数删除了字段 DatabasesInfo。
DescribeParameterTemplate	返回参数 TemplateInfo 下 TemplateParams 参数删除了字段 Description。
DownloadBackup	更新请求参数 BackupId 为必选项。
GetBackupDownloadLink	更新请求参数 BackupId 为必选项。
ModifyBackupPolicy	更新请求参数 InstanceId 为必选项。
ModifyCrossBackupPolicy	更新请求参数 InstanceId 为必选项。
ModifyDBEndpointAddress	更新请求参数 EndpointId、NetworkType 为必选项。
ModifyDBInstanceChargeType	更新请求参数 ChargeType、Period、PeriodUnit 为必选项。
ModifyDBInstanceMaintenanceWindow	更新请求参数 MaintenanceTime 为必选项。
ModifyDBInstanceParameters	返回参数更新为空。
ModifyDBInstanceSyncMode	更新请求参数 SyncMode 为必选项。
ModifyDBInstanceTDE	更新请求参数 TDEStatus 为必选项。
ModifyParameterTemplate	更新请求参数 TemplateName 为必选项。
ResetDBAccount	更新请求参数 AccountPassword 为必选项。
RestoreToExistedInstance	更新请求参数 SourceDBInstanceId 为必选项。
SaveAsParameterTemplate	更新请求参数 TemplateName 为必选项。
SwitchDBInstanceHA	更新请求参数 NodeId 为必选项。

最近更新时间：2026.06.26 17:05:02

这个页面对您有帮助吗？

有用

无用