{"componentChunkName":"component---src-templates-microservices-js","path":"/en/microservices/instancecreate/","result":{"data":{"markdownRemark":{"html":"

POST

\n

URI

\n

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

\n

Method

\n

POST

\n

Parent Resource

\n

service

\n

Introduction

\n

Publish service instance by API.

\n

Supported Interchange Format: JSON

\n

HTTP Request Method

\n

Execute HTTP request to the URI below. In the URI below, {server} is the server of gateway, replace it by the actual gateway IP. {port} is the port of gateway, replace it by the actual gateway port.

\n

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

\n

POST Request

\n

Publish the service instance.

\n

The Format of Headers

\n
content-type: application/json\nauthorization: Bearer {access_token}
\n

Request Params

\n

The necessary parameters to publish the service instance:

\n\n\n\n\n\t\n\t\t\n\t\t\n\t\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\n
NameTypeExplanation
dataSourceStringThe type of datasource(please refer API > service to check the name of datasource types)
serviceTypesString[]The type of service(please refer API > service to check the name of service types)
nodeTypeStringThe type of node(please refer API > service to check the name of node types)
nodeNamesString[]The name of service node. Fill in an existing node or create a new one.
isCreateNodeBooleanWhether to create a new node
serviceXmlStringCustomize service configuration(please refer to SuperMap iServer Documentation)
settingsStringConfig service according to the datasource type and service type.
\n

Response Structure

\n

The returned response would tell whether published successful, and provide the error information if failed.

\n\n\n\n\n\n\t\n\t\t\n\t\t\n\t\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\n\t\n\t\t\n\t\t\n\t\n
FieldTypeExplanation
isSucceedBooleanThe result of the request. True means succeed, false means failed
msgStringIf the execution failed, the result would return the error information. The result would be empty if succeed.
serviceInfoscomponentNameStringThe name of the service component
interfaceNameThe name of the service interface
\n

Response Case

\n

Execute POST request for http://192.168.17.139:32507/manager/web/api/service/instances, input parameters to publish the service instance.

\n
{\n    //The type of datasource: files workspace\n    "dataSource": "workspace",\n    //The type of service: REST-Map Service\n    "serviceTypes":[\n        "map-rest"\n    ],\n    //The type of nodeļ¼šgeneral node\n    "nodeType": "gisapplication",\n    "nodeNames":[\n        "Node1"\n    ],\n    "isCreateNode": true,\n    "serviceXml": "",\n    //The path of datasource: /data/China400.smwu\n    "settings":\n    {\n        "workspacePath": "/data/China400.smwu",\n        "mapEditable": ""\n    }\n}
\n

The returned response in json format:

\n
{\n    "isSucceed": true,\n    "msg": "",\n    "serviceInfos": [\n        {\n            "componentName": "map-China400-astczjug0f",\n            "interfaceName": "rest",\n            "alias": "map-China400-astczjug0f-rest",\n            "createTime": 1607676383491\n        }\n    ]\n}
","frontmatter":{"title":"GIS Cloud Suite","next":null,"prev":null},"fields":{"path":"content/microservices/instancecreate.en.md","slug":"/en/microservices/instancecreate/","langKey":"en"}}},"pageContext":{"slug":"/en/microservices/instancecreate/"}}}