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

设置自动备份策略

功能介绍

设置自动备份策略。

接口约束

该接口支持如下数据库实例。
  • GeminiDB Cassandra
  • GeminiDB Influx
  • GeminiDB Redis

URI

PUT https://{Endpoint}/v3/{project_id}/instances/{instance_id}/backups/policy

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一region下的project ID。获取方法请参见获取项目ID

instance_id

String

实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

表3 请求Body参数

参数

是否必选

参数类型

描述

backup_policy

object

备份策略对象,包括备份保留的天数和备份开始时间。详情请参考表4

表4 BackupPolicy

参数

是否必选

参数类型

描述

keep_days

Integer

指定已生成的备份文件可以保存的天数。

取值范围:0~35。取0值,表示关闭自动备份策略。

start_time

String

备份时间段。自动备份将在该时间段内触发。开启自动备份策略时,该参数必选;关闭自动备份策略时,不传该参数。

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

  • HH取值必须比hh大1。
  • mm和MM取值必须相同,且取值必须为00、15、30、45。
  • 取值示例:23:00-00:00。

period

String

备份周期配置。自动备份将在每星期指定的天进行。启用自动备份策略时,此参数必选。如果自动备份策略关闭,则不需要传递该参数。

取值范围:格式为半角逗号隔开的数字,数字代表星期。保留天数取值不同,备份周期约束如下:

  • 指定已生成的备份文件可以保存的天数为0天,不传该参数。
  • 指定已生成的备份文件可以保存的天数为1~6天,备份周期全选,取值为:1,2,3,4,5,6,7。
  • 指定已生成的备份文件可以保存的天数为7~35天,备份周期至少选择一周中的一天。示例:1,2,3,4。

响应参数

状态码:204

无响应参数。

请求示例

  • URI样例
    PUT https://gaussdb-nosql.ap-southeast-1.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/instances/9136fd2a9fcd405ea4674276ce36dae8in02/backups/policy
  • 请求体样例

    开启或修改自动备份策略,备份周期为"1,2,3,4,5,6",备份时间段为"01:00-02:00",备份保留天数为7天:

    {
       "backup_policy" : { 
       "period" : "1,2,3,4,5,6", 
       "start_time" : "01:00-02:00", 
       "keep_days" : 7 
       }
     }

    关闭自动备份策略:

    {
     
       "backup_policy" : { 
         "keep_days" : 0 
       }
     }

响应示例

状态码: 204

No Content

{ }

状态码

请参见状态码

错误码

请参见错误码