更新时间:2025-08-14 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公网访问功能支持通过接口进行开启、关闭、修改等操作。

Logstash接口

可以通过接口创建Logstash类型集群的配置文件、启动pipeline迁移数据等操作。

日志管理接口

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

公网访问接口

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

快照管理接口

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

终端节点接口

可以通过终端节点接口进行开启、关闭、获取连接、更新连接等操作。

参数配置接口

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

负载均衡接口

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

智能运维接口

可以通过智能运维接口创建、删除、获取检测任务。

表3 集群管理接口

API

说明

创建集群

该接口用于创建集群。

查询集群列表

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

查询集群详情

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

删除集群

此接口用于删除集群。

按需集群转包周期

该接口用于按需集群转包周期集群。

修改集群名称

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

修改密码

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

重启集群

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

扩容集群

该接口用于集群扩容实例(仅支持扩容elasticsearch实例)。

扩容实例的数量和存储容量

该接口用于集群扩容不同类型实例的个数以及存储容量。

变更规格

该接口用于变更集群规格。

获取实例规格列表

该接口用于查询并显示支持的实例规格对应的ID。

查询所有标签

该接口用于查询指定region下的所有标签集合。

查询指定集群的标签

该接口用于查询指定集群的标签信息。

添加指定集群标签

该接口用于给指定集群添加标签。

删除集群标签

此接口用于删除集群标签。

更新集群路由

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

批量添加或删除集群标签

该接口用于对集群批量添加或删除标签。

获取集群路由

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

指定节点缩容

该接口可以对集群现有节点中指定节点进行缩容。

指定节点类型规格变更

修改集群规格。支持修改ess, ess-cold, ess-client, ess-master节点类型。

指定节点类型缩容

该接口用于集群缩容不同类型实例的个数以及存储容量。

下载安全证书

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

节点替换

该接口用于替换失败节点。

安全模式修改

该接口用于切换集群的安全模式。

添加独立master、client

该接口用于添加master或者client节点。

集群内核升级

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

获取可升级的目标镜像ID

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

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

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

重试升级失败任务

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

切换安全组

该接口可以在集群创建成功后,修改安全组。

切换集群子网

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

切换集群实例AZ

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

表4 词库管理接口

API

说明

加载自定义词库

该接口用于加载存放于OBS的自定义词库。

查询自定义词库状态

该接口用于查询自定义词库的加载状态。

删除自定义词库

该接口用于删除自定义词库。

表5 Kibana公网访问接口

API

说明

开启Kibana公网访问

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

关闭Kibana公网访问

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

修改Kibana公网带宽

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

修改Kibana公网访问控制

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

关闭Kibana公网访问控制

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

表6 Logstash接口

API

说明

创建配置文件

该接口用于创建配置文件。

更新配置文件

该接口用于更新配置文件。

启动pipeline迁移数据

该接口用于启动pipeline迁移数据。

停止pipeline迁移数据

该接口用于停止pipeline迁移数据。

添加到自定义模板

该接口用于添加到自定义模板。

查询pipeline列表

该接口用于查询pipeline列表。

查询配置文件列表

查询配置文件列表。

连通性测试

该接口用于连通性测试。

查询模板列表

该接口用于查询模板列表。

查询操作记录

该接口用于查询操作记录。

查询配置文件内容

该接口用于查询配置文件内容。

删除配置文件

删除配置文件。

删除自定义模板

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

热启动pipeline迁移数据

该接口用于热启动pipeline迁移数据。

热停止pipeline迁移数据

该接口用于热停止pipeline迁移数据。

上传证书文件

该接口用于上传证书文件。

查询证书列表

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

查询证书文件信息

该接口用于查询证书文件信息。

删除证书文件

该接口用于删除证书文件。

强制重启集群VMs

重启过程中集群不可用,请谨慎操作。 工作中状态的集群,重启过程会主动停止logstash进程,管道列表“是否保持常驻”值为否,会将所有运行中管道状态置为已停止。

表7 日志管理接口

API

说明

开启日志功能

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

关闭日志功能

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

查询作业列表

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

查询日志基础配置

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

修改日志基础配置

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

开启日志自动备份策略

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

关闭日志自动备份策略

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

备份日志

该接口用于备份日志。

查询日志

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

连通性测试

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

表8 公网访问接口

API

说明

开启公网访问

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

关闭公网访问

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

修改公网访问带宽

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

开启公网访问控制白名单

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

关闭公网访问控制白名单

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

表9 快照管理接口

API

说明

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

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

修改集群快照的基础配置

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

手动创建快照

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

恢复快照

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

删除快照

该接口用于删除快照。

设置自动创建快照策略

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

查询自动创建快照的策略

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

查询快照列表

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

停用快照功能

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

表10 终端节点接口

API

说明

开启终端节点服务

该接口用于开启终端节点服务。

关闭终端节点服务

该接口用于关闭终端节点服务。

获取终端节点连接

该接口用于获取终端节点连接。

更新终端节点连接

该接口用于更新终端节点连接。

修改终端节点服务白名单

该接口用于修改终端节点服务访问控制。

表11 参数配置接口

API

说明

修改参数配置

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

获取参数配置任务列表

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

获取参数配置列表

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

表12 负载均衡

API

说明

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

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

打开或关闭ES负载均衡器

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

ES监听器配置

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

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

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

更新ES监听器

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

查询证书列表

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

表13 智能运维

API

说明

获取智能运维任务列表及详情

该接口用于获取智能运维任务列表及详情。

创建一次集群检测任务

该接口用于创建一个集群检测任务。

删除一个检测任务记录

该接口用于删除一个检测任务记录。

获取智能运维告警可用的SMN主题

该接口用于获取智能运维告警可用的SMN主题。

相关文档