更新时间:2024-10-22 GMT+08:00

设置自动备份策略

功能介绍

设置自动备份策略。

该接口计划于2025-03-31下线,建议及时切换到新接口设置自动备份策略

URI

PUT https://{Endpoint}/gaussdb/v3/{project_id}/instances/{instance_id}/backups/policy
表1 参数说明

名称

是否必选

说明

project_id

参数解释:

租户在某一Region下的项目ID。

获取方法请参见获取项目ID

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为32个字符。

默认取值

不涉及。

instance_id

实例ID。

请求参数

表2 参数说明

名称

是否必选

参数类型

说明

backup_policy

Object

备份策略信息。

详情参见表3

表3 backup_policy字段数据结构说明

名称

是否必选

参数类型

说明

keep_days

Integer

备份文件可以保存的天数。

取值范围:1-732天。

start_time

String

备份时间段。自动备份将在该时间段内触发。

取值范围:非空,格式必须为hh:mm-HH:MM且有效,当前时间指UTC时间。

HH取值必须比hh大1,mm和MM取值必须相同,且取值必须为00。

取值示例:

21:00-22:00

period

String

全量备份周期配置。自动全量备份将在每星期指定的天进行。

取值范围:格式为逗号隔开的数字,数字代表星期。取值示例:1,2,3,4则表示备份周期配置为星期一、星期二、星期三和星期四。

differential_period

String

差异备份间隔时间配置。每次自动差异备份的间隔时间。

取值范围:15、30、60、180、360、720、1440。单位:分钟。

取值示例:30

响应参数

无。

请求示例

https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/backups/policy
{
	"backup_policy": {
		"keep_days": 7,
		"start_time": "19:00-20:00",
		"period": "1,2,3,4,5",
		"differential_period": "30"
	}
}

响应示例

状态码

错误码

请参见错误码