instance

URI

<instances_uri>/{serviceName}[.<format>]

支持的方法

GET、PUT、HEAD

父资源

instances

介绍

 instance 为服务实例资源，通过 instance 资源您可以获取服务实例配置信息，如服务实例对应的服务组件、组件集合以及服务接口等信息。

支持的方法：

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

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名，{scname} 是服务组件名，{siname} 是服务接口名 ，服务实例名 {serviceName} 由 {scname} 和 {siname} 共同构成。

http://supermapiserver:8090/iserver/manager/instances/{scname}/{siname}.rjson

GET 请求

获取服务实例配置信息。

响应结构

对 instance 资源执行 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。

响应示例

对 instance 资源执行 GET 请求（http://localhost:8090/iserver/manager/instances/map-china400/rest.rjson），返回服务实例 map-china400/rest 对应的 rjson 表述如下：

{

    "authorizeSetting": {

        "deniedRoles": [],

        "permittedRoles": [],

        "type": "PUBLIC"

    },

    "componentName": "map-china400",

    "componentSetName": null,

    "componentType": "com.supermap.services.components.impl.MapImpl",

    "enabled": true,

    "id": null,

    "interfaceName": "rest",

    "interfaceType": null,

    "name": "map-china400/rest",

    "status": "OK"

}

 

HEAD 请求

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

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

请参见