文档首页/ 云数据库 GeminiDB/ API参考/ API v3（推荐）/ 备份与恢复/ 设置自动备份策略
更新时间：2024-04-10 GMT+08:00
查看PDF
分享

设置自动备份策略

功能介绍

设置自动备份策略。

接口约束

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

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

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.cn-north-4.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

{ }

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 备份与恢复

相关文档