clusterMembers

URI

<managerRoot uri>/clustermembers[.<format>]

支持的方法

GET、HEAD

父资源

managerRoot

介绍

clusterMembers 为集群成员信息资源，通过 clusterMembers 资源您可以获取当前集群的所有子节点信息。

支持的表述格式：RJSON、JSON、HTML、XML。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/manager/clustermembers.rjson

GET 请求

获取当前集群的所有子节点信息。

响应结构

对 clusterMembers 资源执行 GET 请求，返回的是一个集群子节点列表，其中单个子节点的表述结构如下：

字段 类型 说明
active boolean 集群子节点是否活跃。
agentId String 代理节点 id。
authorized boolean 集群子节点是否通过授权。
hostName String 集群子节点所在机器名称。
id String 集群子节点标识。
ip String 集群子节点 ip。
isAgent boolean 集群子节点是否为代理节点。
isControllable boolean 集群子节点是否以受控方式加入集群。
isOffLine boolean 集群子节点是否为离线状态。
isTileWorker boolean 集群子节点是否为切图节点。
port int 集群子节点端口号。
uriRoot String 集群子节点服务地址。

响应示例

对 clusterMembers 资源执行 GET 请求（ http://localhost:8090/iserver/manager/clustermembers.rjson ），返回的 rjson 格式表述如下：

[

    {

        "active": true,

        "agentId": null,

        "authorized": true,

        "hostName": "HOST1",

        "id": "e0dec207b2e547f3bf908327fab03585",

        "ip": "192.168.17.149",

        "isAgent": false,

        "isControllable": false,

        "isOffLine": false,

        "isTileWorker": false,

        "port": 8091,

        "uriRoot": "http://192.168.17.149:8091/iserver/services"

    },

    {

        "active": true,

        "agentId": null,

        "authorized": true,

        "hostName": "HOST2",

        "id": "d7c64eb1ea1a4f11983082488ab9fba9",

        "ip": "192.168.17.148",

        "isAgent": false,

        "isControllable": false,

        "isOffLine": false,

        "isTileWorker": false,

        "port": 8090,

        "uriRoot": "http://192.168.17.148:8090/iserver/services"

    }

]

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 clusterMembers 资源是否存在，或者客户端是否有权限访问 clusterMembers 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 clusterMembers 资源是否支持<format>格式的表述。

请参见