集群

Elasticsearch BES

  • 邀测版存储计算分离套餐介绍
  • 功能发布记录
  • 产品描述
    • 基本概念
    • 关键特性
    • 产品介绍
    • 产品性能
      • 4核16GB512GB通用型的3个数据节点实例基准性能指标
      • 8核16GB512GB计算型的3个数据节点实例基准性能测试
      • 16核32GB512GB计算型的3个数据节点实例基准性能指标
      • 4核8GB512GB计算型的3个数据节点实例基准性能测试
      • 8核32GB512GB通用型的3个数据节点实例基准性能指标
      • 16核64GB512GB通用型的3个数据节点实例基准性能指标
      • 概述
  • Python-SDK
    • 实例
    • 异常
    • 日志
    • 节点配置类型
    • 版本更新记录
    • 快速入门
    • 集群
    • BesClient
    • 安装SDK工具包
    • 概述
  • Kibana
    • Kibana使用指南
  • Logstash
    • Logstash使用指南
    • 实例管理
      • 实例详情信息
      • 实例扩缩容
      • 管道管理
      • 创建实例
      • 实例列表
      • 删除实例
  • 开发指南
    • Elasticsearch Restful API
    • 通过其他客户端访问Elasticsearch
    • Elasticsearch Java客户端
      • Low Level REST Client
      • Rest Client操作向量索引示例
      • Java REST Client
      • High Level REST Client
  • Java-SDK
    • 实例
    • 异常
    • 日志
    • 节点配置类型
    • 版本更新记录
    • 快速入门
    • 集群
    • BesClient
    • 安装SDK工具包
    • 概述
  • 向量检索特性
    • 资源规划
    • 关键概念
    • 应用场景
    • 快速入门
    • 算法介绍
    • 能力简介
    • 向量数据库
    • 操作指南
      • 写入和查询数据
      • 训练模型
      • 向量索引缓存管理
      • 创建索引
      • 基于Reciprocal Rank Fusion的融合查询
      • 参数优化
      • 7.4版本兼容说明
    • 最佳实践
      • 调优建议
      • BES RAG 最佳实践:基于LangChain+BES的私域知识的QA问答系统
    • 迁移方案
      • ES dense vector 切换为BES方案
  • ELK
    • 基于ELK构建日志分析系统
  • 增强特性
    • 慢查询隔离
    • 百度NLP中文分词词典动态更新
    • 百度NLP中文分词插件
    • 基于段文件的主从复制
    • 基于BOS的冷热数据分离
  • 快速入门
    • 访问Elasticsearch服务
    • 导入数据并搜索
    • 创建集群
    • 集群资源评估
  • 典型实践
    • 使用BSC将BOS中的数据导入Es
    • 使用BSC将Kafka中的数据导入Es
    • 基于CCR实现多集群跨地域高可用
    • 基于节点磁盘介质的冷热数据分离
  • 服务等级协议SLA
    • 数据迁移服务协议
    • BES服务等级协议SLA(V1.0)
  • 常见问题
    • Spark访问Es常见问题
    • Elasticsearch系统常见问题
    • 常见问题总览
  • 产品定价
    • 预付费
    • 计费说明
    • 配置变更费用说明
    • 后付费
  • API文档
    • 概述
    • 自动续费相关接口
      • 续费列表
      • 查看自动续费
      • 查看自动续费规则列表
      • 续费操作
      • 更新自动续费规则
      • 删除自动续费规则
      • 创建自动续费规则
    • 插件配置接口
      • 上传自定义插件
      • 卸载系统默认插件
      • 上传nlp词典
      • 安装系统默认插件
      • 获取默认和自定义插件列表
      • 卸载自定义插件
      • 安装自定义插件
      • 删除自定义插件
      • 查看nlp词典
    • 日志管理相关接口
      • 查看日志导出任务记录
      • 创建日志导出任务
      • 日志设置
      • 日志查询
    • 标签接口
      • 查询标签列表
      • 批量新增标签
      • 单个集群更新标签
    • 智能巡检接口
      • 查看近7天已完成的巡检任务列表
      • 近七天巡检概况
      • 查看手动巡检任务的配置
      • 集群巡检授权
      • 列举所有可选巡检项
      • 查询是否可以提交巡检任务
      • 最新一次巡检概况
      • 查看集群是否开启自动巡检
      • 修改手动巡检任务的配置
      • 开启或关闭自动巡检
      • 提交手动巡检任务
      • 查询今日已执行完成的手动巡检次数
      • 查看某巡检任务的执行状态和结果
    • 集群相关接口
      • 获取操作历史信息
      • 删除集群
      • 新增节点类型
      • 开启和关闭https
      • 查看集群详情信息
      • 重置密码
      • EIP绑定
      • EIP解绑
      • 是否开启Grafana监控
      • 获取数据量观测数据
      • 查看集群列表
      • 上传NLP分词词典
      • 创建集群
      • 智能评估
      • 集群blb信息
      • 用户可用代金券列表
      • 停止集群
      • 扩容集群
      • 启动集群
      • 重启集群
    • 实例相关接口
      • 批量停止实例
      • 启动实例
      • 查看缩容节点列表
      • 数据迁移
      • 数据迁移系统建议
      • 批量启动实例
      • 数据迁移回滚
      • 停止实例
      • 数据迁移节点列表
      • 删除实例
    • 配置修改相关接口
      • 获取同义词文件列表
      • 查看集群配置
      • 删除同义词配置文件
      • 上传同义词配置文件
      • 配置修改
    • 定时调度
      • 更新定时调度任务
      • 删除定时调度任务
      • 创建和更新定时调度任务
      • 查看定时调度任务
  • API3.0
    • 集群相关接口
      • 删除集群
  • Elasticsearch
    • 用户手册
      • YML参数配置
      • 权限管理
      • 智能巡检
      • 数据迁移
      • 基于BOS的快照与恢复
      • 集群列表
      • 账号使用说明
      • 多可用区部署
      • 定时调度
      • 数据量观测
      • 日志查询
        • 日志查询(旧)
        • 日志查询(新)
        • 日志导出
        • 查询语法
      • 集群配置
        • 配置同义词
      • 插件管理
        • 上传与安装自定义插件
        • Elasticsearch插件列表
        • 系统默认插件
          • analysis-pinyin拼音分词插件
          • IK中文分词插件与动态更新词典
          • compression-zstd插件
          • CCR插件
          • 限流插件
          • 动态同义词插件
          • 简繁体转换插件
          • ingest attachment插件
          • SQL插件
      • 配置变更
        • 节点数据迁移
        • 集群变配说明与建议
        • 集群扩缩容
      • 版本升级
        • 升级版本
        • 内核版本说明
        • 升级检查
      • 集群监控报警
        • 监控查看及指标说明
        • 配置报警
      • 集群管理
        • 集群重启
        • 变更HTTPS协议用户指南
        • 节点启停
        • 查看集群信息
        • 集群创建
        • 公网绑定
        • 修改集群名称
        • 跨可用区迁移集群
        • 集群删除
        • 集群列表
        • 自动续费
        • 密码重置
        • ES服务区域代码
      • 账户管理
        • 多用户访问控制
