修改 DescribeDBInstanceDetail

2025-02-21

• 更新作为返回参数的 Endpoints 数据结构中 ReadOnlyNodeDistributionType 字段的取值范围。
• 更新作为返回参数的 ReadOnlyNodeWeight 数据结构中 NodeType 字段的取值范围。

-

修改 CreateDBEndpoint

• 更新请求参数 ReadOnlyNodeDistributionType 的取值范围。
• 更新作为请求参数的 ReadOnlyNodeWeight 数据结构中 NodeType 字段的取值范围。

创建连接终端

修改 公共结构体 - AccountPrivilegeObject

2025-02-13

• 更新字段 DBName、AccountPrivilege 和 AccountPrivilegeDetail 的描述信息。
• 更新 AccountPrivilege 和 AccountPrivilegeDetail 的取值范围。

• CreateDBAccount
• DescribeDBAccounts
• GrantDBAccountPrivilege

新增 ModifyDBProxy

• 开启数据库代理
• 关闭数据库代理

新增 公共结构体 - ProxyNodeCustomObject

• ModifyDBProxy
• ModifyDBProxySpec

新增 公共结构体 - ProxyResourceInfoObject

• DescribeDBInstanceDetail
• DescribeDBProxyConfig

修改 CreateDBAccount

• 新增请求参数 DryRun。
• 新增返回参数 CreateAccountSQL。
• 更新请求参数 AccountName 的描述信息，增加取值规则。

创建账号

修改 CreateDBInstance

• 请求参数 StorageSpace 由可选调整为必选。
• 更新请求参数 InstanceTags 的描述信息。

创建实例

修改 CreateDBEndpoint

• 新增以下请求参数：
  • ConnectionMode
  • ConnectionPoolType
  • IdleConnectionReclaim
  • MultiStatementsMode
  • ReadOnlyNodeDistributionType
  • ReadOnlyNodeMaxDelayTime
  • ReadOnlyNodeWeight
  • ReadWriteSpliting
• 更新以下请求参数的描述信息：
  • ReadWriteMode

创建连接终端

修改 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 为可选。

修改 DescribeDBInstances

• 新增请求参数 PrivateNetworkIpAddress、KernelVersion 和 PrivateNetworkVpcId。
• 更新请求参数 InstanceStatus 的取值范围。
• 更新请求参数 PageNumber 和 PageSize 的描述信息。

查看实例列表

修改 DescribeDBProxyConfig

• 新增返回参数 CheckModifyDBProxyAllowedV2 和 ProxyResourceInfo。
• 更新返回参数 BinlogDump、DBProxyStatus 和 CheckModifyDBProxyAllowed 的描述信息。

• 变更代理配置
• 开启数据库代理
• 关闭数据库代理

修改 DescribePlannedEvents

• 增加可选请求参数 ProjectName。
• 更新请求参数 Status 的取值范围。

查看运维事件

修改 GrantDBAccountPrivilege

• 新增请求参数 DryRun。
• 新增返回参数 CreateAccountSQL。

修改账号权限

修改 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
• 更新接口的请求示例和返回示例。

修改备份策略

修改 ModifyDBEndpoint

• 新增以下请求参数：
  • ConnectionMode
  • MultiStatementsMode
• 修改以下请求参数的描述信息：
  • ReadWriteMode

编辑连接终端

修改 ModifyPlannedEventExecuteTime

• 增加可选请求参数 ProjectName 和 TaskEventOperation。
• 增加必选请求参数 InstanceId。
• 修改请求参数 ModifyBeginTime 和 ModifyEndTime 为可选。

推迟运维事件执行时间

修改 ModifyTask

• 新增请求参数 TaskEventOperation、ModifyBeginTime、ModifyEndTime 和 ProjectName。
• 移除请求参数 ModifyType 和 SwitchTime。

• 修改任务执行时间
• 取消任务

修改 RebuildDBInstance

• 新增请求参数 RequestSource。
• 更新请求参数 ProjectName 的描述信息。

重建实例

修改 RestartDBInstance

• 修改请求参数 SwitchType 的描述信息。
• 新增请求参数 SpecifiedSwitchStartTime 和 SpecifiedSwitchEndTime。

