GIS云套件

POST

URI

http://{server}:{port}/manager/web/api/service/instances

使用的方法

POST

父资源

service

介绍

通过API发布服务实例。

支持的表述格式：JSON

HTTP 请求方法

对如下 URI 执行 HTTP 请求，其中，{server}是服务网关的服务器名，需用实际服务网关IP替换；{port}是服务网关端口，需用实际网关端口替换。

http://{server}:{port}/manager/web/api/service/instances

POST 请求

发布服务实例。

请求头格式

content-type: application/json
authorization: Bearer {access_token}

请求参数

发布服务实例需要的参数：

名称	类型	含义
dataSource	String	数据源类型的名称（请参见API->service中的数据源类型名称表）
serviceTypes	String[]	服务类型的名称（请参见API->service中的服务类型名称表）
nodeType	String	节点类型的名称（请参见API->service中的节点类型名称表）
nodeNames	String[]	服务实例所在服务节点的名称，可输入已有节点名称或重新创建
isCreateNode	Boolean	是否为新建节点
serviceXml	String	自定义服务配置（请参见SuperMap iServer帮助文档《iServer体系结构中各层的配置》）
settings	String	配置服务，根据不同数据源以及发布的服务类型配置。

响应结构

返回服务实例是否发布成功，如果失败会给出错误信息：

字段		类型	说明
isSucceed		Boolean	是否执行成功，成功为true，失败为false
msg		String	如果执行失败，会显示错误信息；执行成功则为空
serviceInfos	componentName	String	服务组件名称
serviceInfos	interfaceName	String	服务接口名称

响应示例

在管理员登录的状态下，对http://192.168.17.139:32507/manager/web/api/service/instances执行POST请求，传入相关参数发布服务实例，如下所示：

{
    //数据源类型：文件型工作空间
    "dataSource": "workspace",
    //服务类型：REST-地图服务
    "serviceTypes":[
        "map-rest"
    ],
    //节点类型：通用节点
    "nodeType": "gisapplication",
    "nodeNames":[
        "Node1"
    ],
    "isCreateNode": true,
    "serviceXml": "",
    //数据源路径：/data/China400.smwu
    "settings":
    {
        "workspacePath": "/data/China400.smwu",
        "mapEditable": ""
    }
}

则返回的json格式的响应结果如下：

{
    "isSucceed": true,
    "msg": "",
    "serviceInfos": [
        {
            "componentName": "map-China400-astczjug0f",
            "interfaceName": "rest",
            "alias": "map-China400-astczjug0f-rest",
            "createTime": 1607676383491
        }
    ]
}