所有文档
menu
没有找到结果,请重新输入

Elasticsearch BES

  • 邀测版存储计算分离套餐介绍
  • 功能发布记录
  • 产品描述
    • 基本概念
    • 关键特性
    • 产品介绍
    • 产品性能
      • 4核16GB512GB通用型的3个数据节点实例基准性能指标
      • 8核16GB512GB计算型的3个数据节点实例基准性能测试
      • 16核32GB512GB计算型的3个数据节点实例基准性能指标
      • 4核8GB512GB计算型的3个数据节点实例基准性能测试
      • 8核32GB512GB通用型的3个数据节点实例基准性能指标
      • 16核64GB512GB通用型的3个数据节点实例基准性能指标
      • 概述
  • Python-SDK
    • 实例
    • 异常
    • 日志
    • 节点配置类型
    • 版本更新记录
    • 快速入门
    • 集群
    • BesClient
    • 安装SDK工具包
    • 概述
  • Kibana
    • Kibana使用指南
  • Logstash
    • Logstash使用指南
    • 实例管理
      • 实例详情信息
      • 实例扩缩容
      • 管道管理
      • 创建实例
      • 实例列表
      • 删除实例
  • 开发指南
    • Elasticsearch Restful API
    • 通过其他客户端访问Elasticsearch
    • Elasticsearch Java客户端
      • Low Level REST Client
      • Rest Client操作向量索引示例
      • Java REST Client
      • High Level REST Client
  • Java-SDK
    • 实例
    • 异常
    • 日志
    • 节点配置类型
    • 版本更新记录
    • 快速入门
    • 集群
    • BesClient
    • 安装SDK工具包
    • 概述
  • 向量检索特性
    • 资源规划
    • 关键概念
    • 应用场景
    • 快速入门
    • 算法介绍
    • 能力简介
    • 向量数据库
    • 操作指南
      • 写入和查询数据
      • 训练模型
      • 向量索引缓存管理
      • 创建索引
      • 基于Reciprocal Rank Fusion的融合查询
      • 参数优化
      • 7.4版本兼容说明
    • 最佳实践
      • 调优建议
      • BES RAG 最佳实践:基于LangChain+BES的私域知识的QA问答系统
    • 迁移方案
      • ES dense vector 切换为BES方案
  • ELK
    • 基于ELK构建日志分析系统
  • 增强特性
    • 慢查询隔离
    • 百度NLP中文分词词典动态更新
    • 百度NLP中文分词插件
    • 基于段文件的主从复制
    • 基于BOS的冷热数据分离
  • 快速入门
    • 访问Elasticsearch服务
    • 导入数据并搜索
    • 创建集群
    • 集群资源评估
  • 典型实践
    • 使用BSC将BOS中的数据导入Es
    • 使用BSC将Kafka中的数据导入Es
    • 基于CCR实现多集群跨地域高可用
    • 基于节点磁盘介质的冷热数据分离
  • 服务等级协议SLA
    • 数据迁移服务协议
    • BES服务等级协议SLA(V1.0)
  • 常见问题
    • Spark访问Es常见问题
    • Elasticsearch系统常见问题
    • 常见问题总览
  • 产品定价
    • 预付费
    • 计费说明
    • 配置变更费用说明
    • 后付费
  • API文档
    • 概述
    • 自动续费相关接口
      • 续费列表
      • 查看自动续费
      • 查看自动续费规则列表
      • 续费操作
      • 更新自动续费规则
      • 删除自动续费规则
      • 创建自动续费规则
    • 插件配置接口
      • 上传自定义插件
      • 卸载系统默认插件
      • 上传nlp词典
      • 安装系统默认插件
      • 获取默认和自定义插件列表
      • 卸载自定义插件
      • 安装自定义插件
      • 删除自定义插件
      • 查看nlp词典
    • 日志管理相关接口
      • 查看日志导出任务记录
      • 创建日志导出任务
      • 日志设置
      • 日志查询
    • 标签接口
      • 查询标签列表
      • 批量新增标签
      • 单个集群更新标签
    • 智能巡检接口
      • 查看近7天已完成的巡检任务列表
      • 近七天巡检概况
      • 查看手动巡检任务的配置
      • 集群巡检授权
      • 列举所有可选巡检项
      • 查询是否可以提交巡检任务
      • 最新一次巡检概况
      • 查看集群是否开启自动巡检
      • 修改手动巡检任务的配置
      • 开启或关闭自动巡检
      • 提交手动巡检任务
      • 查询今日已执行完成的手动巡检次数
      • 查看某巡检任务的执行状态和结果
    • 集群相关接口
      • 获取操作历史信息
      • 删除集群
      • 新增节点类型
      • 开启和关闭https
      • 查看集群详情信息
      • 重置密码
      • EIP绑定
      • EIP解绑
      • 是否开启Grafana监控
      • 获取数据量观测数据
      • 查看集群列表
      • 上传NLP分词词典
      • 创建集群
      • 智能评估
      • 集群blb信息
      • 用户可用代金券列表
      • 停止集群
      • 扩容集群
      • 启动集群
      • 重启集群
    • 实例相关接口
      • 批量停止实例
      • 启动实例
      • 查看缩容节点列表
      • 数据迁移
      • 数据迁移系统建议
      • 批量启动实例
      • 数据迁移回滚
      • 停止实例
      • 数据迁移节点列表
      • 删除实例
    • 配置修改相关接口
      • 获取同义词文件列表
      • 查看集群配置
      • 删除同义词配置文件
      • 上传同义词配置文件
      • 配置修改
    • 定时调度
      • 更新定时调度任务
      • 删除定时调度任务
      • 创建和更新定时调度任务
      • 查看定时调度任务
  • API3.0
    • 集群相关接口
      • 删除集群
  • Elasticsearch
    • 用户手册
      • YML参数配置
      • 权限管理
      • 智能巡检
      • 数据迁移
      • 基于BOS的快照与恢复
      • 集群列表
      • 账号使用说明
      • 多可用区部署
      • 定时调度
      • 数据量观测
      • 日志查询
        • 日志查询(旧)
        • 日志查询(新)
        • 日志导出
        • 查询语法
      • 集群配置
        • 配置同义词
      • 插件管理
        • 上传与安装自定义插件
        • Elasticsearch插件列表
        • 系统默认插件
          • analysis-pinyin拼音分词插件
          • IK中文分词插件与动态更新词典
          • compression-zstd插件
          • CCR插件
          • 限流插件
          • 动态同义词插件
          • 简繁体转换插件
          • ingest attachment插件
          • SQL插件
      • 配置变更
        • 节点数据迁移
        • 集群变配说明与建议
        • 集群扩缩容
      • 版本升级
        • 升级版本
        • 内核版本说明
        • 升级检查
      • 集群监控报警
        • 监控查看及指标说明
        • 配置报警
      • 集群管理
        • 集群重启
        • 变更HTTPS协议用户指南
        • 节点启停
        • 查看集群信息
        • 集群创建
        • 公网绑定
        • 修改集群名称
        • 跨可用区迁移集群
        • 集群删除
        • 集群列表
        • 自动续费
        • 密码重置
        • ES服务区域代码
      • 账户管理
        • 多用户访问控制
  • 文档中心
  • arrow
  • ElasticsearchBES
  • arrow
  • Java-SDK
  • arrow
  • 集群
