修改PolarDB集群的自动备份策略。
接口说明
您也可以通过控制台修改 PolarDB 集群的自动备份策略。具体信息,请参见备份设置。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
polardb:ModifyBackupPolicy |
update |
*dbcluster
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
DBClusterId |
string |
是 |
集群 ID。 说明
您可以调用 DescribeDBClusters 接口查看目标地域下所有的集群信息,包括集群 ID。 |
pc-bp13wz9586voc**** |
PreferredBackupTime |
string |
否 |
执行自动备份的时间段,格式为 |
15:00Z-16:00Z |
PreferredBackupPeriod |
string |
否 |
备份周期,取值范围如下:
说明
|
Monday,Tuesday |
DataLevel1BackupRetentionPeriod |
string |
否 |
一级备份保留周期,取值范围为 3~14,单位为天。 |
3 |
DataLevel2BackupRetentionPeriod |
string |
否 |
二级备份保留周期,取值范围如下:
说明
创建集群时,默认取值为 0,即关闭二级备份功能。 |
0 |
BackupRetentionPolicyOnClusterDeletion |
string |
否 |
删除集群时是否保留备份:
说明
默认取值为 NONE。 |
NONE |
BackupFrequency |
string |
否 |
备份频率,取值如下:
说明
|
Normal |
DataLevel1BackupFrequency |
string |
否 |
备份频率,取值如下:
说明
|
Normal |
DataLevel1BackupTime |
string |
否 |
执行自动备份的时间段,格式为 说明
|
15:00Z-16:00Z |
DataLevel1BackupPeriod |
string |
否 |
一级备份周期,取值范围如下:
说明
|
Monday,Tuesday |
DataLevel2BackupPeriod |
string |
否 |
二级备份周期,取值范围如下:
说明
|
Monday,Tuesday |
DataLevel2BackupAnotherRegionRegion |
string |
否 |
二级备份跨地域备份区域。跨地域备份支持的地域请参见概述。 |
cn-hangzhou |
DataLevel2BackupAnotherRegionRetentionPeriod |
string |
否 |
二级备份跨地域备份保留周期。取值范围如下:
说明
创建集群时,默认取值为 0,即关闭二级备份跨地域备份功能。 |
30 |
BackupPolicyLevel |
string |
否 |
||
AdvancedDataPolicies |
array<object> |
否 |
||
object |
否 |
|||
ActionType |
string |
否 |
||
OnlyPreserveOneEachHour |
boolean |
否 |
||
RetentionValue |
string |
否 |
||
BakType |
string |
否 |
||
FilterKey |
string |
否 |
||
FilterValue |
string |
否 |
||
DestType |
string |
否 |
||
FilterType |
string |
否 |
||
SrcRegion |
string |
否 |
||
AutoCreated |
boolean |
否 |
||
SrcType |
string |
否 |
||
OnlyPreserveOneEachDay |
boolean |
否 |
||
DumpAction |
string |
否 |
||
PolicyId |
string |
否 |
||
DestRegion |
string |
否 |
||
RetentionType |
string |
否 |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
|||
RequestId |
string |
请求 ID。 |
C5A5DF0E-5968-4DC1-882E-AC2FE7****** |
示例
正常返回示例
JSON
格式
{
"RequestId": "C5A5DF0E-5968-4DC1-882E-AC2FE7******"
}
异常返回示例
JSON
格式
{
"RequestId":"C5A5DF0E-5968-4DC1-882E-AC2FE7067C88"
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | InvalidDataLevel1BackupRetentionPeriod.Malformed | The specified parameter DataLevel1BackupRetentionPeriod is not valid. | 操作失败,一级备份保留周期(DataLevel1BackupRetentionPeriod )参数无效。 |
400 | InvalidDataLevel2BackupRetentionPeriod.Malformed | The specified parameter DataLevel2BackupRetentionPeriod is not valid. | 操作失败,二级备份保留周期(DataLevel2BackupRetentionPeriod )参数无效。 |
400 | InvalidBackupRetentionPeriod.Malformed | The specified parameter BackupRetentionPeriod is not valid. | 操作失败,备份保留周期(BackupRetentionPeriod)参数无效。 |
400 | InvalidBackupFrequency.Malformed | The specified parameter BackupFrequency is not valid. | 操作失败,备份频率(BackupFrequency )参数无效。 |
400 | InvalidPreferredBackupPeriod.Malformed | The specified parameter PreferredBackupPeriod is not valid. | 操作失败,数据备份周期(PreferredBackupPeriod)无效。 |
400 | InvalidDataLevel2BackupPeriod.Malformed | The specified parameter DataLevel2BackupPeriod is not valid. | 指定的参数DataLevel2BackupPeriod无效 |
400 | InvalidDataLevel1BackupPeriod.Malformed | The specified parameter DataLevel1BackupPeriod is not valid. | 指定的参数DataLevel1BackupPeriod无效。 |
400 | InvalidPreferredBackupTime.Malformed | The specified parameter PreferredBackupTime is not valid. | 操作失败,执行自动备份的时间段( PreferredBackupTime)无效。 |
400 | InvalidDataLevel1BackupTime.Malformed | The specified parameter DataLevel1BackupTime is not valid. | 指定的参数DataLevel1BackupTime无效。 |
400 | InvalidDataLevel1BackupFrequency.Malformed | The specified parameter DataLevel1BackupFrequency is not valid. | 指定的参数DataLevel1BackupFrequency无效。 |
400 | InvalidDataLevel2AnotherRegionRegion.NotFound | The specified parameter DataLevel2BackupAnotherRegionRegion does not found. | 找不到指定的参数DataLevel2BackupAnotherRegionRegion。 |
400 | InvalidDataLevel2AnotherRegionBackupRetentionPeriod.Malformed | The specified parameter DataLevel2BackupAnotherRegionRetentionPeriod is not valid. | 指定的参数DataLevel2BackupAnotherRegionRetentionPeriod无效。 |
403 | IncorrectBackupPolicy | Current DB type does not support low frequency backupPolicy operation. | 当前DB类型不支持低频备份操作 |
404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | 当前的记录中不存在提供的DBClusterId。 |
404 | InvalidDBClusterId.NotFound | The DBClusterId provided does not exist in our records. | 当前的记录中不存在提供的 DBClusterId。 |
404 | InvalidParam | new archiveBackup policy already exists. dumpretention parameter cannot used alone | 新的archiveBackup策略已存在。dumpretention参数不能单独使用 |
404 | InvalidDBClusterId.Malformed | The specified parameter DBClusterId is not valid. | 指定的参数DBClusterId无效 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。