重启实例

修改 RestoreToCrossRegionInstance

更新请求参数 StorageType 和 InstanceTags 的描述信息。

• 按备份集跨地域恢复到新实例
• 按时间点跨地域恢复到新实例

修改 RestoreToNewInstance

更新请求参数 StorageType 和 InstanceTags 的描述信息。

• 按备份集恢复到新实例
• 按时间点恢复到新实例

修改 公共结构体 - AccountPrivilegesObject

更新字段 DBName 的描述信息。

• DescribeDBAccounts
• GrantDBAccountPrivilege

修改 公共结构体 - BasicInfoObject

• 新增参数 BasicBackupBinlogSize、BasicBackupDataSize、BackupFreeQuotaSize、CurrentKernelVersion 和 AutoUpgradeMinorVersion。
• 更新参数 InstanceStatus 的描述信息。

DescribeDBInstanceDetail

修改 公共结构体 - ChargeInfo

修改 ChargeType、AutoRenew、PeriodUnit、Period 和 Number 字段的描述信息。

• CreateDBInstance
• RestoreToNewInstance
• RestoreToCrossRegionInstance

修改 公共结构体 - EndpointObject

新增以下字段：

• ConnectionMode
• ConnectionPoolType
• MultiStatementsMode
• ReadOnlyNodeDistributionType
• ReadOnlyNodeMaxDelayTime

DescribeDBInstanceDetail

修改 公共结构体 - NodeInfoObject

更新字段 NodeId、ZoneId、NodeType 和 NodeOperateType 的描述信息。

• CreateDBInstance
• DescribeDBInstancePriceDetail
• ModifyDBInstanceType
• MigrateToOtherZone-
• RestoreToNewInstance
• RestoreToCrossRegionInstance
• ModifyDBNodeTemporarySpec
• CreateDBNodes
• ModifyDBNodeSpec

修改 公共结构体 - PlannedEvent

• 新增字段 PlannedSwitchBeginTime 和 PlannedSwitchEndTime。
• 移除字段 IsUrgent。

DescribePlannedEvents

修改 公共结构体 - TableObject

更新字段 NewTableName 的描述信息，增加该字段的取值规则。

• RestoreToNewInstance
• RestoreToExistedInstance

修改 公共结构体 - TaskInfoObject

• 新增字段 ScheduledExecuteEndTime、ScheduledExecuteStartTime、ScheduledSwitchEndTime 和 ScheduledSwitchStartTime。
• 更新字段 TaskCategory 和 TaskStatus 的取值范围。
• 移除字段 ConfigInfos。

DescribeTasks

修改 CreateParameterTemplate

• 新增返回参数 TemplateId。

• 修改请求参数 TemplateType 的取值为 Mysql。

• 更新返回示例。

创建参数模板

修改 RestoreToNewInstance

• 按备份集恢复到新实例

• 按时间点恢复到新实例

修改 RestoreToCrossRegionInstance

• 按备份集跨地域恢复到新实例

• 按时间点跨地域恢复到新实例

修改 InstanceParamObject

新增参数 ExpectValue 和 Expression。

• 创建参数模板

• 管理参数模板

修改 NodeInfoObject

更新 NodeInfoObject 参数 NodeSpec 和 ZoneId 的描述信息。

• 创建实例

• 查看实例信息

• 常规变配

• 变更实例类型

• 迁移可用区

• 按备份集恢复到新实例

• 按时间点恢复到新实例

• 按备份集跨地域恢复到新实例

• 按时间点跨地域恢复到新实例

修改 RestoreToExistedInstance

请求参数 RestoreType 和 TableMeta 由可选改必选。

• 按备份集恢复到原实例
• 按时间点恢复到原实例

修改 AssociateAllowList

2024-07-25

更新请求参数 InstanceIds 和 AllowListIds 的描述信息，增加数量限制信息。

• 绑定白名单到实例
• 绑定实例到白名单

修改 CreateBackup

• 为请求参数 BackupMethod 增加取值 Logical。
• 为请求参数 BackupType 增加取值 DumpAll，并更新相关描述信息。
• 为请求参数 BackupMeta 补充前提条件、互斥情况和数量限制。
• 增加示例：创建备份方式为全库备份的逻辑备份、创建备份方式为库表备份的逻辑备份
• 更新返回参数。