本页目录
  • 创建集群(老套餐)
  • 创建集群(新套餐)
  • 创建带有专用master节点的集群
  • 集群升配
  • 扩容集群
  • 查询集群列表
  • 查询集群详情
  • 停止集群
  • 启动集群
  • 删除集群
  • 续费列表
  • 续费操作
  • 创建自动续费规则
  • 查看自动续费规则列表
  • 更新自动续费规则
  • 删除自动续费规则

集群

更新时间:2025-08-20

创建集群(老套餐)

如下代码可以新建一个集群,集群包含1个es_node节点和1个kibana节点。

Java
1public void createCluster(BesClient client) {
2    // 构建集群的请求体
3    BesCreateClusterRequest createOrderRequestVo = new BesCreateClusterRequest();
4    // 创建节点类型模板
5    BesCreateClusterRequest.ModuleInfo dataNodeModuleInfo = new BesCreateClusterRequest.ModuleInfo();
6    // 创建节点类型模板
7    BesCreateClusterRequest.ModuleInfo kibanaNodeModuleInfo2 = new BesCreateClusterRequest.ModuleInfo();
8    List<BesCreateClusterRequest.ModuleInfo> moduleInfoList = new ArrayList<BesCreateClusterRequest.ModuleInfo>();
9    // 创建集群的付费方式
10    BesCreateClusterRequest.ClusterBilling clusterBilling = new BesCreateClusterRequest.ClusterBilling();
11    // 设置创建集群的名称
12    createOrderRequestVo.setName({clusterName});
13    // 设置创建集群的密码
14    createOrderRequestVo.setPassword({passwrod});
15    // 设置集群所配置的节点类型
16    dataNodeModuleInfo.setType(ModuleType.ES_NODE);
17    // 设置该节点类型的节点数量
18    dataNodeModuleInfo.setInstanceNum(1);
19    // 设置es节点的机型(新老节点配置见代码下方说明)
20    dataNodeModuleInfo.setSlotType(SlotType.CALCULATE_V1);
21    // 设置集群所配置的节点类型
22    kibanaNodeModuleInfo.setType(ModuleType.KIBANA);
23    // 设置该节点类型的节点数量 (必须创建1个kibana节点)
24    kibanaNodeModuleInfo.setInstanceNum(1);
25    // 指定kibana节点的机型 老套餐是免费附赠的 值必须和ES节点配置相同 (新老节点配置见代码下方说明)
26    kibanaNodeModuleInfo.setSlotType(SlotType.CALCULATE_V1);
27    moduleInfoList.add(dataNodeModuleInfo);
28    moduleInfoList.add(kibanaNodeModuleInfo);
29    // 设置集群的付费方式为预付费 (后付费为POSTPAY)
30    clusterBilling.setPaymentType(PaymentType.PREPAY);
31    // 设置创建集群的时长 (后付费为0)
32    clusterBilling.setTime(1);
33    createOrderRequestVo.setModules(moduleInfoList);
34    createOrderRequestVo.setBilling(clusterBilling);
35    // 设置集群版本 (sdk支持的版本是'7.4.2'、'6.5.3'、'5.5.0',其中创建'6.5.3'、'5.5.0'版本需要提工单进行开通)
36    createOrderRequestVo.setVersion("7.4.2");
37    // 设置创建集群时用的可用区 (见代码下方说明)
38    createOrderRequestVo.setAvailableZone({可用区名称});
39    // 设置创建集群时用的安全组 (见代码下方说明)
40    createOrderRequestVo.setSecurityGroupId({安全组ID});
41    // 设置创建集群时用的子网(见代码下方说明)
42    createOrderRequestVo.setSubnetUuid({子网ID});
43    // 设置创建集群时用的VPC(见代码下方说明)
44    createOrderRequestVo.setVpcId({VpcId});
45    // 是否是老套餐
46    createOrderRequestVo.setOldPackage(true);
47    BesCreateClusterResponse deploy = besClient.createCluster(createOrderRequestVo);
48}

