etcd v2文档(2) -- 客户端http请求管理集群成员api

最新推荐文章于 2024-11-06 00:50:00 发布

转载最新推荐文章于 2024-11-06 00:50:00 发布 · 306 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://my.oschina.net/solate/blog/1547836

文章标签：

#json

本文详细介绍了如何通过HTTP请求管理Etcd集群，包括获取成员列表、添加成员、删除成员及更新成员的peerURLs等关键操作。每种操作都提供了具体的HTTP请求示例和可能的响应状态代码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

为什么80%的码农都做不了架构师？>>>

列出成员

返回一个HTTP 200 OK响应代码和所有成员在etcd集群中的表示。

Request

GET /v2/members HTTP/1.1

Example

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.1

Example

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"]}'

参考

群集配置

后面继续补充

PS: 觉得不错的请点个赞吧！！ (ง •̀_•́)ง

转载于:https://my.oschina.net/solate/blog/1547836