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

列出成员

返回一个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"]}'