创建集群(新套餐)

如下代码可以新建一个集群,集群包含1个es_node节点和1个kibana节点。

Java
1public void createCluster(BesClient client) {
2     // 构建集群的请求体
3    BesCreateClusterRequest createOrderRequestVo = new BesCreateClusterRequest();
4    // 创建节点类型模板
5    BesCreateClusterRequest.dataNodeModuleInfo moduleInfo = new BesCreateClusterRequest.ModuleInfo();
6    BesCreateClusterRequest.ModuleInfo KibanaNodeModuleInfo = new BesCreateClusterRequest.ModuleInfo();
7    List<BesCreateClusterRequest.ModuleInfo> moduleInfoList = new ArrayList<BesCreateClusterRequest.ModuleInfo>();
8    // 创建集群的付费方式
9    BesCreateClusterRequest.ClusterBilling clusterBilling = new BesCreateClusterRequest.ClusterBilling();
10    // 设置创建集群的名称
11    createOrderRequestVo.setName({clusterName});
12    // 设置创建集群的密码
13    createOrderRequestVo.setPassword({passwrod});
14    // 设置集群所配置的节点类型
15    dataNodeModuleInfo.setType(ModuleType.ES_NODE);
16    // 设置该节点类型的节点数量
17    dataNodeModuleInfo.setInstanceNum(1);
18    // 设置es节点的机型
19    dataNodeModuleInfo.setSlotType(SlotType.BES_C3_CPU_2_MEM_4);
20    // 磁盘信息(新版套餐磁盘需要单独指定大小)
21    DiskSlotInfo dataNodeDiskSlotInfo = new DiskSlotInfo();
22    // 磁盘大小 单位G 最小为50G premium_ssd最大为6144G ssd最大为20480G
23    dataNodeDiskSlotInfo.setSize(50);
24    // 磁盘类型 (现支持PREMIUM_SSD和SSD两种磁盘类型)
25    dataNodeDiskSlotInfo.setType(DiskType.PREMIUM_SSD);
26    // 设置磁盘信息
27    dataNodeModuleInfo.setDiskSlotInfo(dataNodeDiskSlotInfo);
28    // 设置集群所配置的节点类型
29    kibanaNodeModuleInfo.setType(ModuleType.KIBANA);
30    // 设置该节点类型的节点数量 (必须创建1个kibana节点)
31    kibanaNodeModuleInfo.setInstanceNum(1);
32    // 指定kibana节点的机型 新套餐中bes.c3.c1m2为免费节点 (新老节点配置见代码下方说明)
33    kibanaNodeModuleInfo.setSlotType(SlotType.KIBANA_C3_CPU_1_MEM_2);
34    
35    moduleInfoList.add(dataNodeModuleInfo);
36    moduleInfoList.add(kibanaNodeModuleInfo);
37    // 设置集群的付费方式为预付费 (后付费为POSTPAY)
38    clusterBilling.setPaymentType(PaymentType.PREPAY);
39    // 设置创建集群的时长 (后付费为0)
40    clusterBilling.setTime(1);
41    createOrderRequestVo.setModules(moduleInfoList);
42    createOrderRequestVo.setBilling(clusterBilling);
43    // 设置集群版本 (新套餐只支持7.4.2)
44    createOrderRequestVo.setVersion("7.4.2");
45    // 设置创建集群时用的可用区 (见代码下方说明)
46    createOrderRequestVo.setAvailableZone({可用区名称});
47    // 设置创建集群时用的安全组 (见代码下方说明)
48    createOrderRequestVo.setSecurityGroupId({安全组ID});
49    // 设置创建集群时用的子网(见代码下方说明)
50    createOrderRequestVo.setSubnetUuid({子网ID});
51    // 设置创建集群时用的VPC(见代码下方说明)
52    createOrderRequestVo.setVpcId({VpcId});
53    // 是否是老套餐
54    createOrderRequestVo.setOldPackage(false);
55    BesCreateClusterResponse deploy = besClient.createCluster(createOrderRequestVo);
56}

创建带有专用master节点的集群

如下代码可以新建一个集群,集群包含1个es_node节点和1个kibana节点和3个专用master节点。

