<managerRoot_uri>/instances[.<format>]
instances 为服务实例列表资源,通过 instances 资源您可以获取当前 GIS 系统中的所有服务实例及其配置信息。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/manager/instances.rjson
获取当前 GIS 系统中的所有服务实例及其配置信息。
对 instances 资源执行 GET 请求,返回的是一个服务实例列表,其中单个服务实例的表述的结构如下:
字段 | 类型 | 说明 |
authorizeSetting | AuthorizeSetting | 授权验证设置。 |
componentName | String | 使用的服务组件名称。 |
componentSetName | String | 使用的服务组件集名称。 |
componentType | String | 使用的服务组件类型。 |
enabled | boolean | 该服务实例是否可用,默认为 true,表示可用。 |
id | String | 服务实例的 id。 |
interfaceName | String | 使用的服务接口名称。 |
interfaceType | String | 使用的服务接口类型。 |
name | String | 当前服务实例的名称。 |
status | String | 服务状态信息,值可以为 INITIALIZING、OK 或 FAILED,分别表示服务正在初始化,启动成功和启动失败 。当 enabled 的值为 false 时,state 的值为 DISABLED。 |
对示例 instances 资源 http://localhost:8090/iserver/manager/instances.rjson 执行 GET 请求,返回的表述如下:
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 instances 资源是否存在,或者客户端是否有权限访问 instances 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 instances 资源是否支持<format>格式的表述。