手动创建数据备份

修改 CreateDBInstance

• 新增请求参数 MaintenanceWindow，并更新请求示例。
• 更新参数 SuperAccountPassword 的取值范围。

创建实例

修改 DescribeBackups

• 新增请求参数 CreateType。
• 为请求参数 BackupMethod 补充取值 Logical，并更新请求示例。
• 为请求参数 BackupType 增加取值 DumpAll，并更新相关描述信息。
• 为请求参数 BackupId、BackupStatus、BackupMethod、BackupType 补充默认值相关的说明。
• 更新返回示例。

查看数据备份列表

修改 DescribeDBInstances

• 新增请求参数 InstanceType、NodeSpec 和 TagFilters。
• 更新返回示例。

查看实例列表

修改 GetBackupDownloadLink

• 修改返回参数 DownloadProgress 的类型为 Long。
• 更新接口注意事项。
• 更新请求参数 BackupId 的描述信息。
• 新增返回参数 InnerBackupDownloadLink。
• 更新返回参数 BackupFileName 和 BackupId 的描述信息。
• 更新返回参数 BackupFileSize 的单位。
• 更新返回示例。

• 下载 Binlog 备份
• 下载数据备份文件

修改 RestoreToExistedInstance

更新请求参数 BackupId 的描述信息。

• 按备份集恢复到新实例
• 按时间点恢复到新实例

修改 RestoreToNewInstance

• 按备份集恢复到原实例
• 按时间点恢复到原实例

修改 数据结构 - 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。

修改 数据结构 - 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 的描述信息。

修改 CreateDBInstance

• 新增请求字段 Port，更新请求示例（新增 Port 字段）。
• 更新请求字段 VpcId 和 SubnetId 的示例值和描述信息。
• 修改请求字段 SuperAccountName 的描述信息。

创建实例

修改 DescribeBinlogFiles

• 更新返回字段 BinlogFiles 的示例值。
• 更新返回示例，为每个返回的 BinlogFilesObject 增加 NodeId。
• 修改字段 BackupFileNumber 的取值上限：500 > 250。

查看日志备份列表

修改 ModifyDBEndpointAddress

• 在接口描述新增说明事项。
• 在请求字段 Port 的描述信息增加说明。

修改连接地址前缀和端口

修改 ModifyDBInstanceChargeType

• 修改接口的描述信息。
• 修改请求字段 PeriodUnit 和 Period 为可选。

• 按量计费转包年包月
• 包年包月转按量计费

修改 ModifyTask

• 新增请求字段 InstanceId。
• 更新请求示例和返回示例。

修改任务执行时间

修改 RestoreToNewInstance

• 新增请求字段 Port，更新请求示例（新增 Port 字段）。
• 更新请求字段 VpcId 和 SubnetId 的示例值和描述信息。

• 按备份集恢复到新实例
• 按时间点恢复到新实例

修改 公共结构体 - InstanceParamObject

• 增加说明。
• 为字段 DefaultValue、Description、Restart 和 ValueRange。

修改 CreateDBAccount

• 新增必选请求参数 AccountType。
• 更新请求参数 AccountName、AccountPassword 为必选项。
• 删除了请求参数 AccountPrivilegesInfo。

创建账号

修改 CreateDatabase

• 更新请求参数 DBName 为必选项。
• 删除了请求参数 DatabasePrivilegesInfo。

创建数据库

修改 DescribeDBAccounts

• 返回参数删除了 AccountsInfo 字段。
• 返回参数 Accounts 嵌套对象删除了字段AccountPrivilegesInfo。

-

修改 DownloadBackup

更新请求参数 BackupId 为必选项。

• 下载数据备份文件
• 下载 Binlog 备份

修改 ModifyDBInstanceChargeType

更新请求参数 ChargeType、Period、PeriodUnit 为必选项。

• 按量计费转包年包月
• 包年包月转按量计费

修改 RestoreToExistedInstance

更新请求参数 SourceDBInstanceId 为必选项。

• 按备份集恢复到原实例
• 按时间点恢复到原实例