API

node

URI

http://<server>:<port>/imanager/cloud/web/nodes/{id}[.<format>]

支持的方法

GET

介绍

获取指定 GIS 环境详细信息。

支持的方法：

GET：获取指定 GIS 环境详细信息。

支持的表述格式：JSON。

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 json 输出格式为例加以说明，其中，supermapimanager 是服务器名。其中1 是 GIS 环境的 ID。

http://supermapimanager:8390/imanager/cloud/web/nodes/1.json

GET 请求

获取 GIS 环境的详细信息。

请求参数

名称	类型	含义
id	String	【必选参数】 GIS 环境id。

响应结构

GIS 服务器详细信息，由以下字段组成：

字段	类型	说明
availabelTime	long	环境可用时间
clusterSource	ClusterSource	集群来源，其中ClusterSource有两个值CREATED表示由系统创建，BUILDED组建而来，特指集群
cpu	int	虚拟机占用CPU内核数(个)
createTime	long	创建时间
description	String	描述信息
disk	int	虚拟机占用磁盘大小(GB)
hireDays	int	租用天数，默认0，表示无限制
hostName	String	环境的主机名
id	int	环境id
ip	String	环境ip
memory	int	虚拟机占用内存大小（GB）
nodeCount	int	环境个数或集群节点个数
nodeName	String	节点名称,如果不指定,则默认为VM的名称.如:sm_iServer-123
nodeSource	NodeSource	环境来源，其中NodeSource有两个值CREATED表示由系统创建，IMPORTED表示外部导入而来
nodeSpec	String	节点规格，对应模板规格名称
nodeStatus	NodeStatus	环境状态，包括 CREATING(正在创建)， STARTING(正在启动)， STOPPING(正在停止)， REBOOTING(正在重启)， RUNNING(运行中)， DELETING(正在删除)，STOPPED(已停止)，PAUSED(已暂停)，CREATE_FAILED(创建失败)， NOT_FOUND(不存在)，UNKNOWN(未知)， MOVING(正在移动)，RESIZING(正在调整)，RESIZED(正在调整)
operatingSystem	OperatingSystem	环境操作系统类型，包括WINDOWS，LINUX，UNKNOWN
parentId	int	父节点ID.针对集群子节点
password	String	环境密码
productInfos	List	环境中所部署的应用信息
productPath	String	环境中应用部署位置
resourceType	String	资源类型，对应模板类型名称
thresholdEntity	ThresholdEntity	环境阈值配置信息
updateTime	long	更新时间
userName	String	环境所属用户
uuid	String	环境uuid,对应虚拟平台的唯一标识

其中 ProductInfo 表示环境中所部署的应用信息详细信息，由以下字段组成：

字段	类型	说明
id	int	应用id
nodeId	int	环境id
name	String	应用名称
address	String	应用地址
productStatus	ProductStatus	应用状态，包括CREATING(正在创建)，STARTING(正在启动)， START_FAILED（启动失败），STOPPING(正在停止）, REBOOTING(正在重启)，RUNNING(运行中)， DELETING(正在删除)， STOPPED(已停止）, CREATE_FAILED(创建失败), NOT_FOUND(不存在)， UNKNOWN(未知)， DEPLOYING（环境配置中）

其中 ThresholdEntity 表示阈值实体详细信息，由以下字段组成：

字段	类型	说明
id	int	阈值id
maxCreateCount	int	最大新增节点数
maxUsage	float	最大阈值
minUsage	float	最小阈值
metricType	MetricType	性能监控类型，包括 CPU（cpu）, RAM(内存)， NETWORK(网络I/O)，INSTANCE(实例)
thresholdStatus	ThresholdStatus	动态伸缩的状态, 包括 ENABLED(动态伸缩开启)， DISABLED(动态伸缩关闭)， CONFLICT(动态伸缩出现冲突)

响应示例

如用户已经有GIS 服务器环境，可以通过对 server 资源执行 GET 请求得到具体的id，如 id 为545，以后获取该 GIS 环境具体信息时直接通过 node 资源获取。

http://supermapimanager:8390/imanager/cloud/web/nodes/545.json

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

{
  "availabelTime": 0,
  "clusterSource": "CREATED",
  "cpu": 4,
  "createTime": 1481680185354,
  "description": "",
  "disk": 30,
  "hireDays": 0,
  "hostName": "iserver-77",
  "id": 545,
  "ip": "192.168.22.77",
  "memory": 4,
  "nodeCount": 1,
  "nodeName": "iserver",
  "nodeSource": "CREATED",
  "nodeSpec": "MEDIUM",
  "nodeStatus": "CREATING",
  "operatingSystem": "LINUX",
  "parentId": -1,
  "password": "qeYasKBs",
  "productInfos": [
    {
      "address": "http://192.168.22.77:8090/iserver",
      "id": 581,
      "name": "iServer",
      "nodeId": 545,
      "productStatus": "CREATING",
      "webApp": true
    }
  ],
  "productPath": "/etc/icloud/SuperMapiServer",
  "resourceType": "SERVER",
  "thresholdEntity": {
    "id": 708,
    "maxCreateCount": 0,
    "maxUsage": 80,
    "metricType": "CPU",
    "minUsage": 20,
    "thresholdStatus": "DISABLED"
  },
  "thresholdId": 708,
  "updateTime": 1481680185354,
  "userName": "admin",
  "uuid": "VirtualMachine:vm-1542"
}