aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAlex Auvolat <alex@adnab.me>2022-05-17 18:43:47 +0200
committerAlex Auvolat <alex@adnab.me>2022-05-17 18:43:47 +0200
commit70383b4363c9d9d1ddebcb29c60f833022e97d24 (patch)
tree82c676e129f9a7cc2ff1bec7df85de2a3c02905a /doc
parent440a577563c313f7ce6fe928ff9a18ac1ad0deb3 (diff)
downloadgarage-70383b4363c9d9d1ddebcb29c60f833022e97d24.tar.gz
garage-70383b4363c9d9d1ddebcb29c60f833022e97d24.zip
Implement ConnectClusterNodes
Diffstat (limited to 'doc')
-rw-r--r--doc/drafts/admin-api.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/doc/drafts/admin-api.md b/doc/drafts/admin-api.md
index cbd73e15..2e1ffa82 100644
--- a/doc/drafts/admin-api.md
+++ b/doc/drafts/admin-api.md
@@ -94,6 +94,36 @@ Example response body:
}
```
+### ConnectClusterNodes `POST /v0/connect`
+
+Instructs this Garage node to connect to other Garage nodes at specified addresses.
+
+Example request body:
+
+```json
+[
+ "ec79480e0ce52ae26fd00c9da684e4fa56658d9c64cdcecb094e936de0bfe71f@10.0.0.11:3901",
+ "4a6ae5a1d0d33bf895f5bb4f0a418b7dc94c47c0dd2eb108d1158f3c8f60b0ff@10.0.0.12:3901"
+]
+```
+
+The format of the string for a node to connect to is: `<node ID>@<ip address>:<port>`, same as in the `garage node connect` CLI call.
+
+Example response:
+
+```json
+[
+ {
+ "success": true,
+ "error": null,
+ },
+ {
+ "success": false,
+ "error": "Handshake error",
+ }
+]
+```
+
### GetClusterLayout `GET /v0/layout`
Returns the cluster's current layout in JSON, including: