修改备份策略
更新时间：2025-01-02
说明
- 默认每天凌晨一点开始备份。
- 云数据库 RDS 赠送您50%*本地磁盘空间大小的备份存储空间。
- 备份超过免费空间时会自动删除旧备份。若您设置了允许备份超过免费赠送空间，则超过该大小的备份存储将会额外计费，详情请参考备份存储计费。
请求结构
Plain Text
1PUT /v{version}/instance/{instanceId}?modifyBackupPolicy HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: authorization string
4{
5 "backupDays": "backupDays",
6 "backupTime": "backupTime",
7 "persistent": persistent,
8 "expireInDays": expireInDays
9}请求头域
除公共头域外，无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | Integer | 是 | URL参数 | API 版本号 |
| instanceId | String | 是 | URL参数 | 指定实例 ID |
| backupDays | String | 是 | RequestBody参数 | 以英文半角逗号分隔的备份时日间，周日为第一天，取值0 举例："0,1,2,3,5,6" |
| backupTime | String | 是 | RequestBody参数 | 备份开始时间,这里的时间是用的UTC时间 |
| persistent | Boolean | 是 | RequestBody参数 | 是否启用备份数据持久化 |
| expireInDays | Integer | 否 | RequestBody参数 | 数据备份保留时长，范围1-730天；未启用则为0或不填 |
| logBackupRetainDays | Integer | 否 | RequestBody参数 | 日志备份保留时长，范围1-730天；未启用则为0或不填 |
| dataBackupType | String | 否 | RequestBody参数 | 类型：physical（物理）、snapshot（快照），仅支持MySQL |
| incrementalDataBackupEnable | Boolean | 否 | RequestBody参数 | 是否开启高频备份，默认为 false |
| incrementalDataBackupInterval | Integer | 否 | RequestBody参数 | 增量数据备份间隔（秒）最小粒度是小时级别，开启高频备份后必传，值需要可以被3600整除 |
| latestDataBackupRetainDays | Integer | 否 | RequestBody参数 | 最新数据备份保留天数（实例删除后），天级别，不传默认0天 |
| retentionPeriod | Integer | 否 | RequestBody参数 | 增量备份保留时长 |
| timeUnit | String | 否 | RequestBody参数 | 增量备份保留策略时长单位，取值为 week、month，默认为 week |
| dataBackupCopyEnable | Boolean | 否 | RequestBody参数 | 标识是否开启跨地域备份，默认为false |
| dataBackupCopyStoragesRegions | List String | 否 | RequestBody参数 | 表示跨地域备份支持的地域列表，此处暂时只支持单个地域，若填写多个地域，默认取列表中的第一个地域，取值可包括：["bj","gz","bd","su","hkg","fwh","fsh","yq","cd","nj"] |
| dataBackupCopyRetainDays | Integer | 否 | RequestBody参数 | 跨地域备份保留时长支持1-730天 |
返回头域
除公共头域，无其它特殊头域。
返回参数
无特殊返回参数
请求示例
Plain Text
1PUT /v1/instance/r-mfj4jsd9?modifyBackupPolicy HTTP/1.1
2HOST: rds.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5{
6 "backupDays": "0,1,2,3,4,5,6",
7 "backupTime": "17:00:00Z",
8 "persistent": true,
9 "expireInDays": 10
10}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3Content-Type: application/json