instances

URI

<managerRoot_uri>/instances[.<format>]

支持的方法

GET、HEAD

父资源

managerRoot

子资源

instance、authorize

介绍

instances 为服务实例列表资源，通过 instances 资源您可以获取当前 GIS 系统中的所有服务实例及其配置信息。

支持的方法：

• GET：获取当前 GIS 系统中的所有服务实例及其配置信息。
• HEAD：检查 instances 资源是否存在，或权限是否可以访问 instances 资源。

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

资源层次

HTTP 请求方法

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

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

GET 请求

获取当前 GIS 系统中的所有服务实例及其配置信息。

响应结构

对 instances 资源执行 GET 请求，返回的是一个服务实例列表，其中单个服务实例的表述的结构如下：

响应示例

对示例 instances 资源 http://localhost:8090/iserver/manager/instances.rjson 执行 GET 请求，返回的表述如下：

[ { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": null, "componentSetName": "components-handler", "componentType": "componentSet", "enabled": true, "id": null, "interfaceName": "handler", "interfaceType": "com.supermap.services.handler.HandlerServlet", "name": "components-handler/handler", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [ "usercommon" ], "permittedRoles": [], "type": "AUTHENTICATED" }, "componentName": null, "componentSetName": "components-rest", "componentType": "componentSet", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "components-rest/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [ "usercommon" ], "permittedRoles": [], "type": "AUTHENTICATED" }, "componentName": "data-ChinaProvinces", "componentSetName": null, "componentType": "com.supermap.services.components.impl.DataImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "data-ChinaProvinces/rest", "status": "FAILED" }, { "authorizeSetting": { "deniedRoles": [ "usercommon" ], "permittedRoles": [ "USER" ], "type": "AUTHENTICATED" }, "componentName": "data-changchun", "componentSetName": null, "componentType": "com.supermap.services.components.impl.DataImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "data-changchun/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "data-jingjin", "componentSetName": null, "componentType": "com.supermap.services.components.impl.DataImpl", "enabled": true, "id": null, "interfaceName": "wcs111", "interfaceType": "com.supermap.services.wcs.WCSServlet", "name": "data-jingjin/wcs111", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "data-jingjin", "componentSetName": null, "componentType": "com.supermap.services.components.impl.DataImpl", "enabled": true, "id": null, "interfaceName": "wcs112", "interfaceType": "com.supermap.services.wcs.WCSServlet", "name": "data-jingjin/wcs112", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "data-3D", "componentSetName": null, "componentType": "com.supermap.services.components.impl.DataImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "data-3D/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "data-rest-jingjin", "componentSetName": null, "componentType": "com.supermap.services.components.impl.DataImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "data-rest-jingjin/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "data-rest-jingjin", "componentSetName": null, "componentType": "com.supermap.services.components.impl.DataImpl", "enabled": true, "id": null, "interfaceName": "wfs100", "interfaceType": "com.supermap.services.wfs.WFSServlet", "name": "data-rest-jingjin/wfs100", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "data-world", "componentSetName": null, "componentType": "com.supermap.services.components.impl.DataImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "data-world/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "data-world", "componentSetName": null, "componentType": "com.supermap.services.components.impl.DataImpl", "enabled": true, "id": null, "interfaceName": "wfs100", "interfaceType": "com.supermap.services.wfs.WFSServlet", "name": "data-world/wfs100", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "facilityAnalyst3D-Pipe3D", "componentSetName": null, "componentType": "com.supermap.services.components.impl.FacilityAnalyst3DImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "facilityAnalyst3D-Pipe3D/rest", "status": "FAILED" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-ChinaProvinces", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "map-ChinaProvinces/rest", "status": "FAILED" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-changchun", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "map-changchun/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-china400", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "map-china400/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-china400", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "wms111", "interfaceType": "com.supermap.services.wms.WMSServlet", "name": "map-china400/wms111", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-china400", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "wms130", "interfaceType": "com.supermap.services.wms.WMSServlet", "name": "map-china400/wms130", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-china400", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "wmts-china", "interfaceType": "com.supermap.services.wmts.WMTSServlet", "name": "map-china400/wmts-china", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-jingjin", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "map-jingjin/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-temperature", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "map-temperature/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-world", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "map-world/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-world", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "wms130", "interfaceType": "com.supermap.services.wms.WMSServlet", "name": "map-world/wms130", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-world", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "wmts-china", "interfaceType": "com.supermap.services.wmts.WMTSServlet", "name": "map-world/wmts-china", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "map-world", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "wmts100", "interfaceType": "com.supermap.services.wmts.WMTSServlet", "name": "map-world/wmts100", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "maps", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "wms111", "interfaceType": "com.supermap.services.wms.WMSServlet", "name": "maps/wms111", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "maps", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "wms130", "interfaceType": "com.supermap.services.wms.WMSServlet", "name": "maps/wms130", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "maps", "componentSetName": null, "componentType": "com.supermap.services.components.impl.MapImpl", "enabled": true, "id": null, "interfaceName": "wmts100", "interfaceType": "com.supermap.services.wmts.WMTSServlet", "name": "maps/wmts100", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "3D-ChinaProvinces", "componentSetName": null, "componentType": "com.supermap.services.components.impl.RealspaceImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "3D-ChinaProvinces/rest", "status": "FAILED" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "3D-Pipe3D", "componentSetName": null, "componentType": "com.supermap.services.components.impl.RealspaceImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "3D-Pipe3D/rest", "status": "FAILED" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "3D-sample", "componentSetName": null, "componentType": "com.supermap.services.components.impl.RealspaceImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "3D-sample/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "spatialanalyst-changchun", "componentSetName": null, "componentType": "com.supermap.services.components.impl.SpatialAnalystImpl", "enabled": true, "id": null, "interfaceName": "restjsr", "interfaceType": "com.supermap.services.rest.JaxrsServletForJersey", "name": "spatialanalyst-changchun/restjsr", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "spatialanalyst-changchun", "componentSetName": null, "componentType": "com.supermap.services.components.impl.SpatialAnalystImpl", "enabled": true, "id": null, "interfaceName": "wps100", "interfaceType": "com.supermap.services.wps.WPSServlet", "name": "spatialanalyst-changchun/wps100", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "spatialanalyst-sample", "componentSetName": null, "componentType": "com.supermap.services.components.impl.SpatialAnalystImpl", "enabled": true, "id": null, "interfaceName": "restjsr", "interfaceType": "com.supermap.services.rest.JaxrsServletForJersey", "name": "spatialanalyst-sample/restjsr", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "traffictransferanalyst-sample", "componentSetName": null, "componentType": "com.supermap.services.components.impl.TrafficTransferAnalystImpl", "enabled": true, "id": null, "interfaceName": "restjsr", "interfaceType": "com.supermap.services.rest.JaxrsServletForJersey", "name": "traffictransferanalyst-sample/restjsr", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "traffictransferanalyst-sample", "componentSetName": null, "componentType": "com.supermap.services.components.impl.TrafficTransferAnalystImpl", "enabled": true, "id": null, "interfaceName": "wps100", "interfaceType": "com.supermap.services.wps.WPSServlet", "name": "traffictransferanalyst-sample/wps100", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "transportationanalyst-sample", "componentSetName": null, "componentType": "com.supermap.services.components.impl.TransportationAnalystImpl", "enabled": true, "id": null, "interfaceName": "rest", "interfaceType": "com.supermap.services.rest.RestServlet", "name": "transportationanalyst-sample/rest", "status": "OK" }, { "authorizeSetting": { "deniedRoles": [], "permittedRoles": [], "type": "PUBLIC" }, "componentName": "transportationanalyst-sample", "componentSetName": null, "componentType": "com.supermap.services.components.impl.TransportationAnalystImpl", "enabled": true, "id": null, "interfaceName": "wps100", "interfaceType": "com.supermap.services.wps.WPSServlet", "name": "transportationanalyst-sample/wps100", "status": "OK" } ]

HEAD 请求

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

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

请参见

• managerRoot、instance、authorize
• 客户端构建 REST 请求
• 状态码列表及说明
• SuperMap iServer REST API 表述格式介绍
• 服务管理资源层次结构