clusterOverview

URI

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

支持的方法

GET、HEAD

父资源

managerRoot

介绍

clusterOverview 资源为集群配置信息资源，通过该资源您可以查看当前集群的所有配置信息，包括集群配置使用情况、集群子节点列表以及集群报告器。

集群是指将 SuperMap iServer 服务注册到集群服务器中，并提供单一客户视图的服务。使用集群可以整合 GIS 服务器资源，提升系统的容错能力和并发性能。

支持的方法：

GET：获取当前集群的配置信息，包括集群配置使用情况、集群子节点列表以及集群报告器。
HEAD：检查 clusterOverview 资源是否存在，或权限是否可以访问 clusterOverview 资源。

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

资源层次

HTTP 请求方法

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

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

GET 请求

获取当前集群的配置信息，包括集群配置使用情况、集群子节点列表以及集群报告器。

响应结构

对 clusterOverview 资源执行 GET 请求，返回结果的表述结构如下：

字段	类型	说明
memberAuthorizedCount	int	集群中子节点个数。
members	List<ClusterMemberInfo>	集群子节点成员信息。
reporterUsedCount	int	报告器数量。
setting	ClusterSetting	集群配置信息。

响应示例

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

{ "memberAuthorizedCount": 2, "members": [ { "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" } ], "reporterUsedCount": 0, "setting": { "DEFAULT_CONNECT_TIMEOUT": 20000, "DEFAULT_READ_TIMEOUT": 120000, "address": "http://localhost:8090/iserver/services/cluster", "connectTimeout": 2000, "dataSyncInterval": null, "enabled": true, "excludeFormats": null, "includeFormats": null, "localAddress": null, "readTimeout": 120000, "reporters": [ { "address": "http://anotherclusterservice:8090/iserver/services/cluster", "enabled": false, "isTileWorker": false, "iserverId": "d7c64eb1ea1a4f11983082488ab9fba9", "localAddress": null, "token": "" } ], "status": "OK", "token": null, "useLocalCluster": true } }

HEAD 请求

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

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