Java
1public void createCluster(BesClient client) {
2    // 构建集群的请求体
3    BesCreateClusterRequest createOrderRequestVo = new BesCreateClusterRequest();
4    // 创建节点类型模板
5    BesCreateClusterRequest.dataNodeModuleInfo moduleInfo = new BesCreateClusterRequest.ModuleInfo();
6    BesCreateClusterRequest.ModuleInfo KibanaNodeModuleInfo = new BesCreateClusterRequest.ModuleInfo();
7    BesCreateClusterRequest.ModuleInfo masterNodeModuleInfo = new BesCreateClusterRequest.ModuleInfo();
8    List<BesCreateClusterRequest.ModuleInfo> moduleInfoList = new ArrayList<BesCreateClusterRequest.ModuleInfo>();
9    // 创建集群的付费方式
10    BesCreateClusterRequest.ClusterBilling clusterBilling = new BesCreateClusterRequest.ClusterBilling();
11    // 设置创建集群的名称
12    createOrderRequestVo.setName({clusterName});
13    // 设置创建集群的密码
14    createOrderRequestVo.setPassword({passwrod});
15    // 设置集群所配置的节点类型
16    dataNodeModuleInfo.setType(ModuleType.ES_NODE);
17    // 设置该节点类型的节点数量
18    dataNodeModuleInfo.setInstanceNum(1);
19    // 设置es节点的机型
20    dataNodeModuleInfo.setSlotType(SlotType.BES_C3_CPU_2_MEM_4);
21    // 磁盘信息(新版套餐磁盘需要单独指定大小)
22    DiskSlotInfo dataNodeDiskSlotInfo = new DiskSlotInfo();
23    // 磁盘大小 单位G 最小为50G premium_ssd最大为6144G ssd最大为20480G
24    dataNodeDiskSlotInfo.setSize(50);
25    // 磁盘类型 (现支持PREMIUM_SSD和SSD两种磁盘类型)
26    dataNodeDiskSlotInfo.setType(DiskType.PREMIUM_SSD);
27    // 设置磁盘信息
28    dataNodeModuleInfo.setDiskSlotInfo(dataNodeDiskSlotInfo);
29    // 设置集群所配置的节点类型
30    kibanaNodeModuleInfo.setType(ModuleType.KIBANA);
31    // 设置该节点类型的节点数量 (必须创建1个kibana节点)
32    kibanaNodeModuleInfo.setInstanceNum(1);
33    // 指定kibana节点的机型 新套餐中bes.c3.c1m2为免费节点 (新老节点配置见代码下方说明)
34    kibanaNodeModuleInfo.setSlotType(SlotType.KIBANA_C3_CPU_1_MEM_2);
35    
36    // 设置集群所配置的节点类型
37    masterNodeModuleInfo.setType(ModuleType.ES_DEDICATED_MASTER);
38    // 设置该节点类型的节点数量 (必须3或5节点)
39    masterNodeModuleInfo.setInstanceNum(3);
40    // 设置专用master节点的机型(专用master节点配置见代码下方说明)
41    masterNodeModuleInfo.setSlotType(SlotType.BES_G3_CPU_2_MEM_8);
42    // 磁盘信息
43     DiskSlotInfo masterNodeDiskSlotInfo = new DiskSlotInfo();
44     // 磁盘大小(master节点固定20g)
45    masterNodeDiskSlotInfo.setSize(20);
46    // 磁盘类型(master节点类型固定为PREMIUM_SSD)
47    masterNodeDiskSlotInfo.setType(DiskType.PREMIUM_SSD);
48    masterNodeDiskSlotInfo.setDiskSlotInfo(masterNodeDiskSlotInfo);
49    
50    moduleInfoList.add(dataNodeModuleInfo);
51    moduleInfoList.add(kibanaNodeModuleInfo);
52    moduleInfoList.add(masterNodeModuleInfo);
53    // 设置集群的付费方式为预付费 (后付费为POSTPAY)
54    clusterBilling.setPaymentType(PaymentType.PREPAY);
55    // 设置创建集群的时长 (后付费为0)
56    clusterBilling.setTime(1);
57    createOrderRequestVo.setModules(moduleInfoList);
58    createOrderRequestVo.setBilling(clusterBilling);
59    // 设置集群版本 (新套餐只支持7.4.2)
60    createOrderRequestVo.setVersion("7.4.2");
61    // 设置创建集群时用的可用区 (见代码下方说明)
62    createOrderRequestVo.setAvailableZone({可用区名称});
63    // 设置创建集群时用的安全组 (见代码下方说明)
64    createOrderRequestVo.setSecurityGroupId({安全组ID});
65    // 设置创建集群时用的子网(见代码下方说明)
66    createOrderRequestVo.setSubnetUuid({子网ID});
67    // 设置创建集群时用的VPC(见代码下方说明)
68    createOrderRequestVo.setVpcId({VpcId});
69    // 是否是老套餐(带有专有master的集群必须为新套餐)
70    createOrderRequestVo.setOldPackage(false);
71    BesCreateClusterResponse deploy = besClient.createCluster(createOrderRequestVo);
72}

请求参数说明

名称 类型 是否必须 参数描述
name String 是 集群名称
password String 是 操作ES所需的密码
modules List 是 节点信息
version String 是 集群版本
availableZone String 是 可用区
securityGroupId String 是 安全组ID
subnetUuid String 是 子网ID
vpcId String 是 虚拟网络ID
isOldPackage boolean 是 区分新老套餐 (true表示老套餐、false表示新套餐)
billing ClusterBilling 是 集群计费信息

Module

名称 类型 参数描述
type ModuleType 节点的类型
instanceNum Int 节点数量
slotType SlotType 机型
diskSlotInfo DiskSlotInfo 磁盘信息(新套餐必需,老套餐不需要)

DiskSlotInfo

名称 类型 参数描述
type DiskType 磁盘的类型
size int 单位G 最小为50G premium_ssd最大为6144G ssd最大为20480G

ClusterBilling

名称 类型 参数描述
paymentType PaymentType 计费方式
time int 购买时长(后付费为0),单位是月

PaymentType

名称 类型 参数描述
POSTPAY 枚举 后付费
PREPAY 枚举 预付费

ModuleType

名称 类型 参数描述
ES_NODE 枚举 代表es节点类型
KIBANA 枚举 代表kibana节点类型

DiskType

名称 类型 参数描述
SSD 枚举 高效云盘
PREMIUM_SSD 枚举 ssd云盘

SlotType

