文档首页/ 云搜索服务 CSS/ API参考/ API V2/ 快照管理/ 开启自动创建快照功能
更新时间:2025-08-22 GMT+08:00
分享

开启自动创建快照功能

功能介绍

CSS服务的快照备份功能为OpenSearch集群提供数据保护和恢复能力。通过快照备份,可以将集群的数据状态保存到OBS桶中,以便在需要时进行恢复。CSS集群快照分为两种方式:自动创建快照和手动创建快照。

  • 自动创建快照:按照预设的时间策略自动执行快照备份操作,适合定期备份场景,例如每日或每周备份,以确保数据的持续保护。通过设置自动快照策略,用户可以减少手动操作,提高备份的可靠性和效率。

  • 手动创建快照:用户根据需求手动触发快照备份操作,适合临时备份或特定场景,如在进行重大操作前(如集群升级)进行备份,以便在出现问题时能够快速恢复到之前的状态。手动快照提供了更高的灵活性,用户可以根据实际需求随时创建快照。

该接口用于打开自动备份功能。

调用方法

请参见如何调用API

URI

POST /v2.0/{project_id}/clusters/{cluster_id}/snapshots/policy/open

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID和名称

约束限制

不涉及

取值范围

账户的项目ID。

默认取值

不涉及

cluster_id

String

参数解释

快照所属的集群的ID。获取方法请参见获取集群ID

约束限制

不涉及

取值范围

集群ID。

默认取值

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

indices

String

参数解释

指定要备份的索引名称,多个索引用逗号隔开,默认备份所有索引。支持使用“*”匹配多个索引,例如:2018-06*,表示备份名称前缀是2018-06的所有索引的数据。

约束限制

不涉及

取值范围

0~1024个字符,不能包含空格和大写字母,且不能包含"\<|>/?特殊字符。

默认取值

不涉及

keepday

Integer

参数解释

自定义设置快照保留的个数,系统在半点时刻会自动删除超过保留个数的快照。过期删除策略只针对与当前自动创建快照策略相同执行频次的自动快照。

约束限制

不涉及

取值范围

1~90

默认取值

不涉及

frequency

String

参数解释

自动创建快照的执行频次。

约束限制

不涉及

取值范围

不涉及

默认取值

DAY

说明:
取值HOUR时,表示每小时整点执行一次;取值DAY时,表示每天执行一次;取值SUN、MON、TUE、WED、THU、FRI、SAT时,表示在每周对应时间执行一次。比如SUN表示每周日执行一次。保留快照个数与自动创建快照策略中设置的执行频次和索引有关。当执行频次间隔时间短或索引数据量大,保留自动快照可能会达不到设置的个数,请谨慎选择!

period

String

参数解释

每天创建快照的时刻。

约束限制

不涉及

取值范围

只支持整点,后面需加上时区,格式为HH:mm z,HH:mm表示整点时间,z表示时区。 比如00:00 GMT+08:00、01:00 GMT+08:00等。

默认取值

00:00 GMT+08:00

说明:
当frequency取值HOUR时,无需指定period值,默认从设置成功的下一整点创建。

prefix

String

参数解释

自动创建的快照的前缀,需要用户自己手动输入。

约束限制

不涉及

取值范围

只能包含1~32位小写字母、数字、中划线或者下划线,并且以小写字母开头。

默认取值

不涉及

响应参数

状态码:200

请求已成功。

请求示例

打开自动备份功能。

POST https://{Endpoint}/v2.0/{project_id}/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/snapshots/policy/open

{
  "indices" : "*",
  "keepday" : 7,
  "frequency" : "DAY",
  "period" : "16:00 GMT+08:00",
  "prefix" : "snapshot"
}

响应示例

状态码

状态码

描述

200

请求已成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

403

请求被拒绝访问。返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。

错误码

请参见错误码

相关文档