调用 DescribeBackupPolicy 接口查询指定实例的备份策略。
同步请求。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
InstanceId | String | 是 | mysql-d4942fd7**** | 实例 ID。 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
InstanceId | String | mysql-d4942fd7**** | 实例 ID。 |
DataFullBackupPeriods | Array of String | ["Monday","Wednesday","Friday",Sunday"] | 全量备份周期。取值:
|
DataBackupRetentionDay | Integer | 7 | 数据备份保留天数,取值:7~365 天。默认保留 7 天。 |
DataFullBackupTime | String | 18:00Z-00:00Z | 执行备份任务的时间,间隔窗口为 6 小时。格式:HH:mmZ-HH:mmZ(UTC 时间)。 |
DataIncrBackupPeriods | Array of String | ["Monday","Wednesday","Friday","Sunday"] | 增量备份周期,取值:
|
BinlogFileCountsEnable | Boolean | true | 是否开启本地 Binlog 保留上限。取值:
|
BinlogLimitCount | Integer | 10 | 本地 Binlog 保留个数,取值范围为 6~1000 。超过指定保留个数后,会自动删除超过保留个数的本地日志。 |
BinlogLocalRetentionHour | Integer | 7 | 本地 Binlog 保留时长,取值范围为 0~168 。超过指定保留时长后,会自动删除超过保留时长的本地日志。当设置为 0 时,不自动删除本地日志。 |
BinlogSpaceLimitEnable | Boolean | true | 是否开启空间过大自动清理 Binlog。当实例总存储空间占用率超过 80% 或者剩余空间不足 5GB 时,系统会自动开始清理最早的本地 Binlog,直至总空间占用率低于 80% 且剩余空间大于 5GB。 |
BinlogStoragePercentage | Integer | 30 | 最大存储空间使用率,可设置 20%~50%,超出后自动删除最早的 Binlog 文件,直到空间使用率低于该比例。 说明 本地 Binlog 空间使用率 = 本地 Binlog 大小/实例总可用(购买)空间大小。 |
LogBackupRetentionDay | Integer | 7 | Binlog 备份保留时长。取值范围:7~365 天。 |
LockDdlTime | Integer | 30 | DDL 最长等待时间。默认值为 30,最小值为 10,最大值为 1440, 单位为分钟。 说明 仅 MySQL 8.0 版本实例支持此设置。 |
POST /?Action=DescribeBackupPolicy&Version=2022-01-01 HTTP/1.1 Accept: application/json Content-Type: application/json Host: rds.volcengineapi.com X-Date: 20230810T101010Z Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20230810/cn-beijing/rds_mysql/request, SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645a**** { "InstanceId":"mysql-d4942fd7****" }
{ "ResponseMetadata": { "RequestId": "202308101124409984CE8C71ABEA55A2B8", "Action": "DescribeBackupPolicy", "Version": "2022-01-01", "Service": "rds_mysql", "Region": "cn-beijing" }, "Result": { "BinlogFileCountsEnable": false, "BinlogLimitCount": 60, "BinlogLocalRetentionHour": 24, "BinlogSpaceLimitEnable": false, "BinlogStoragePercentage": 30, "DataBackupRetentionDay": 7, "DataFullBackupPeriods": [ "Tuesday", "Thursday", "Saturday" ], "DataFullBackupTime": "18:00Z-00:00Z", "DataIncrBackupPeriods": [ "Monday" ], "InstanceId": "mysql-d4942fd7****", "LockDDLTime": 30, "LogBackupRetentionDay": 7 } }
更多详情,请参见错误码。