创建仓库
您可以通过如下命令创建仓库：
PUT _snapshot/my_cos_backup{"type": "cos","settings": {"app_id": "xxxxxxx","access_key_id": "xxxxxx","access_key_secret": "xxxxxxx","bucket": "xxxxxx","region": "ap-guangzhou","compress": true,"chunk_size": "500mb","base_path": "/"}}
app_id：腾讯云账号 APPID。
access_key_id：腾讯云 API 密钥 SecretId。
access_key_secret：腾讯云 API 密钥 SecretKey。
bucket：COS Bucket 名字，名字不能带
-{appId}后缀，创建 COS 存储桶的详细步骤请参见 创建存储桶。region：COS Bucket 地域，此地域必须与 ES 集群为同一地域。地域编码可参考 地域和可用区。
compress：默认为 true，对索引元数据存储进行压缩。
base_path：备份目录。
列出仓库信息
您可通过
GET _snapshot获取仓库信息，也可使用GET _snapshot/my_cos_backup获取指定的仓库信息。下图中右侧部分即仓库信息，例如： "base_path": "/es_backup/es-mntkl1xo","end_point": "cos.ap-shanghai.myqcloud.com"。
创建快照备份
备份所有索引
将 ES 集群内所有索引备份到
my_cos_backup仓库下，并命名为snapshot_1。PUT _snapshot/my_cos_backup/snapshot_1
这个命令会立刻返回，并在后台异步执行直到结束。如果希望创建快照命令阻塞执行，可以添加
wait_for_completion参数。命令执行的时间与索引大小相关。PUT _snapshot/my_cos_backup/snapshot_1?wait_for_completion=true
备份指定索引
您可以在创建快照的时候指定要备份的索引。参数 indices 的值为多个索引的时候，需要用
,隔开且不能有空格。PUT _snapshot/my_cos_backup/snapshot_2{"indices": "index_1,index_2"}
查询快照
查询单个快照信息：
GET _snapshot/my_cos_backup/snapshot_1
该命令会返回快照的相关信息：
说明
当信息中的
state字段为SUCCESS时，说明快照备份完成。{"snapshots": [{"snapshot": "snapshot_1","uuid": "zUSugNiGR-OzH0CCcgcLmQ","version_id": 5060499,"version": "5.6.4","indices": ["index_1","index_2"],"state": "SUCCESS","start_time": "2018-05-04T11:44:15.975Z","start_time_in_millis": 1525434255975,"end_time": "2018-05-04T11:45:29.395Z","end_time_in_millis": 1525434329395,"duration_in_millis": 73420,"failures": [],"shards": {"total": 3,"failed": 0,"successful": 3}}]}
删除快照
删除指定的快照：
DELETE _snapshot/my_cos_backup/snapshot_1
注意
如果存在还未完成的快照，删除快照命令依旧会执行，并取消未完成快照的创建进程。
从快照恢复
1. 将快照中备份的所有索引都恢复到 ES 集群中。
POST _snapshot/my_cos_backup/snapshot_1/_restore
这里是恢复所有的索引数据，通常会有一些系统索引已经存在，那就会出现异常的情况。
如果 snapshot_1 包括5个索引，则这5个索引都会被恢复到 ES 集群中。
您还可以使用附加的选项对索引进行重命名。该选项允许您通过模式匹配索引名称，并通过恢复进程提供一个新名称。如果您想在不替换现有数据的前提下，恢复旧数据来验证内容或进行其他操作，则可以使用该选项。
2. 从快照里恢复单个索引并提供一个替换的名称。
POST /_snapshot/my_cos_backup/snapshot_1/_restore{"indices": "index_1","rename_pattern": "index_(.+)","rename_replacement": "restored_index_$1"}
indices：只恢复 index_1 索引，忽略快照中存在的其他索引。
rename_pattern：查找所提供的模式能匹配上的正在恢复的索引。
rename_replacement：将匹配的索引重命名成替代的模式。
查询快照恢复状态
可通过执行
_recovery命令，查看快照恢复的状态并监控快照恢复的进度。 1. 您可以在恢复的指定索引中单独调用下述 API。
GET index_1/_recovery
2. 该命令会返回指定索引各分片的恢复状况。
{"sonested": {"shards": [{"id": 1,"type": "SNAPSHOT","stage": "INDEX","primary": true,"start_time_in_millis": 1525766148333,"total_time_in_millis": 8718,"source": {"repository": "my_cos_backup","snapshot": "snapshot","version": "5.6.4","index": "index_1"},"target": {"id": "xxxxxxxxxxx","host": "10.0.0.6","transport_address": "10.0.0.6:9300","ip": "10.0.0.6","name": "node-1"},"index": {"size": {"total_in_bytes": 1374967573,"reused_in_bytes": 0,"recovered_in_bytes": 160467084,"percent": "11.7%"},"files": {"total": 132,"reused": 0,"recovered": 20,"percent": "15.2%"},"total_time_in_millis": 8716,"source_throttle_time_in_millis": 0,"target_throttle_time_in_millis": 0},"translog": {"recovered": 0,"total": 0,"percent": "100.0%","total_on_start": 0,"total_time_in_millis": 0},"verify_index": {"check_index_time_in_millis": 0,"total_time_in_millis": 0}}]}}
type：描述恢复的本质，该分片是在从一个快照恢复。
source：哈希描述作为恢复来源的特定快照和仓库。
percent：描述恢复的状态。该特定分片目前已经恢复了94%的文件，即将全部恢复。
输出会列出所有目前正在恢复的索引，以及这些索引里的所有分片。每个分片里会有启动/停止时间、持续时间、恢复百分比、传输字节数等统计值。
取消快照恢复
DELETE /restored_index_1
如果 restored_index_1 正在恢复中，则该删除命令会停止恢复，同时删除所有已经恢复到集群中的数据。
