查询自动创建快照的策略
功能介绍
CSS服务的快照备份功能为Elasticsearch集群提供数据保护和恢复能力。通过快照备份,可以将集群的数据状态保存到OBS桶中,以便在需要时进行恢复。集群快照分为两种方式:自动创建快照和手动创建快照。该接口用于查询自动创建快照策略。
调用方法
请参见如何调用API。
URI
GET /v1.0/{project_id}/clusters/{cluster_id}/index_snapshot/policy
请求参数
无
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
keepday |
Integer |
参数解释: 自定义设置快照保留的个数。 取值范围: 不涉及 |
|
period |
String |
参数解释: 每天快照创建的具体时刻。 取值范围: 不涉及 |
|
frequency |
String |
参数解释: 自动创建快照的执行频次。 取值范围: |
|
prefix |
String |
参数解释: 快照命名前缀,需要用户自己手动输入。 取值范围: 不涉及 |
|
bucket |
String |
参数解释: 快照存放的OBS桶的桶名。 取值范围: 不涉及 |
|
basePath |
String |
参数解释: 快照在OBS桶中的存放路径。 取值范围: 不涉及 |
|
agency |
String |
参数解释: 委托名称,委托给CSS,允许CSS调用您的其他云服务。无法配置含特殊字符和中文字符的委托。 取值范围: 允许使用的委托名称仅可包含a-zA-Z0-9-_字符。 |
|
enable |
String |
参数解释: 是否开启自动创建快照策略。 取值范围: |
|
indices |
String |
参数解释: 指定要备份的索引名称,多个索引用逗号隔开,默认备份所有索引。支持使用“*”匹配多个索引,例如:2018-06*,表示备份名称前缀是2018-06的所有索引的数据。 取值范围: 0~1024个字符,不能包含空格和大写字母,且不能包含"\<|>/?特殊字符。 |
|
snapshotCmkId |
String |
参数解释: 快照ID。 取值范围: 不涉及 |
|
maxSnapshotBytesPerSeconds |
String |
参数解释: 配置每个节点的最大备份速率(每秒),即当备份的速率超过该值时会被限流,避免速率太大导致资源占用过高,影响系统稳定性。实际备份速率不一定能达到该值,会受OBS、磁盘等影响。 取值范围: 有以下3种填写规则: |
|
maxRestoreBytesPerSeconds |
String |
参数解释: 配置每个节点的最大恢复速率(每秒),即当恢复的速率超过该值时会被限流,避免速率太大导致资源占用过高,影响系统稳定性。实际恢复速率不一定能达到该值,会受OBS、磁盘等影响。 取值范围: 有以下3种填写规则:
|
请求示例
查询自动创建快照的策略。
GET https://{Endpoint}/v1.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/index_snapshot/policy
响应示例
状态码:200
请求已成功。
{
"keepday" : 2,
"period" : "16:00 GMT+08:00",
"frequency" : "DAY",
"prefix" : "snapshot",
"bucket" : "es-backup",
"basePath" : "css_repository/tests",
"agency" : "usearch",
"enable" : "true",
"indices" : "*",
"snapshotCmkId" : null,
"maxSnapshotBytesPerSeconds" : "40MB",
"maxRestoreBytesPerSeconds" : "0MB"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求已成功。 |
|
406 |
服务器无法根据客户端请求的内容特性完成请求。 |
错误码
请参见错误码。