更新时间:2023-11-16 gmt 08:00

设置自动备份策略-凯发k8国际娱乐官网入口

功能介绍

设置自动备份策略。

  • 调用接口前,您需要了解api 。
  • 调用接口前,您需要提前获取到,即下文中的endpoint值。

调试

您可以在中调试该接口。

uri

  • uri格式

    put https://{endpoint}/v3/{project_id}/instances/{instance_id}/backups/policy

  • uri样例

    https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/backups/policy

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    租户在某一region下的project id。

    获取方法请参见。

    instance_id

    实例id。

请求消息

  • 参数说明
    表2 参数说明

    名称

    是否必选

    参数类型

    说明

    backup_policy

    object

    备份策略信息。

    详情参见表3

    表3 backup_policy字段数据结构说明

    名称

    是否必选

    参数类型

    说明

    keep_days

    integer

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

    取值范围:1-36500天。

    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

    rate_limit

    integer

    备份限速,默认值为0mb/s,表示不限速。控制备份是备份数据上传obs的速度,限速用于限制上传备份对上传带宽的影响

    取值范围:0 mb/s ~ 1024 mb/s

    最小值:0 mb/s

    prefetch_block

    integer

    控制差量备份时读取磁盘上表文件差量修改页面的预取页面个数。当差量修改页面非常集中时(如数据导入场景),可以适当调大该值;当差量修改页面非常分散时(如随机更新),可以适当调小该值。默认为64,单位个数

    取值范围:1 ~ 8192

    最小值:1

    最大值:8192

    file_split_size

    integer

    全量、差量备份时产生的备份文件会根据该参数的值进行拆分,可设置范围为0~1024gb,设置需为4的倍数,默认4gb,0gb表示不限制大小。

    取值范围:0 ~ 1024

    最小值:0

    最大值:1024

    filesplit_size

    integer

    全量、差量备份时产生的备份文件会根据该参数的值进行拆分,废弃,无需填写。

    enable_standby_backup

    boolean

    是否启用备机备份。(不支持单节点实例及3.100.0以下的实例)

请求示例

设置gaussdb实例备份策略,备份文件保存时长7天,备份时间段为"19:00-20:00"。
{
	"backup_policy": {
		"keep_days": 7,
		"start_time": "19:00-20:00",
		"period": "1,2,3,4,5",
		"differential_period": "30",
                "rate_limit": 75 ,
                "prefetch_block": 64 ,
                "file_split_size": 4 ,
                "enable_standby_backup" : "false" 
	}
}

响应消息

  • 正常响应要素说明

  • 正常响应样例

  • 异常响应

    请参见。

状态码

  • 正常

    200

  • 异常

    请参见。

错误码

请参见。

分享:
网站地图