名称 对应机型
CALCULATE_V1 calculate_v1
CALCULATE_V2 calculate_v2
CALCULATE_V3 calculate_v3
STORAGE_V1 storage_v1
STORAGE_V2 storage_v2
STORAGE_V3 storage_v3
BES_G3_CPU_2_MEM_8 bes.g3.c2m8
BES_G3_CPU_4_MEM_16 bes.g3.c4m16
BES_G3_CPU_8_MEM_32 bes.g3.c8m32
BES_G3_CPU_16_MEM_64 bes.g3.c16m64
BES_G3_CPU_32_MEM_128 bes.g3.c32m128
BES_C3_CPU_2_MEM_4 bes.c3.c2m4
BES_C3_CPU_4_MEM_8 bes.c3.c4m8
BES_C3_CPU_8_MEM_16 bes.c3.c8m16
BES_C3_CPU_16_MEM_32 bes.c3.c16m32
BES_C3_CPU_32_MEM_64 bes.c3.c32m64
BES_IC3_CPU_4_MEM_4 bes.ic3.c4m4
BES_IC3_CPU_8_MEM_8 bes.ic3.c8m8
BES_IC3_CPU_12_MEM_12 bes.ic3.c12m12
BES_IC3_CPU_16_MEM_16 bes.ic3.c16m16
BES_M3_CPU_2_MEM_16 bes.m3.c2m16
BES_M3_CPU_4_MEM_32 bes.m3.c4m32
BES_M3_CPU_8_MEM_64 bes.m3.c8m64
KIBANA_G3_CPU_2_MEM_8 bes.g3.c2m8
KIBANA_G3_CPU_4_MEM_16 bes.g3.c4m16
KIBANA_G3_CPU_8_MEM_32 bes.g3.c8m32
KIBANA_C3_CPU_1_MEM_2 bes.c3.c1m2
KIBANA_C3_CPU_2_MEM_4 bes.c3.c2m4
KIBANA_C3_CPU_4_MEM_8 bes.c3.c4m8
KIBANA_C3_CPU_8_MEM_16 bes.c3.c8m16

更多节点配置类型类型请参考节点配置类型按需创建集群 获取vpc id方式(可用区域、安全组ID、子网ID参考vpc id方式)

1.获取VPC ID(vpcId):详见文档链接

2.获取可用区域(availableZone)、子网uuid(subnet_uuid):详见文档链接

3.获取安全组ID(securityGroupId):详见文档链接

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
result OrderUuidResult 订单创建成功响应订单Id

OrderUuidResult

名称 类型 参数描述
orderId String 订单ID
  1. 创建BES请求是一个异步请求,返回200和订单ID表明订单生成,后续可以通过查询集群列表查看集群创建进度。 支持对BES集群升配操作,具体可参考以下代码。

集群升配

说明: 只有新套餐支持升配操作;ES节点、Kibana节点不能同时升配;节点配置类型和磁盘大小不能同时升配; 同一个集群一次升配操作完成后,才能进行下一次升配操作。

Plain Text
1 BesResizeClusterRequest besResizeClusterRequest = new BesResizeClusterRequest();
2        BesResizeClusterRequest.ModuleDesc moduleDesc = new BesResizeClusterRequest.ModuleDesc();
3        BesResizeClusterRequest.ModuleDesc moduleDesc2 = new BesResizeClusterRequest.ModuleDesc();
4        DiskSlotInfo diskSlotInfo = new DiskSlotInfo();
5        List<BesResizeClusterRequest.ModuleDesc> modules = new ArrayList<BesResizeClusterRequest.ModuleDesc>();
6        // 设置集群所在区域
7        besResizeClusterRequest.setRegion("bj");
8        // 设置需要扩容集群名称
9        besResizeClusterRequest.setName("isTest0309");
10        // 设置支付方式
11        besResizeClusterRequest.setPaymentType(PaymentType.POSTPAY);
12        // 设置需要升配的集群ID
13        besResizeClusterRequest.setClusterId(clusterId);
14        
15        // 设置节点类型
16        moduleDesc.setType(ModuleType.ES_NODE);
17        // 设置机型(如果是升配机型,数量和磁盘大小需要和升配前保持一致)
18        moduleDesc.setSlotType(SlotType.BES_G3_CPU_8_MEM_32);
19        // 节点数量
20        moduleDesc.setDesireInstanceNum(2);
21        // 磁盘类型
22        diskSlotInfo.setType(DiskType.PREMIUM_SSD);
23        // 磁盘大小(如果是升配磁盘,数量和机型需要和升配前保持一致)
24        diskSlotInfo.setSize(60);
25        moduleDesc.setDiskSlotInfo(diskSlotInfo);
26
27        // 设置节点类型
28        moduleDesc2.setType(ModuleType.KIBANA);
29        // 设置机型(如果是升配机型,数量和磁盘大小需要和升配前保持一致)
30        moduleDesc2.setSlotType(SlotType.BES_C3_CPU_2_MEM_4);
31        // 节点数量
32        moduleDesc2.setDesireInstanceNum(1);
33
34        modules.add(moduleDesc);
35        modules.add(moduleDesc2);
36        besResizeClusterRequest.setModules(modules);
37        BesCreateClusterResponse besCreateClusterResponse = this.besClient.resizeCluster(besResizeClusterRequest);

扩容集群

支持对BES集群扩容操作,具体可参考以下代码。

Java
1public void resizeCluster(BesClient client) {
2    BesResizeClusterRequest besResizeClusterRequest = new BesResizeClusterRequest();
3    BesResizeClusterRequest.ModuleDesc moduleDesc = new BesResizeClusterRequest.ModuleDesc();
4    List<BesResizeClusterRequest.ModuleDesc> modules = new ArrayList<BesResizeClusterRequest.ModuleDesc>();
5    // 设置集群所在区域
6    besResizeClusterRequest.setRegion("bj");
7    // 设置需要扩容集群名称
8    besResizeClusterRequest.setName("clusterName");
9    // 设置付费方式
10    besResizeClusterRequest.setPaymentType(PaymentType.PREPAY);
11    // 设置需要扩容集群ID
12    besResizeClusterRequest.setDeployId("clusterId");
13    // 设置需要扩容集群版本(需和创建时的集群版本一致)
14    moduleDesc.setVersion("7.4.2");
15    // 设置需要扩容的节点类型
16    moduleDesc.setType(ModuleType.ES_NODE);
17    // 设置需要扩容的节点配置类型 (需和创建时的类型一致)
18    moduleDesc.setSlotType(SlotType.BES_C3_CPU_8_MEM_16);
19    // 设置需要扩容后的节点数量 (数量不可少于当前es_node节点数量)
20    moduleDesc.setDesireInstanceNum(2);
21    modules.add(moduleDesc);
22    besResizeClusterRequest.setModules(modules);
23    BesCreateClusterResponse besCreateClusterResponse = this.besClient.resizeCluster(besResizeClusterRequest);
24}

