# Cat APIs ## 介紹 JSON在計算機領域是個偉大的發明,盡管他可以以美化格式,但是視圖從JSON發現數據直接的關系還是很沉悶的.人眼,尤其是看著終端,還是需要緊湊和對齊的文本.而cat API就是以圖完成這個需求. 所有的cat命令都接受一個查詢字符串參數，以查看它們提供的所有標題和信息，而/ _cat命令僅列出所有可用的命令。 ## 常用參數 * verbose 每個_cat命令都會接受一個"v"參數,會返回詳細的結果輸出.比如 ~~~ GET /_cat/master?v ~~~ 將會返回 ~~~ id host ip node u_n93zwxThWHi1PDBJAGAg 127.0.0.1 127.0.0.1 u_n93zw ~~~ * help 每個_cat命令都會接受一個"help"參數,會在返回結果中說明每列的含義,比如 ~~~ GET /_cat/master?help ~~~ 將會返回 ~~~ id | | node id host | h | host name ip | | ip address node | n | node name ~~~ * header 每個_cat命令都會接受一個"h"參數,會在返回結果中強制所指定的列,比如 ~~~ GET /_cat/nodes?h=ip,port,heapPercent,name ~~~ 將會返回 ~~~ 127.0.0.1 9300 27 sLBaIGK ~~~ 你也可以在請求的多個列的參數中使用通配符,如/_cat/thread_pool?h=ip,bulk.*來返回所有以bulk開始的列 ## 格式化數字 許多命令提供一些類型的數字輸出，要么是字節，要么是大小，要么是時間值。默認情況下，這些類型是人為格式化的，例如，3.5 mb而不是3763212。人類的可讀的值并不方便進行數字排序，因此，為了在秩序重要的地方進行操作，你可以改變它。 假設您希望在集群中找到最大的索引(所有分片的存儲容量，而不是文檔的數量)。`/_cat/indices`?API是理想的。我們只需要調整兩件事。首先，我們要關閉人類可讀模式。我們將使用字節級的解析格式。然后，我們將使用適當的列將輸出進行排序，在本例中是第8列 ~~~ curl '192.168.56.10:9200/_cat/indices?bytes=b' | sort -rnk8 ~~~ 返回結果 ~~~ green wiki2 3 0 10000 0 105274918 105274918 green wiki1 3 0 10000 413 103776272 103776272 green foo 1 0 227 0 2065131 2065131 ~~~ 如果你想改變時間單位,請使用"time"參數 如果你想改變大小單位,請使用"size"參數 如果你想改變字節單位,請使用"bytes"參數 ## 返回各種格式的結果,如json,smile,yaml,cbor ~~~ curl 'localhost:9200/_cat/indices?format=json&pretty' ~~~ 將返回 ~~~ [ { "pri.store.size": "650b", "health": "yellow", "status": "open", "index": "twitter", "pri": "5", "rep": "1", "docs.count": "0", "docs.deleted": "0", "store.size": "650b" } ] ~~~ 當前支持的格式化類型有: text(默認),json,smile,yaml,cbor,請使用“format”參數. 另外一個可選的選擇是:在HTTP請求頭中添加“Accept”參數來進行格式化.上述所有的格式化類型都支持.比如: ~~~ curl '192.168.56.10:9200/_cat/indices?pretty' -H "Accept: application/json" ~~~ 將返回 ~~~ [ { "pri.store.size": "650b", "health": "yellow", "status": "open", "index": "twitter", "pri": "5", "rep": "1", "docs.count": "0", "docs.deleted": "0", "store.size": "650b" } ] ~~~ 每個命令都接受一個查詢字符串參數s，它通過指定為參數值的列對表進行排序。列按名稱或別名指定，并作為逗號分隔的字符串提供。默認情況下，排序以升序方式進行。“:desc"表示一個列將反轉該列的順序。”:asc"也被接受，但其表現與默認排序相同。 比如: ~~~ GET _cat/templates?v&s=order:desc,index_patterns ~~~ 將返回: ~~~ name index_patterns order version pizza_pepperoni [*pepperoni*] 2 sushi_california_roll [*avocado*] 1 1 pizza_hawaiian [*pineapples*] 1 ~~~ ## Sort // TODO