ModifyBackupPolicy - 修改备份策略_数据管理（兼容数据库备份）(DMS)-阿里云帮助中心

修改PolarDB实例备份策略。

接口说明

适用引擎

PolarDB MySQL 版

说明当前该接口仅针对特定客户开放使用，如有需求，请到 DBS 客户咨询群（钉钉群号：35585947）申请使用。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
RegionCode	string	否	备份集所在地域。	cn-shanghai
PreferredBackupWindowBegin	string	否	基础备份窗口开始时间。	17:00Z
InstanceName	string	否	PolarDB 实例 ID。	pc-2ze3nrr64c5****
AdvanceDataPolicies	object []	否	数据备份策略详情。
ActionType	string	否	操作类型，取值如下： CREATE：新增 UPDATE：修改 DELETE：删除	UPDATE
PolicyId	string	否	高级策略 ID，可调用 DescribeBackupPolicy 查看。	6s67c7i3y8f8p72808p******
FilterType	string	否	高级策略筛选类型，取值如下： crontab：周期调度 event：事件调度	crontab
FilterKey	string	否	调度类型，取值如下： dayOfWeek：按周调度 dayOfMonth：按月调度 dayOfYear：按年调度 backupInterval：固定间隔调度说明仅当 FilterType 为 crontab 时，返回该参数。	backupInterval
FilterValue	string	否	备份周期。	180
RetentionType	string	否	备份集保留周期类型，取值如下： never：永不过期 delay：固定天数过期	delay
RetentionValue	string	否	过期天数。	4
SrcType	string	否	备份策略源类型，取值如下： db：数据库 level1：一级备份 level2：二级备份 level2Cross：二级跨地域备份	db
SrcRegion	string	否	备份策略源地域。	cn-shanghai
DestType	string	否	备份策略目标类型，取值如下： db：数据库 level1：一级备份 level2：二级备份 level2Cross：二级跨地域备份	level1
DestRegion	string	否	备份策略目标地域。	cn-shanghai

返回参数

名称	类型	描述	示例值
	object	返回参数详情。
RequestId	string	请求 ID。	D570F209-A166-50C6-98A3-155A20B218B7
Message	string	返回信息。	instanceName can not be empty.
Data	object	备份策略详情。
PreferredBackupWindowBegin	string	基础备份窗口开始时间。	17:00Z
PreferredBackupWindow	string	基础备份窗口。	17:00Z-18:00Z
AdvanceDataPolicies	object []	数据备份策略详情。
PolicyId	string	高级策略 ID。	dc13b153acc91141789122c23835****
FilterType	string	高级策略筛选类型，返回值如下： crontab：周期调度 event：事件调度	crontab
FilterKey	string	调度类型，返回值如下： dayOfWeek：按周调度 dayOfMonth：按月调度 dayOfYear：按年调度 backupInterval：固定间隔调度说明仅当 FilterType 为 crontab 时，返回该参数。	backupInterval
FilterValue	string	备份周期。	180
DumpAction	string	转储策略详情，返回值如下： copy：复制 move：转储	copy
RetentionType	string	备份集保留周期类型，返回值如下： never：永不过期 delay：固定天数过期	delay
RetentionValue	string	过期天数。	4
SrcType	string	备份策略源类型，返回值如下： db：数据库 level1：一级备份 level2：二级备份 level2Cross：二级跨地域备份	db
SrcRegion	string	备份策略源地域。	cn-shanghai
DestType	string	备份策略目标类型，返回值如下： db：数据库 level1：一级备份 level2：二级备份 level2Cross：二级跨地域备份	level1
DestRegion	string	备份策略目标地域。	cn-shanghai
BakType	string	备份类型，返回值如下： F：全量备份 L：日志备份	F
AutoCreated	boolean	是否为系统自动生成的备份策略，返回值如下： true：系统生成策略 false：用户自定义策略	false
ErrMessage	string	错误信息。	The specified parameter %s value is not valid.
Code	string	状态码。	Success
Success	string	请求是否成功，返回值如下： true：请求成功 false：请求失败	true
ErrCode	string	错误码。	Success

示例

正常返回示例

JSON格式

{
  "RequestId": "D570F209-A166-50C6-98A3-155A20B218B7",
  "Message": "instanceName can not be empty.",
  "Data": {
    "PreferredBackupWindowBegin": "17:00Z",
    "PreferredBackupWindow": "17:00Z-18:00Z",
    "AdvanceDataPolicies": [
      {
        "PolicyId": "dc13b153acc91141789122c23835****",
        "FilterType": "crontab",
        "FilterKey": "backupInterval",
        "FilterValue": "180",
        "DumpAction": "copy",
        "RetentionType": "delay",
        "RetentionValue": "4",
        "SrcType": "db",
        "SrcRegion": "cn-shanghai",
        "DestType": "level1",
        "DestRegion": "cn-shanghai",
        "BakType": "F",
        "AutoCreated": false
      }
    ]
  },
  "ErrMessage": "The specified parameter %s value is not valid.",
  "Code": "Success",
  "Success": "true",
  "ErrCode": "Success"
}

错误码

HTTP status code	错误码	错误信息	描述
403	Request.Forbidden	Have no Permissions	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作

访问错误中心查看更多错误码。

变更历史

变更时间

变更内容概要

操作

2024-05-28

API 内部配置变更，不影响调用

看变更集

变更项	变更内容
	API 内部配置变更，不影响调用。