# 索引恢復 索引恢復API提供觀察正在恢復的索引分片的功能。可以針對特定的索引或者集群范圍報告恢復的狀態。 例如，如下命令將顯示索引”index1“和”index2“的恢復信息。 | `GET index1,index2``/_recovery``?human` | 要查看集群的恢復狀態，只需要省略索引名稱。 | `GET?``/_recovery``?human` | 響應： { "index1" : { "shards" : [ { "id" : 0, "type" : "SNAPSHOT", "stage" : "INDEX", "primary" : true, "start_time" : "2014-02-24T12:15:59.716", "start_time_in_millis": 1393244159716, "total_time" : "2.9m", "total_time_in_millis" : 175576, "source" : { "repository" : "my_repository", "snapshot" : "my_snapshot", "index" : "index1" }, "target" : { "id" : "ryqJ5lO5S4-lSFbGntkEkg", "hostname" : "my.fqdn", "ip" : "10.0.1.7", "name" : "my_es_node" }, "index" : { "size" : { "total" : "75.4mb", "total_in_bytes" : 79063092, "reused" : "0b", "reused_in_bytes" : 0, "recovered" : "65.7mb", "recovered_in_bytes" : 68891939, "percent" : "87.1%" }, "files" : { "total" : 73, "reused" : 0, "recovered" : 69, "percent" : "94.5%" }, "total_time" : "0s", "total_time_in_millis" : 0 }, "translog" : { "recovered" : 0, "total" : 0, "percent" : "100.0%", "total_on_start" : 0, "total_time" : "0s", "total_time_in_millis" : 0, }, "start" : { "check_index_time" : "0s", "check_index_time_in_millis" : 0, "total_time" : "0s", "total_time_in_millis" : 0 } } ] } } 以上響應內容展示了單個索引恢復單個分片。在這個例子中，恢復的源是快照存儲庫，恢復的目標是名稱為”my_es_node“的節點。 除此之外，輸出顯示恢復的文件的數量和百分比，以及恢復的字節數和百分比。 在一些情況下，更高級別的細節可能是優選的。設置”detailed=true“將提供恢復中的物理文件列表。 | `GET _recovery?human&detailed=``true` | 響應： { "index1" : { "shards" : [ { "id" : 0, "type" : "STORE", "stage" : "DONE", "primary" : true, "start_time" : "2014-02-24T12:38:06.349", "start_time_in_millis" : "1393245486349", "stop_time" : "2014-02-24T12:38:08.464", "stop_time_in_millis" : "1393245488464", "total_time" : "2.1s", "total_time_in_millis" : 2115, "source" : { "id" : "RGMdRc-yQWWKIBM4DGvwqQ", "hostname" : "my.fqdn", "ip" : "10.0.1.7", "name" : "my_es_node" }, "target" : { "id" : "RGMdRc-yQWWKIBM4DGvwqQ", "hostname" : "my.fqdn", "ip" : "10.0.1.7", "name" : "my_es_node" }, "index" : { "size" : { "total" : "24.7mb", "total_in_bytes" : 26001617, "reused" : "24.7mb", "reused_in_bytes" : 26001617, "recovered" : "0b", "recovered_in_bytes" : 0, "percent" : "100.0%" }, "files" : { "total" : 26, "reused" : 26, "recovered" : 0, "percent" : "100.0%", "details" : [ { "name" : "segments.gen", "length" : 20, "recovered" : 20 }, { "name" : "_0.cfs", "length" : 135306, "recovered" : 135306 }, { "name" : "segments_2", "length" : 251, "recovered" : 251 }, ... ] }, "total_time" : "2ms", "total_time_in_millis" : 2 }, "translog" : { "recovered" : 71, "total_time" : "2.0s", "total_time_in_millis" : 2025 }, "start" : { "check_index_time" : 0, "total_time" : "88ms", "total_time_in_millis" : 88 } } ] } } 以上響應顯示恢復的實際文件和它們大小的詳細列表（為了簡潔截取部分）。 還顯示了恢復的各個階段的實際時間（以毫秒為單位）:索引檢索，事務日志重放以及索引開始時間。 注意，上面的列表表示恢復處于完成階段。所有的恢復，無論是正在進行的還是已經完成的，都保持在集群狀態下，并且可以隨時報告。”active_only=true“這個設置只顯示正在進行的恢復。 以下是完整的選項列表： | `detailed` | 顯示詳細視圖。這主要用于查看物理索引文件的恢復情況。默認為：false。 | | `active_only` | 只顯示當前正在進行的恢復。默認為：false。 | 輸出字段說明： | `id` | 分片id | | `type` | 恢復類型: * 存儲 * 快照 * 副本 * 遷移 | | `stage` | 恢復階段: * init: 恢復尚未啟動 * index: 讀取索引元數據并從源到目標復制字節 * start: 啟動引擎，打開索引使用 * translog: 重放事務日志 * finalize: 清理 * done: 完成 | | `primary` | 值為true表示分片為主分片，false反之。 | | `start_time` | 開始恢復的時間戳 | | `stop_time` | 完成恢復的時間戳 | | `total_time_in_millis` | 恢復分片的總時間(毫秒) | | `source` | 恢復源: * 如果恢復是來自快照的，則為存儲庫的描述 * 否則為源節點的描述 | | `target` | 目標節點 | | `index` | 物理索引恢復統計 | | `translog` | 事務日志恢復統計 | | `start` | 打開啟動索引時間的統計信息 |