请求参数说明

名称 类型 是否必须 参数描述
name String 是 集群名称
paymentType PaymentType 是 计费方式;postpay表示后付费、prepay表示预付费
clusterId String 是 集群ID
region String 是 地域
modules List 是 节点扩容信息

Module

名称 类型 是否必须 参数描述
desireInstanceNum int 是 节点数量
slotType SlotType 是 资源配置类型
type ModuleType 是 节点的类型
version String 是 集群版本

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
result OrderUuidResult 订单创建成功响应订单Id

OrderUuidResult

名称 类型 参数描述
orderId String 订单ID

PaymentType

名称 类型 参数描述
POSTPAY 枚举 后付费
PREPAY 枚举 预付费

ModuleType

名称 类型 参数描述
ES_NODE 枚举 代表es节点类型
KIBANA 枚举 代表kibana节点类型

更多节点配置类型类型请参考节点配置类型按需创建集群

查询集群列表

如下代码可以罗列出属于请求调用者的所有集群。

Java
1public void listClusters(BesClient client) {
2	BesListClusterRequest besListClusterRequest = new BesListClusterRequest();
3    // 当前页数(最小1)
4    besListClusterRequest.setPageNo(1);
5    // 设置每页展示几个集群信息(最小20)
6    besListClusterRequest.setPageSize(20);
7    BesListClusterResponse besListClusterResponse = besClient.clusterList(besListClusterRequest);
8}

请求参数说明

名称 类型 是否必须 参数描述
pageNo int 是 页数
pageSize int 是 页大小

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
page ListPageResponse 集群信息列表

ListPageResponse

名称 类型 参数描述
pageNo int 页数
pageSize int 页大小
totalCount int 集群个数
result List 集群信息

ClusterSummaryInfo

名称 类型 参数描述
clusterId String 集群Id
clusterName String 集群名称
createTime String 创建时间
actualStatus String 实际状态
runningTime String 运行时长
billing BesClusterBillingResponse 集群计费信息

actual_status取值说明:

取值 说明
Initializing 正在创建
Deleting 删除中
Stopping 正在停止
Running 运行中
Starting 正在启动
Stopped 已停止
Deleted 删除中
Unknown 异常状态

BesClusterBillingResponse

名称 类型 参数描述
paymentType String 支付方式

查询集群详情

使用以下代码可以查询指定BES集群的详细信息。

Java
1public void getClusterDetail(BesClient client) {
2    BesClusterDetailRequest besClusterDetailRequest = new BesClusterDetailRequest();
3    // 设置需要查询的集群ID
4    besClusterDetailRequest.setClusterId(clusterId);
5    BesClusterDetailResponse besClusterDetailResponse = besClient.clusterDetail(besClusterDetailRequest);
6}

请求参数说明

名称 类型 是否必须 参数描述
clusterId String 是 集群Id

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
result ClusterDetail 集群详细信息

ClusterDetail

名称 类型 参数描述
clusterId String 集群Id
clusterName String 集群名称
adminUsername String 管理员名称
desireStatus String 设备状态
status String 实际状态
esUrl String ES服务器访问路径
kibanaUrl String Kibana服务器访问路径
esEip String ES公网访问IP
kibanaEip String Kibana公网访问IP
modules List 节点信息列表
instances List 节点实例列表
expireTime String 终止时间
region String 所属地区
vpc String 虚拟网卡
subnet String 子网
availableZone String 可用区
securityGroup String 安全组
billing BesClusterBillingResponse 集群计费信息

ClusterDetail.status 取值同 ClusterSummaryInfo.actual_status;

ModuleInfoResponse

名称 类型 参数描述
type String type表示节点的类型;es_node表示es节点、kibana表示kibana节点
version String 集群版本
slotType String 资源配置类型
slotDescription String 资源配置类型描述
actualInstance_num int 实例数量

InstanceInfoResponse

名称 类型 参数描述
instanceId String 节点实例Id
status String 节点实例状态
moduleType String 表示节点的类型;es_node表示es节点、kibana表示kibana节点
moduleVersion String 节点实例所属集群版本
hostIp String 主机Ip

InstanceInfoResponse.status 取值同 ClusterSummaryInfo.actual_status;

停止集群

使用以下代码可以停止集群。

Java
1public void stopCluster(BesClient client) {
2    BesStopClusterRequest besStopClusterRequest = new BesStopClusterRequest();
3    // 设置需要停止的集群ID
4    besStopClusterRequest.setClusterId(clusterId);
5    besClient.stopCluster(besStopClusterRequest);
6}

请求参数说明

名称 类型 是否必须 参数描述
clusterId String 是 集群Id

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
result String 常量字符串(没有返回值时为空)

启动集群

使用以下代码可以启动集群。

Java
1public void startCluster(BesClient client) {
2	BesStartClusterRequest besStartClusterRequest = new BesStartClusterRequest();
3    // 设置需要启动的集群ID
4    besStartClusterRequest.setClusterId(clusterId);
5    besClient.startCluster(besStartClusterRequest);
6}

请求参数说明

名称 类型 是否必须 参数描述
clusterId String 是 集群Id

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
result String 常量字符串(没有返回值时为空)

