
# CSS服务中如何查询集群的快照信息？
CSS集群必须启用了集群快照功能，并已存在备份好的快照，才能查询快照信息。
可以通过控制台查看，也可以在Kibana或OpenSearch Dashboards中执行命令查询。
#### 在控制台查询快照
1. 登录[云搜索服务管理控制台](https://console.huaweicloud.com/elasticsearch/)。
2. 在左侧导航栏，选择"集群管理"，根据目标集群选择集群类型，进入集群列表页面。
3. 在集群列表，单击目标集群名称，进入集群详情页。
4. 选择"集群快照"页签。
5. 在集群快照任务列表中，单击目标快照名称，弹出查看详情对话框，可以获取快照信息。
 
#### 使用命令行查询快照
1. 登录[云搜索服务管理控制台](https://console.huaweicloud.com/elasticsearch/)。
2. 在左侧导航栏，选择"集群管理"，根据目标集群选择集群类型，进入集群列表页面。
3. 如果是Elasticsearch集群，则在集群列表单击操作列的"Kibana"，登录Kibana。如果是OpenSearch集群，则在集群列表单击操作列的"Dashboards"，登录OpenSearch Dashboards。
4. 在左侧导航栏选择"Dev Tools"，进入操作页面。
5. 执行如下命令，查询快照仓库信息，即集群快照的基础配置。
   ```
   GET _snapshot/_all
   ```
   返回示例：
   ```
   {
     "repo_auto": {
       "type": "obs",
       "settings": {
         "bucket": "123xxx",  // OBS桶名称
         "chunk_size": "2g",  // 分块大小，控制备份数据分块大小（单位：GB）
         "endpoint": "obs.xxx.example.com:443",  // OBS的Endpoint
         "max_restore_bytes_per_sec": "0MB",  // 最大恢复速率（每秒）
         "compress": "true",  // 是否启用数据压缩
         "base_path": "css_repository/css-xxx",  // 备份路径
         "region": "xxx",  // 所在区域
         "max_snapshot_bytes_per_sec": "40MB"  // 最大备份速率（每秒）
       }
     }
   }
   ```
   
6. 执行如下命令，查询快照列表。
   ```
   GET _snapshot/repo_auto/_all
   ```
   返回示例（总共查询到2条快照信息）：
   ```
   {
     "snapshots": [
       {
         "snapshot": "snapshot-2dc3",   // 快照名称
         "uuid": "VW5y2NBJS9iPh7YcGLxxxx",  // 快照ID
         "version_id": xxxxxxx,  // 内部使用的集群版本号
         "version": "x.x.x",  // 集群版本号
         "indices": [  // 备份的索引列表
           ".opendistro_security"
         ],
         "data_streams": [ ],  // 列出数据流
         "include_global_state": true,  // 是否包含集群的全局状态
         "state": "SUCCESS",  // 快照状态
         "start_time": "2025-08-30T01:41:57.068Z",  // 快照开始时间
         "start_time_in_millis": 1756518117068,  // 快照开始时间的毫秒级时间戳
         "end_time": "2025-08-30T01:41:57.469Z",  // 快照结束时间
         "end_time_in_millis": 1756518117469,  // 快照结束时间的毫秒级时间戳
         "duration_in_millis": 401,  // 快照操作的持续时间（毫秒），表示从开始到结束的总时间
         "failures": [ ],  // 快照过程中出现的错误或失败的分片信息
         "shards": {  // 快照涉及的分片统计信息
           "total": 1,  // 总分片数
           "failed": 0,  // 失败的分片数
           "successful": 1  // 成功的分片数
         }
       },
       {
         "snapshot": "snapshot-dd37",
         "uuid": "FD4VcooLS8yjPY3w0-x-xx",
         "version_id": xxxxxxx,
         "version": "x.x.x",
         "indices": [
           ".kibana",
           ".opendistro_security"
         ],
         "data_streams": [ ],
         "include_global_state": true,
         "state": "SUCCESS",
         "start_time": "2025-08-30T01:54:55.750Z",
         "start_time_in_millis": 1756518895750,
         "end_time": "2025-08-30T01:54:55.950Z",
         "end_time_in_millis": 1756518895950,
         "duration_in_millis": 200,
         "failures": [ ],
         "shards": {
           "total": 2,
           "failed": 0,
           "successful": 2
         }
       }
     ]
   }
   ```
   如果需要查询指定快照信息，可以执行如下命令。
   ```
   GET _snapshot/repo_auto/{snapshot_name}
   ```
   snapshot_name替换为实际快照名称，支持通配符。
   
7. （可选）执行如下命令，可以删除指定快照。
   ```
   DELETE _snapshot/repo_auto/{snapshot_name}
   ```
   快照被删除后，将不能用于恢复快照，请谨慎操作。
   
 
