managerRoot

URI

http://<server>:<port>/{iserver}/manager[.<format>]

管理服务根资源，列出所有被管理的项。{iserver}取值为 iserver 或 iportal，即在 iPortal 管理服务中的 URI 地址为 iportal。

iServer 支持全部的管理服务资源；iPortal 支持的管理服务资源包括：securityManager 、logs 、logsOperation、logsHar 资源及其子资源。

 portalManager 目录下是所有的门户管理资源，仅 iPortal 支持。

支持的方法

GET、HEAD

子资源

clusterOverview 、clusterConfig 、clusterMembers、clusterReporterConfig、dataflow、datastores、datastoreData、fileManager、globalSettings、instances 、logs 、logsOperation、logsHar 、processingServer、serverStatus 、securityManager 、streaming、serviceStorage、tileService、tileStorages、tileVersions、workspaces、workspaceTool、blockchainAdminCert、blockchainUserCert

介绍

managerRoot 资源是 SuperMap iServer 管理服务的根节点，也是访问管理服务 REST API 的入口。通过对 managerRoot 资源执行 GET 请求，可以获取它的子资源的信息，通过这些子资源可以对当前 GIS 服务进行管理，可以管理的项包括：服务组件集、服务提供者集、服务组件、服务提供者、服务接口、服务实例。

对于管理中的资源，通过 REST 方式访问时需要携带验证信息，比如可以在 http 请求头中携带基于 HTTP Form 认证登录时生成的 Cookie 信息，或者可以基于 Token 访问受保护的 REST 服务资源。其中 Cookie 信息可以在登录时获取，而 Token 可以通过 token 资源获取。

支持的方法：

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

资源层次

HTTP 请求方法

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

http://localhost:8090/iserver/manager.rjson

GET 请求

获取 managerRoot 资源的表述，即当前 GIS 服务中所有可以被管理的项的入口。

响应结构

对 managerRoot 资源执行 GET 请求，获取当前应用程序中所有资源信息列表，如服务组件（集合）、服务接口、服务提供者（集合）等信息列表。返回的单个资源表述的基本结构如下：  

字段 类型 说明
name String 资源名。
path String 资源 URI。
resourceConfigID String 当前资源实现类在资源配置文件中的标志。
resourceType ResourceType 资源的类型。
supportedMediaTypes List<MediaType> 资源支持的表述格式。

响应示例

对 managerRoot 资源 http://localhost:8090/iserver/manager.rjson，执行 GET 请求，则返回的 rjson 格式响应结果如下：

HEAD 请求

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

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

请参见