删除集群

使用以下代码可以删除一个ES集群。

Java
1public void deleteCluster(BesClient client) {
2    BesDeleteClusterRequest besDeleteClusterRequest = new BesDeleteClusterRequest();
3    // 设置需要删除的集群ID
4    besDeleteClusterRequest.setClusterId(clusterId);
5    besClient.deleteCluster(besDeleteClusterRequest);
6}

请求参数说明

名称 类型 是否必须 参数描述
clusterId String 是 集群Id

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
result String 常量字符串(没有返回值时为空)

续费列表

使用以下代码查询续费列表。

Java
1public void getRenewList(BesClient client) {
2   BesGetRenewListRequest listAutoRenew = new BesGetRenewListRequest();
3        # 排序规则:desc降序、asc升序
4        listAutoRenew.setOrder("desc");
5        # 排序字段
6        listAutoRenew.setOrderBy("expireTime");
7        # 页数 
8        listAutoRenew.setPageNo(1);
9        # 页大小
10        listAutoRenew.setPageSize(15);
11        # 多少天内过期(与当前时间比较)
12        listAutoRenew.setDaysToExpiration(15);
13        besClient.getRenewList(listAutoRenew);
14}

请求参数说明

名称 类型 是否必须 参数描述
order String 是 排序规则
orderBy String 是 排序字段
pageNo int 是 页数
pageSize int 是 页大小
daysToExpiration int 是 与当前时间比较,还有多少天过期,-1为不限制

返回结果说明

名称 类型 参数描述
success bool 操作是否成功
status int 状态码
page BesRenewListResponse 集群列表

BesRenewListResponse

名称 类型 参数描述
clusterId String 集群ID
clusterName String 集群名称
region String 区域
expiredTime String 到期时间
clusterStatus String 集群状态

BesRenewListResponse.cluster_status 取值同 ClusterSummaryInfo.actual_status;

续费操作

使用以下代码进行续费操作。

Java
1public void renewCluster(BesClient client) {
2   BesGetRenewListRequest listAutoRenew = new BesGetRenewListRequest();
3        BesRenewClusterRequest besRenewClusterRequest = new BesRenewClusterRequest();
4        # 集群ID
5        besRenewClusterRequest.setClusterId(clusterId);
6         # 续费时长,单位:月
7        besRenewClusterRequest.setTime(1);
8
9        besClient.renewCluster(besRenewClusterRequest);
10}

请求参数说明

名称 类型 是否必须 参数描述
clusterId String 是 集群ID
time int 是 续费时长,单位:月

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
result OrderUuidResult 订单创建成功响应订单Id

OrderUuidResult

名称 类型 参数描述
orderId String 订单ID

创建自动续费规则

使用以下代码创建自动续费规则,支持批量创建。

Java
1public void createAutoRenewRule(BesClient client) {
2   BesCreateAutoRenewRuleRequest createAutoRenewRuleRequest = new BesCreateAutoRenewRuleRequest();
3        List<String> clusterIds = new ArrayList<String>();
4        clusterIds.add(clusterId);
5        // 集群ID
6        createAutoRenewRuleRequest.setClusterIds(clusterIds);
7        // 用户ID
8        createAutoRenewRuleRequest.setUserId("XXX");
9        // 续费时长
10        createAutoRenewRuleRequest.setRenewTime(1);
11        // 续费时间单位 支持month,yea
12        createAutoRenewRuleRequest.setRenewTimeUnit("month");
13        besClient.createAutoRenewRule(createAutoRenewRuleRequest);
14}

请求参数说明

名称 类型 是否必须 参数描述
clusterIds List 是 集群ID集合
userId String 是 用户ID
renewTimeUnit String 是 续费时间单位 支持month,year
renewTime int 是 续费时长

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
result String 常量字符串(没有返回值时为空)

查看自动续费规则列表

使用以下代码查询自动续费规则列表。

Java
1public void getutoRenewRuleList(BesClient client) {
2   besClient.getAutoRenewRuleList();
3}

请求参数说明

使用创建client的Ak、SK对应的账户进行查询,不需要显示传递参数

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
result List 续费信息列表

BesAotuRenewListResponse

名称 类型 参数描述
uuid String 续费规则的ID
userId String 用户ID
clusterId String 集群信息
region String 区域
renewTimeUnit String 续费时间单位 支持month,year
renewTime int 续费时长
createTime String 创建时间
updateTime String 修改时间

更新自动续费规则

使用以下代码更新自动续费规则。

Java
1public void updateAutoRenewRule(BesClient client) {
2   BesUpdateAutoRenewRuleRequest updateAutoRenewRuleRequest = new BesUpdateAutoRenewRuleRequest();
3        // 集群ID
4        updateAutoRenewRuleRequest.setClusterId(clusterId);
5        // 续费时长
6        updateAutoRenewRuleRequest.setRenewTime(2);
7        // 续费时间单位 支持month,year
8        updateAutoRenewRuleRequest.setRenewTimeUnit("month");
9        besClient.updateAutoRenewRule(updateAutoRenewRuleRequest);
10}

请求参数说明

名称 类型 是否必须 参数描述
clusterId String 是 集群ID
renewTimeUnit String 是 续费时间单位 支持month,year
renewTime int 是 续费时长

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
result String 常量字符串(没有返回值时为空

删除自动续费规则

使用以下代码删除自动续费规则。

Java
1public void deleteAutoRenewRule(BesClient client) {
2    // 集群ID
3    deleteAutoRenewRuleRequest.setClusterId(clusterId);
4    besClient.deleteAutoRenewRule(deleteAutoRenewRuleRequest);
5}

请求参数说明

名称 类型 是否必须 参数描述
clusterId String 是 集群ID

返回结果说明

名称 类型 参数描述
success boolean 操作是否成功
status int 状态码
result String 常量字符串(没有返回值时为空

上一篇
快速入门
下一篇
BesClient