Browse Source

docs(api): add Cluster Config API

Yicheng Qin 11 years ago
parent
commit
204f2d38af
1 changed files with 36 additions and 0 deletions
  1. 36 0
      Documentation/api.md

+ 36 - 0
Documentation/api.md

@@ -1197,3 +1197,39 @@ curl -L http://127.0.0.1:4001/v2/stats/store
     "watchers": 0
     "watchers": 0
 }
 }
 ```
 ```
+
+## Cluster Config
+
+Cluster config manages cluster properties to ensure both fault tolerance and high performance.
+
+### Set Cluster Config
+
+```sh
+curl -L http://127.0.0.1:7001/v2/admin/config -XPUT -d '{"activeSize":3, "promoteDelay":1800}'
+```
+
+```json
+{
+    "activeSize": 3,
+    "promoteDelay": 1800
+}
+```
+
+`activeSize` indicates expected active peer-mode instances in the cluster.
+
+The size of cluster is controlled to be around a certain number. If it is not, it will promote standby-mode instances or demote peer-mode instances to make it happen.
+
+`promoteDelay` indicates the minimum length of delay that has been observed before promotion or demotion.
+
+### Get Cluster Config
+
+```sh
+curl -L http://127.0.0.1:7001/v2/admin/config
+```
+
+```json
+{
+    "activeSize": 3,
+    "promoteDelay": 1800
+}
+```