etcd v2文档(2) -- 客户端http请求管理集群成员api
etcd v2文档(2) -- 客户端http请求管理集群成员api
solate
发布于 2019-07-22 16:36:26
发布于 2019-07-22 16:36:26
列出成员
- 返回一个HTTP 200 OK响应代码和所有成员在etcd集群中的表示。
Request
GET /v2/members HTTP/1.1Example
curl http://10.0.0.10:2379/v2/members{
"members": [
{
"id": "272e204152",
"name": "infra1",
"peerURLs": [
"http://10.0.0.10:2380"
],
"clientURLs": [
"http://10.0.0.10:2379"
]
},
{
"id": "2225373f43",
"name": "infra2",
"peerURLs": [
"http://10.0.0.11:2380"
],
"clientURLs": [
"http://10.0.0.11:2379"
]
},
]
}添加成员
- 成功返回一个HTTP 201响应代码以及添加成员的表示，并在成功时新生成一个memberID。 不成功时返回描述失败情况的字符串。
- 如果POST主体格式错误，则返回HTTP 400。
- 如果成员存在于集群中，或者过去某个时刻存在于集群中，则返回HTTP 409。
- 如果群集中存在任何给定的
peerURL，则返回HTTP 409。 - 如果集群无法在超时期间处理请求，则返回HTTP 500，尽管稍后可能会处理该请求。
Request
POST /v2/members HTTP/1.1
{"peerURLs": ["http://10.0.0.10:2380"]}Example
curl http://10.0.0.10:2379/v2/members -XPOST \
-H "Content-Type: application/json" -d '{"peerURLs":["http://10.0.0.10:2380"]}'{
"id": "3777296169",
"peerURLs": [
"http://10.0.0.10:2380"
]
}删除成员
从集群中删除成员。 成员编号必须是十六进制编码的uint64。
- 成功返回HTTP 204和含有空的内容。 不成功时返回描述失败情况的字符串。
- 如果该成员不存在于集群中，则返回HTTP 500（TODO：fix this）。
- 如果集群无法在超时期间处理请求，则返回HTTP 500，尽管稍后可能会处理该请求。
Request
DELETE /v2/members/<id> HTTP/1.1Example
curl http://10.0.0.10:2379/v2/members/272e204152 -XDELETE返回204，内容为空
修改成员 peerURLs
修改集群 peerURLs 地址。 成员编号必须是十六进制编码的uint64。
- 成功返回204含有空的内容。 不成功时返回描述失败情况的字符串。
- 如果POST主体格式错误，则返回HTTP 400。
- 如果该成员不存在于集群中，则将返回HTTP 404。
- 如果群集中存在任何给定的peerURL，则返回HTTP 409。
- 如果集群无法在超时期间处理请求，则返回HTTP 500，尽管稍后可能会处理该请求。
Request
PUT /v2/members/<id> HTTP/1.1
{"peerURLs": ["http://10.0.0.10:2380"]}Example
curl http://10.0.0.10:2379/v2/members/272e204152 -XPUT \
-H "Content-Type: application/json" -d '{"peerURLs":["http://10.0.0.10:2380"]}'本文参与 腾讯云自媒体分享计划，分享自作者个人站点/博客。
如有侵权请联系 cloudcommunity@tencent.com 删除
评论
登录后参与评论
推荐阅读
目录