更新时间:2026-01-12 GMT+08:00

API概览

CSS提供的接口为符合RESTful API设计规范的自研接口。通过CSS的自研接口,您可以使用CSS的如表2所示的功能。

本服务已上线部分V2版本的API,请优先使用V2版本的API。

API V2

表1 V2版本的接口说明

类型

说明

创建集群V2

该接口用于创建拥有多种不同节点类型(ess,ess-cold,ess-client,ess-master)组合的集群。

重启集群V2

该接口可以用于重启当前集群拥有的全部节点类型,或部分节点类型组合的节点。

滚动重启

该接口会一个一个重启节点,在索引数量比较多的情况下耗时较长

开启自动创建快照功能

该接口用于打开自动备份功能。

关闭自动创建快照功能

该接口用于关闭自动备份功能。

删除配置文件V2

该接口用于删除配置文件。

删除自定义模板V2

该接口用于删除自定义模板。

API V1

表2 V1版本的接口说明

类型

说明

集群管理接口

可以通过接口创建集群、扩容集群、查看集群详情、获取实例规格列表等。

Kibana公网访问接口

Kibana公网访问功能支持通过接口进行开启、关闭、修改等操作。

日志管理接口

可以通过日志管理接口进行开启、关闭、修改、查询等操作。

公网访问接口

可以通过公网访问接口进行开启、关闭、修改等操作。

快照管理接口

快照功能可应用于数据备份与恢复,可以通过接口创建快照、恢复快照或者删除快照等。

参数配置接口

可以通过参数配置接口修改集群的参数配置。

负载均衡接口

可以通过负载均衡接口打开、关闭、获取负载均衡器信息。

表3 集群管理接口

API

说明

创建集群

该接口用于创建集群。

查询集群列表

该接口用于查询并显示集群列表以及集群的状态。

查询集群详情

该接口用于查询并显示单个集群详情。

删除集群

此接口用于删除集群。

修改集群名称

该接口用于修改集群名称。

修改密码

该接口用于修改集群密码。

更新集群路由

该接口用于更新集群路由。

获取集群路由

该接口用于获取集群路由。

重启集群

此接口用于重启集群,重启集群将导致业务中断。

下载安全证书

该接口用于下载安全证书。

集群内核升级

该接口用于将低版本的ES升级到高版本或同版本ES。

获取可升级的目标镜像ID

该接口用于获取当前集群的可升级目标镜像ID。

获取集群升级或切换AZ的详情信息

由于升级过程时间较长,该接口可以展示当前集群升级或者切换AZ时,节点的各个阶段信息。

重试升级失败任务

由于升级过程时间较长,可能由于网络等原因导致升级失败,可以通过该接口重试该任务或终止该任务的影响。

切换集群子网

该接口可以在集群创建成功后,切换集群子网,扩容等添加节点场景下使用新子网绑定新增节点。

切换集群实例AZ

该接口通过指定节点类型切换可用区。

表4 Kibana公网访问接口

API

说明

开启Kibana公网访问

该接口用于开启Kibana公网访问。

关闭Kibana公网访问

该接口用于关闭Kibana公网访问。

修改Kibana公网带宽

该接口用于修改Kibana公网带宽。

修改Kibana公网访问控制

该接口通过修改kibana白名单,修改kibana的访问权限。

关闭Kibana公网访问控制

该接口用于关闭Kibana公网访问控制。

表5 日志管理接口

API

说明

开启日志功能

该接口用于开启日志管理功能。

关闭日志功能

该接口用于关闭日志管理功能。

查询作业列表

该接口用于查询具体某个集群的日志任务记录列表。

查询日志基础配置

该接口用于日志基础配置查询。

修改日志基础配置

该接口用于修改日志基础配置。

开启日志自动备份策略

该接口用于日志自动备份策略开启。

关闭日志自动备份策略

该接口用于日志自动备份策略关闭。

备份日志

该接口用于备份日志。

查询日志

该接口用于查询日志信息。

连通性测试

该接口用于两个集群之间的连通性测试。

表6 公网访问接口

API

说明

开启公网访问

该接口用于开启公网访问。

关闭公网访问

该接口用于关闭公网访问。

修改公网访问带宽

该接口用于修改公网访问带宽。

开启公网访问控制白名单

该接口用于开启公网访问控制白名单。

关闭公网访问控制白名单

该接口用于关闭公网访问控制白名单。

表7 快照管理接口

API

说明

自动设置集群快照的基础配置(不推荐使用)

该接口用于自动设置集群快照的基础配置,包括配置OBS桶和IAM委托。

修改集群快照的基础配置

该接口用于修改集群快照的基础配置,可修改OBS桶和IAM委托。

手动创建快照

该接口用于手动创建一个快照。

恢复快照

该接口用于手动恢复一个快照。

删除快照

该接口用于删除快照。

设置自动创建快照策略

该接口用于设置自动创建快照,默认一天创建一个快照。

查询自动创建快照的策略

该接口用于查询集群自动创建快照的策略。

查询快照列表

该接口用于查询指定集群的快照列表。

停用快照功能

该接口用于停用快照功能。

表8 参数配置接口

API

说明

修改参数配置

该接口用于修改参数配置。

获取参数配置任务列表

该接口可获取参数配置的任务列表。

获取参数配置列表

该接口用于获取当前集群现有的参数配置列表。

表9 负载均衡

API

说明

查询集群支持的elbv3负载均衡器

展示查询集群支持的elbv3负载均衡器。

打开或关闭ES负载均衡器

该接口打开或关闭ES负载均衡器。

ES监听器配置

该接口用于es监听器配置。

获取该esELB的信息,以及页面需要展示健康检查状态

该接口用于获取该ES集群的ELB信息,以及页面需要展示健康检查状态。

更新ES监听器

该接口用于更新ES监听器。

查询证书列表

该接口用于查询证书列表。