Ambari 常用的 REST API 介紹

Ambari 借鑑了很多成熟分散式軟體的 API 設計。Rest API 就是一個很好地體現。通過 Ambari 的 Rest API，可以在指令碼中通過 curl 維護整個叢集。並且，我們可以用 Rest API 實現一些無法在 Ambari GUI 上面做的操作。下面是一些例項。
例項 1，通過 API 解除安裝已安裝的 Service

目前 Ambari 不支援在 GUI 上面解除安裝已安裝的 Service。所以當一個 Service 不再需要的時候，使用者沒法刪除掉該 Service。幸運的是 Ambari 提供了 DELETE 的 Rest API，我們可以通過該 API 來刪除 Ambari 中 Service。不過這裡需要注意，這個方法只是從 Ambari Service 中刪除了 Service。這樣一來，Ambari 的 GUI 介面中不再顯示這個 Service。但是 Service 本身還安裝在 Agent 所在的機器。如果使用者需要徹底的清除掉這個 Service，仍需要手工的到每個機器解除安裝（例如，在每個機器執行 yum erase）。

這裡我以刪除 Storm 為例。解除安裝之前，需要確認是否停掉了該 Service。我們通過 GET 方法來得到這個結果（這裡當然也可以直接從 GUI 上面看到 Service 狀態）。具體的命令如下：

curl -u admin:admin -H "X-Requested-By: ambari" -X GET http://zwshen86:8080/api/v1/clusters/bigdata/services/STORM

命令中的 zwshen86 為 Ambari Server 的機器名（埠預設為 8080），bigdata 為 cluster 名字，STORM 為 Service 的名字。

在返回的報文中，可以看到 State 欄位。如果是 INSTALLED，代表這個 Service 已經是停掉的狀態。我們可以繼續刪除步驟。如果不是 INSTALLED，則需要先停掉這個 Service，可以從 WEB 上操作，也可以用 Rest API。
圖 17. Get 返回的結果


用 Rest API 停掉 Service 的命令格式如下，有興趣的朋友可以嘗試一下。

curl -u admin:admin -H "X-Requested-By: ambari" -X PUT -d '{"RequestInfo":
        {"context":"Stop Service"},"Body":{"ServiceInfo":{"state":"INSTALLED"}}}'
        http://AMBARI_SERVER_HOST:8080/api/v1/clusters/c1/services/SERVICE_NAME

執行如下命令刪除 STORM：

curl -u admin:admin -H "X-Requested-By: ambari" -X
DELETE  http://zwshen86:8080/api/v1/clusters/bigdata/services/STORM

執行完成後，Storm 就從 Ambari 的 Service 裡面刪掉了，但是 Storm 的 package 還存在於機器。
圖 18. Storm 的 RPM 包


如果需要徹底清除掉 Storm 的 package，則需要到各個 Agent 機器執行如下命令。

yum erase“storm_2_2*”

執行完後，這個 Service 就被徹底的清除掉了。


檢視狀態
curl -u admin:admin -H "X-Requested-By: ambari" -X GET http://10.111.3.9:8080/api/v1/clusters/data/services/STORM

修改狀態為INSTALLED
curl -u admin:admin -H "X-Requested-By: ambari" -X PUT -d '{"RequestInfo": {"context":"Stop Service"},"Body":{"ServiceInfo":{"state":"INSTALLED"}}}'  http://10.111.3.9:8080/api/v1/clusters/data/services/STORM

刪除服務
curl -u admin:admin -H "X-Requested-By: ambari" -X DELETE  http://10.111.32.94:8080/api/v1/clusters/gdata/services/STORM

（服務名稱

STORM大寫，有的時候狀態為INSTALL_FAILED，UNKNOWN狀態直接刪除就行）

參考：
http://www.ibm.com/developerworks/cn/opensource/os-cn-bigdata-ambari2/index.html
http://blog.csdn.net/gcangle/article/details/50128807