## 2025 年 06 月发布 Python（v3.0.15）、GO（v1.1.18）、Java（v0.2.18）三个版本的 SDK。本次发布涉及的更新如下： |变更类型 |API |变更记录 | |---|---|---| |新增 |[CreateDrDBInstance](https://www.volcengine.com/docs/6313/1394648) |新增接口。 | |新增 |[DescribeDBAccountTableColumnInfo](https://www.volcengine.com/docs/6313/1529685) |新增接口。 | |新增 |[DescribeDBInstanceNodes](https://www.volcengine.com/docs/6313/1567639) |新增接口。 | |新增 |[DescribeDBNodeParameterDifferences](https://www.volcengine.com/docs/6313/1567642) |新增接口。 | |新增 |[DescribeDBProxyPriceDetail](https://www.volcengine.com/docs/6313/1569663) |新增接口。 | |新增 |[DescribeDisasterRecoveryRegions](https://www.volcengine.com/docs/6313/1394651) |新增接口。 | |新增 |[DescribeTaskDetail](https://www.volcengine.com/docs/6313/1528790) |新增接口。 | |新增 |[DescribeUserTosBackupAssociate](https://www.volcengine.com/docs/6313/1567645) |新增接口。 | |新增 |[ifyDBInstanceDeletionProtectionPolicy](https://www.volcengine.com/docs/6313/1526759) |新增接口。 | |新增 |[ModifyBackupPublicAccessPolicy](https://www.volcengine.com/docs/6313/1567644) |新增接口。 | |新增 |[ModifyDBEndpointConnectionMode](https://www.volcengine.com/docs/6313/1567643) |新增接口。 | |新增 |[RebuildDrInstance](https://www.volcengine.com/docs/6313/1394650) |新增接口。 | |新增 |[SwitchDrInstanceToMaster](https://www.volcengine.com/docs/6313/1394649) |新增接口。 | |新增 |[SyncAllowList](https://www.volcengine.com/docs/6313/1476863) |新增接口。 | |新增 |公告结构体 \- ColumnPrivilegeObject |新增结构体。 | |新增 |公共结构体 \- AccountTableColumnPrivilegeObject |新增结构体。 | |新增 |公共结构体 \- AutoStorageScalingConfigObject |新增结构体。 | |新增 |公共结构体 \- DescribeDBInstancePriceDetailStrObject |新增结构体。 | |新增 |公共结构体 \- DisasterRecoveryInstanceObject |新增结构体。 | |新增 |公共结构体 \- MasterInstance |新增结构体。 | |新增 |公共结构体 \- NodeDifferentParameterObject |新增结构体。 | |新增 |公共结构体 \- NodeParameterValueDetailObject |新增结构体。 | |新增 |公共结构体 \- TableInfoObject |新增结构体。 | |新增 |公共结构体 \- TablePrivilegeObject |新增结构体。 | |修改 |[CreateAllowList](https://www.volcengine.com/docs/6313/170674) |为 AllowList、UserAllowList、SecurityGroupIds 和 SecurityGroupBindInfos 新增限制信息。 | |修改 |[CreateBinlogBackup](https://www.volcengine.com/docs/6313/1127824) |新增返回参数 InstanceId 和 BackupId。 | |修改 |[CreateDBEndpoint](https://www.volcengine.com/docs/6313/170670) |* 为接口增加注意事项。|\ | | |* 新增请求参数 MasterNodeRouting、ImplicitTransSplit、OverloadProtection 和 MasterProtectorTimeout。|\ | | |* 更新请求参数 ReadOnlyNodeDistributionType 的取值范围。 | |修改 |[CreateDBInstance](https://www.volcengine.com/docs/6313/170648) |* 新增请求参数 ProxyNodeCustom。更新请求参数 InstanceType 的取值范围。更新请求参数 InstanceName 的描述信息。|\ | | |* 修改 StorageSpace 的取值范围的描述。新增关于删除保护功能的请求参数 DeletionProtection 和关于自动扩容功能的请求参数 AutoStorageScalingConfig。 | |修改 |[CreateDBNodes](https://www.volcengine.com/docs/6313/1359331) |更新请求参数 SwitchType 在多节点实例下的取值范围。 | |修改 |[CreateParameterTemplate](https://www.volcengine.com/docs/6313/1127813) |更新请求参数 TemplateType 和 TemplateTypeVersion 为可选。 | |修改 |[DeleteDBEndpoint](https://www.volcengine.com/docs/6313/170672) |为接口增加注意事项。 | |修改 |[DeleteDBInstance](https://www.volcengine.com/docs/6313/170649) |新增请求参数 DataKeepDays。更新请求参数 DataKeepPolicy 的取值范围。 | |修改 |[DeleteDBNodes](https://www.volcengine.com/docs/6313/1359333) |更新请求参数 SwitchType 在多节点实例下的取值范围。更新请求参数 DBNodeIds 在多节点实例和双节点实例下的取值范围。 | |修改 |[DeleteParameterTemplate](https://www.volcengine.com/docs/6313/1127817) |新增返回参数 TemplateId。 | |修改 |[DescribeBackupPolicy](https://www.volcengine.com/docs/6313/1127823) |新增返回参数 PublicDownloadEnable。更新返回参数 DescribeBackupPolicy 的取值范围。 | |修改 |[DescribeBackups](https://www.volcengine.com/docs/6313/170684) |更新请求参数 PageSize 的取值范围。 | |修改 |[DescribeDatabases](https://www.volcengine.com/docs/6313/170690) |更新请求参数 PageSize 的取值范围。 | |修改 |[DescribeDBAccounts](https://www.volcengine.com/docs/6313/170662) |更新请求参数 PageSize 的取值范围。 | |修改 |[DescribeDBInstanceParametersLog](https://www.volcengine.com/docs/6313/170693) |更新请求参数 PageSize 的取值范围。 | |修改 |[DescribeDBInstancePriceDetail](https://www.volcengine.com/docs/6313/1127833) |新增请求参数 ProxyNodeCustom。新增返回参数 DescribeDBInstancePriceDetailStrObject。移除返回参数 BillingMethod、Chargeltem Prices、CouponAmount、Currency、DiscountPrice、OriginalPrice、PayablePrice、Quantity 和 RefundAmount。 | |修改 |[DescribeDBInstances](https://www.volcengine.com/docs/6313/170652) |* 新增请求参数 StorageType。新增返回参数 DisasterRecoveryInstances。|\ | | |* 更新请求参数 PageSize 的取值范围。 | |修改 |[DescribeDBInstanceSpecs](https://www.volcengine.com/docs/6313/1127832) |更新请求参数 InstanceType 的取值范围。 | |修改 |[DescribeTagsByResource](https://www.volcengine.com/docs/6313/1127809) |更新请求参数 PageNumber 和 PageSize 的描述信息。 | |修改 |[ListParameterTemplates](https://www.volcengine.com/docs/6313/1127819) |新增请求参数 TemplateName。 | |修改 |[MigrateToOtherZone](https://www.volcengine.com/docs/6313/1158243) |为接口新增注意事项。 | |修改 |[ModifyAllowList](https://www.volcengine.com/docs/6313/170677) |为参数 SecurityGroupIds 与 SecurityGroupBindInfos 新增限制信息。 | |修改 |[ModifyBackupPolicy](https://www.volcengine.com/docs/6313/1127808) |新增返回参数 PublicDownloadEnable。更新请求参数 DataKeepPolicyAfterReleased 的取值范围。 | |修改 |[ModifyDBEndpoint](https://www.volcengine.com/docs/6313/170657) |* 更新请求参数 Nodes、AutoAddNewNodes、ReadOnlyNodeDistributionType、OverloadProtection、MasterProtectorTimeout、MasterNodeRouting、ConnectAllSlaveNodes、ConnectionMode 的描述信息。|\ | | |* 新增请求参数 MasterNodeRouting、ImplicitTransSplit、OverloadProtection 和 MasterProtectorTimeout。|\ | | |* 更新请求参数 ReadOnlyNodeDistributionType 的取值范围。 | |修改 |[ModifyDBInstanceParameters](https://www.volcengine.com/docs/6313/170692) |更新请求参数 ParamApplyScope 的描述信息。 | |修改 |[ModifyDBInstanceSSL](https://www.volcengine.com/docs/6313/1127828) |新增请求参数 SwitchType、SpecifiedSwitchStartTime 和 SpecifiedSwitchEndTime。 | |修改 |[ModifyDBNodeSpec](https://www.volcengine.com/docs/6313/1359332) |更新请求参数 StorageSpace 的描述信息。 | |修改 |[ModifyDBProxy](https://www.volcengine.com/docs/6313/1353777) |* 新增请求参数 ConvertDefaultEndpoint。|\ | | |* 为接口增加注意事项。 | |修改 |[ModifyDBProxySpec](https://www.volcengine.com/docs/6313/1353776) |移除接口失效的注意事项。新增返回参数 OrderId。 | |修改 |[ModifyParameterTemplate](https://www.volcengine.com/docs/6313/1127815) |新增返回参数 TemplateId。 | |修改 |[ModifyReadOnlyNodeDelayReplicationTime](https://www.volcengine.com/docs/6313/1189691) |为接口增加注意事项。 | |修改 |[ModifyTask](https://www.volcengine.com/docs/6313/1213146) |为接口增加取消任务的注意事项。 | |修改 |[RebuildDBInstance](https://www.volcengine.com/docs/6313/1127820) |新增请求参数 ProxyNodeCustom、BackupId、StorageType、StorageSpace、VpcId、InstanceName、DBParamGroupId、ChargeInfo、NodeInfo、SubnetId、InstanceTags、AllowListIds、Port、AutoStorageScalingConfig 和 DeletionProtection。新增 InstanceId 和 OrderId。 | |修改 |[RestoreToCrossRegionInstance](https://www.volcengine.com/docs/6313/1257350) |新增请求参数 ProxyNodeCustom。 | |修改 |[RestoreToExistedInstance](https://www.volcengine.com/docs/6313/170704) |新增请求参数 FastMode。 | |修改 |[RestoreToNewInstance](https://www.volcengine.com/docs/6313/170703) |新增请求参数 ProxyNodeCustom。 | |修改 |[SaveAsParameterTemplate](https://www.volcengine.com/docs/6313/1127831) |新增返回参数 TemplateId。 | |修改 |[CopyParameterTemplate](https://www.volcengine.com/docs/6313/1127816)|新增请求参数 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](https://www.volcengine.com/docs/6313/1359338) |新增接口。 | |[CreateDBNodes](https://www.volcengine.com/docs/6313/1359331) |^^| |[CreateDiagnosticsTask](https://www.volcengine.com/docs/6313/1359335) |^^| |[DeleteDBNodes](https://www.volcengine.com/docs/6313/1359333) |^^| |[DescribeBackupStats](https://www.volcengine.com/docs/6313/1359340) |^^| |[DescribeCrossRegionBackupDBInstances](https://www.volcengine.com/docs/6313/1359342) |^^| |[DescribeDBInstanceEngineMinorVersions](https://www.volcengine.com/docs/6313/1394645) |^^| |[DescribeDeletedDBInstances](https://www.volcengine.com/docs/6313/1359341) |^^| |[DescribeDiagnosticsInfos](https://www.volcengine.com/docs/6313/1359336) |^^| |[ModifyDBInstanceAutoUpgradeEngineMinorVersion](https://www.volcengine.com/docs/6313/1394647) |^^| |[ModifyDBInstanceGlobalReadOnly](https://www.volcengine.com/docs/6313/1359334) |^^| |[ModifyDBNodeSpec](https://www.volcengine.com/docs/6313/1359332) |^^| |[ModifyDBNodeTemporarySpec](https://www.volcengine.com/docs/6313/1359329) |^^| |[ModifyDBProxy](https://www.volcengine.com/docs/6313/1353777) |^^| |[ModifyDBProxySpec](https://www.volcengine.com/docs/6313/1353776) |^^| |[RemoveDiagnosticsEntity](https://www.volcengine.com/docs/6313/1359337) |^^| |[UpgradeDBInstanceEngineMinorVersion](https://www.volcengine.com/docs/6313/1394646) |^^| |公共结构体 \- BackupExtraOptionObject |新增结构体。 | |公共结构体 \- CheckModifyDBProxyAllowedV2Object |^^| |公共结构体 \- CRBackupServingInstanceInfoObject |^^| |公共结构体 \- DeletedDBInstanceInfoObject |^^| |公共结构体 \- DiagnosticsEcsInfoObject |^^| |公共结构体 \- DiagnosticsEndpointInfo |^^| |公共结构体 \- DiagnosticsInfoObject |^^| |公共结构体 \- DiagnosticsItemInfoObject |^^| |公共结构体 \- DiagnosticsPublicAddressInfoObject |^^| |公共结构体 \- ProxyInfoObject |^^| |公共结构体 \- ProxyNodeCustomObject |^^| |公共结构体 \- ProxyResourceInfoObject |^^| |公共结构体 \- UsageStatObject |^^| |[CopyParameterTemplate](https://www.volcengine.com/docs/6313/1127816) |增加可选请求参数 ProjectName。 | |[CreateAllowList](https://www.volcengine.com/docs/6313/170674) |^^| |[CreateDBAccount](https://www.volcengine.com/docs/6313/170659) |* 新增请求参数 DryRun。|\ | |* 新增返回参数 CreateAccountSQL。|\ | |* 更新请求参数 AccountName 的描述信息，增加取值规则。 | |[CreateDBInstance](https://www.volcengine.com/docs/6313/170648) |* 请求参数 StorageSpace 由可选调整为必选。|\ | |* 更新请求参数 InstanceTags 的描述信息。 | |[CreateDBEndpoint](https://www.volcengine.com/docs/6313/170670) |* 新增以下请求参数：|\ | | * ConnectionMode|\ | | * ConnectionPoolType|\ | | * IdleConnectionReclaim|\ | | * MultiStatementsMode|\ | | * ReadOnlyNodeDistributionType|\ | | * ReadOnlyNodeMaxDelayTime|\ | | * ReadOnlyNodeWeight|\ | | * ReadWriteSpliting|\ | |* 更新以下请求参数的描述信息：|\ | | * ReadWriteMode | |[CreateParameterTemplate](https://www.volcengine.com/docs/6313/1127813) |增加可选请求参数 ProjectName。 | |[DeleteAllowList](https://www.volcengine.com/docs/6313/170680) |^^| |[DeleteDBInstance](https://www.volcengine.com/docs/6313/170649) |更新请求参数 DataKeepPolicy 的取值范围。 | |[DeleteParameterTemplate](https://www.volcengine.com/docs/6313/1127817) |增加可选请求参数 ProjectName。 | |[DescribeAllowListDetail](https://www.volcengine.com/docs/6313/170676) |^^| |[DescribeAllowLists](https://www.volcengine.com/docs/6313/170675) |* 新增请求参数 QueryDefault。|\ | |* 增加可选请求参数 ProjectName。|\ | |* 新增请求参数 IPAddress。 | |[DescribeBackupPolicy](https://www.volcengine.com/docs/6313/1127823) |* 新增以下返回参数：|\ | | * BinlogBackupAllRetention|\ | | * BinlogBackupEnabled|\ | | * BinlogBackupEncryptionEnabled|\ | | * DataBackupAllRetention|\ | | * DataBackupEncryptionEnabled|\ | | * DataFullBackupStartUTCHour|\ | | * DataKeepDaysAfterReleased|\ | | * DataKeepPolicyAfterReleased|\ | | * HourlyIncrBackupEnable|\ | | * IncrBackupHourPeriod|\ | | * RetentionPolicySynced|\ | |* 更新以下返回参数的描述信息：|\ | | * DataBackupRetentionDay|\ | | * DataFullBackupTime|\ | | * DataIncrBackupPeriods|\ | | * LogBackupRetentionDay|\ | |* 更新以下返回参数的取值范围信息：|\ | | * DataBackupRetentionDay|\ | | * LogBackupRetentionDay|\ | |* 更新返回示例。 | |[DescribeBackups](https://www.volcengine.com/docs/6313/170684) |* 更新请求参数 InstanceId 的可选性，并修改其描述信息。|\ | |* 新增请求参数 Option。|\ | |* 更新返回参数 DBTableInfos 的描述信息。|\ | |* 更新请求参数 BackupStartTime 和 BackupEndTime 的描述信息。 | |[DescribeBinlogFiles](https://www.volcengine.com/docs/6313/773296) |* 新增请求参数 ResultSorter。|\ | |* 更新请求参数 Context 为可选。 | |[DescribeDBInstanceDetail](https://www.volcengine.com/docs/6313/170653) |新增返回参数 ProxyDetail。 | |[DescribeDBInstancePriceDetail](https://www.volcengine.com/docs/6313/1127833) |增加可选请求参数 ProjectName。 | |[DescribeDBInstances](https://www.volcengine.com/docs/6313/170652) |* 新增请求参数 PrivateNetworkIpAddress、KernelVersion 和 PrivateNetworkVpcId。|\ | |* 更新请求参数 InstanceStatus 的取值范围。|\ | |* 更新请求参数 PageNumber 和 PageSize 的描述信息。 | |[DescribeDBProxyConfig](https://www.volcengine.com/docs/6313/1127821) |* 新增返回参数 CheckModifyDBProxyAllowedV2 和 ProxyResourceInfo。|\ | |* 更新返回参数 BinlogDump、DBProxyStatus 和 CheckModifyDBProxyAllowed 的描述信息。 | |[DescribeParameterTemplate](https://www.volcengine.com/docs/6313/1127818) |增加可选请求参数 ProjectName。 | |[DescribePlannedEvents](https://www.volcengine.com/docs/6313/1127834) |* 增加可选请求参数 ProjectName。|\ | |* 更新请求参数 Status 的取值范围。 | |[DescribeRecoverableTime](https://www.volcengine.com/docs/6313/170685) |更新请求参数 RestoreType 的描述信息。 | |[DescribeTasks](https://www.volcengine.com/docs/6313/1127812) |更新请求参数 TaskStatus 和 TaskCategory 的取值范围。 | |[GetBackupDownloadLink](https://www.volcengine.com/docs/6313/170686) |请求参数 BackupFileSize 的类型从 Integer 更新为 Long。 | |[GrantDBAccountPrivilege](https://www.volcengine.com/docs/6313/170663) |* 新增请求参数 DryRun。|\ | |* 新增返回参数 CreateAccountSQL。 | |[ListParameterTemplates](https://www.volcengine.com/docs/6313/1127819) |增加可选请求参数 ProjectName。 | |[MigrateToOtherZone](https://www.volcengine.com/docs/6313/1158243) |* 修改请求参数 SwitchType 的描述信息。|\ | |* 新增请求参数 SpecifiedSwitchStartTime 和 SpecifiedSwitchEndTime。 | |[ModifyAllowList](https://www.volcengine.com/docs/6313/170677) |* 新增请求参数 IgnoreInstanceStatus。|\ | |* 增加可选请求参数 ProjectName。 | |[ModifyBackupPolicy](https://www.volcengine.com/docs/6313/1127808) |* 新增以下请求参数：|\ | | * 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](https://www.volcengine.com/docs/6313/1127838) |更新请求参数 BackupEnabled 与 LogBackupEnabled 的默认值。 | |[ModifyDBEndpoint](https://www.volcengine.com/docs/6313/170657) |* 新增以下请求参数：|\ | | * ConnectionMode|\ | | * MultiStatementsMode|\ | |* 修改以下请求参数的描述信息：|\ | | * ReadWriteMode | |[ModifyDBInstanceSpec](https://www.volcengine.com/docs/6313/170651) |为接口增加注意事项，该接口已弃用。 | |[ModifyParameterTemplate](https://www.volcengine.com/docs/6313/1127815) |增加可选请求参数 ProjectName。 | |[ModifyPlannedEventExecuteTime](https://www.volcengine.com/docs/6313/1127835) |* 增加可选请求参数 ProjectName 和 TaskEventOperation。|\ | |* 增加必选请求参数 InstanceId。|\ | |* 修改请求参数 ModifyBeginTime 和 ModifyEndTime 为可选。 | |[ModifyTask](https://www.volcengine.com/docs/6313/1213146) |* 新增请求参数 TaskEventOperation、ModifyBeginTime、ModifyEndTime 和 ProjectName。|\ | |* 移除请求参数 ModifyType 和 SwitchTime。 | |[RebuildDBInstance](https://www.volcengine.com/docs/6313/1127820) |* 新增请求参数 RequestSource。|\ | |* 更新请求参数 ProjectName 的描述信息。 | |[RestartDBInstance](https://www.volcengine.com/docs/6313/170650) |* 修改请求参数 SwitchType 的描述信息。|\ | |* 新增请求参数 SpecifiedSwitchStartTime 和 SpecifiedSwitchEndTime。 | |[toreToCrossRegionInstance](https://www.volcengine.com/docs/6313/1257350) |更新请求参数 StorageType 和 InstanceTags 的描述信息。 | |[RestoreToExistedInstance](https://www.volcengine.com/docs/6313/170704) |更新请求参数 RestoreType 的描述信息。 | |[RestoreToNewInstance](https://www.volcengine.com/docs/6313/170703) |更新请求参数 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 为必选项。 |

云数据库 MySQL 版