InstanceGroup相关接口

容器引擎 CCE

  • 功能发布记录
  • 产品描述
    • 介绍
    • 优势
    • 使用限制
    • 应用场景
    • 核心概念
    • 特性
  • 开发指南
    • EFK日志采集系统部署指南
    • 创建LoadBalancer类型的Service
    • Prometheus监控系统部署指南
    • kubectl管理配置
    • 在CCE集群中使用-Network-Policy
  • 常用工具
    • 视图命令行场景示例
  • 产品公告
    • CCE 新版集群管理发布公告
    • CCE 控制台升级公告
    • Kubernetes 版本发布说明
      • CCE发布Kubernetes 1.18版本说明
      • CCE发布Kubernetes 1.30版本说明
      • CCE Kubernetes 版本更新说明
      • CCE发布Kubernetes 1.22版本说明
      • CCE发布Kubernetes 1.20版本说明
      • CCE发布Kubernetes 1.28版本说明
      • CCE发布Kubernetes 1.24版本说明
      • CCE发布Kubernetes 1.26版本说明
    • 安全漏洞修复公告
      • 漏洞CVE-2020-14386修复公告
      • 修复漏洞CVE-2021-30465公告
      • 漏洞CVE-2019-5736修复公告
      • 漏洞CVE-2025-1097、CVE-2025-1098等修复公告
      • 关于 runc 的安全问题(CVE-2024-21626)影响声明
  • 快速入门
    • 快速部署nginx应用
    • 使用CCE容器引擎流程概述
  • 典型实践
    • CCE集群网络说明及规划
    • CCE典型实践之容器网络模式选择
    • Pod异常问题排查
    • 通过 CCE Ingress 实现虚机和容器服务的统一接入
    • CCE集群使用Jenkins持续发布
    • CCE-访问公网实践
    • Linux系统配置常用参数说明
    • 用户使用自定义 CNI 插件方法
    • CCE典型实践之Guestbook搭建
    • 使用KMS对etcd数据加密
    • 添加CGroup V2节点
    • CCE容器运行时选择
    • CCE使用检查清单
    • VPC-ENI模式集群访问公网实践
    • 利用 Velero 实现将应用跨云迁移到 百度CCE
    • 使用 CNI 配置容器内网络参数
    • CCE Resource Recommender 用户文档
    • CCE集群中使用私有镜像实践
    • 云原生AI
      • 使用 CCE AITraining Operator 实现弹性容错训练
      • 部署 TensorFlow Serving 推理服务
      • GPU虚拟化之隔离性最优型的最佳实践
  • 操作指南
    • 多用户访问控制
    • 使用须知
    • 命名空间管理
      • 设置资源配额
      • 设置资源限制
      • 命名空间基本操作
    • 弹性伸缩
      • 使用 cce-autoscaling-placeholder 实现秒级弹性伸缩
      • CCE 集群节点自动伸缩
      • 容器定时水平伸缩(CronHPA)
      • 容器水平伸缩(HPA)
    • 存储管理
      • 使用云盘CDS
      • 使用并行文件存储PFS
      • 使用对象存储BOS
      • 使用并行文件存储PFS L2
      • 使用本地存储
      • 使用数据湖存储加速工具RapidFS
      • 使用文件存储CFS
      • 概述
    • 节点管理
      • 移出节点
      • kubelet容器监控只读端口风险提示
      • 管理污点
      • 设置GPU显存共享
      • 添加节点
      • 自定义Kubelet参数
      • 设置节点封锁
      • 节点排水
      • 管理节点标签
    • 组件管理
      • CCE CSI BOS Plugin 说明
      • Kube Scheduler 说明文档
      • CCE CSI PFS L2 Plugin
      • CCE NodeLocal DNSCache 说明
      • CCE Ingress NGINX Controller 说明
      • CCE RDMA Device Plugin 说明
      • CCE Node Problem Detector 说明
      • CCE Credential Controller 说明
      • Kube Controller Manager 说明
      • CCE Ingress Controller 说明
      • CCE GPU Manager 说明
      • CCE Backup Controller 说明
      • CCE QoS Agent 说明
      • CCE Descheduler 说明
      • 组件概述
      • CCE Image Accelerate 说明
      • CCE Network Plugin说明
      • Kube ApiServer 说明
      • CCE Log Operator 说明
      • CoreDNS 说明
      • CCE NPU Manager 说明
      • CCE AI Job Scheduler 说明
      • CCE LB Controller 说明
      • CCE P2P Accelerator 说明
      • CCE_Hybrid_Manager说明
      • CCE CSI PFS Plugin 说明
      • CCE Deep Learning Frameworks Operator 说明
      • CCE Node Remedier 说明
      • CCE CSI CDS Plugin 说明
      • CCE Ascend Mindx DL说明
      • CCE Calico Felix 说明
      • CCE Virtual Kubelet组件
      • CCE Fluid说明
      • CCE Onepilot 说明
      • CCE CronHPA Controller 说明
      • CCE 动态调度插件说明
    • 云原生AI
      • 云原生AI概述
      • GPU虚拟化
        • MPS 最佳实践&注意事项
        • GPU独占和共享说明
        • GPU在离线混部使用说明
        • GPU虚拟化适配表
        • 单GPU容器共享多卡使用说明
        • 共享GPU场景下的镜像构建注意事项
        • 关闭节点显存共享功能注意事项
      • 队列管理
        • 逻辑队列和物理队列使用说明
        • 修改队列
        • 删除队列
        • 新建队列
      • 任务管理
        • 基于 NCCL的RDMA分布式训练示例
        • 新建AITraining任务
        • 新建PaddlePaddle任务
        • 删除任务
        • 查看任务信息
        • 新建Mxnet任务
        • 新建TensorFlow任务
        • 新建Pytorch任务
      • 数据集管理
        • 删除数据集
        • 操作数据集
        • 查看数据集
        • 新建数据集
      • AI监控大盘
        • 接入监控实例并开启采集任务
        • NVIDIA芯片资源观测
          • AI Job Scheduler组件
          • GPUManager组件
          • GPU资源池总览
          • GPU节点资源
          • GPU工作负载资源
        • 昇腾芯片资源观测
          • 昇腾节点资源
          • 昇腾资源池总览
          • 昇腾工作负载资源
      • AI 加速套件
        • 使用AIAK-Inference 加速推理业务
        • 使用AIAK-Training Pytorch版
        • AIAK 简介
        • 使用 AIAK-Training 部署分布式训练任务
    • Helm管理
      • Helm模板
      • Helm实例
    • 应用管理
      • 部署
      • 保密字典
      • 服务
      • 配置字典
      • 容器组
      • 概述
    • 镜像仓库
      • 使用容器镜像构建服务
      • 镜像仓库基本操作
    • Serverless集群
      • 在Serverless集群中使用Service
      • 产品概述
      • 创建Serverless集群
    • 工作负载
      • 设置工作负载自动水平伸缩
      • Statefulset管理
      • 使用私有镜像创建工作负载
      • Job管理
      • 查看容器组
      • CronJob管理
      • Daemonset管理
      • 免密拉取容器镜像
      • Deployment管理
    • 节点组管理
      • 节点组管理
      • 节点组介绍
      • 升级节点组
      • 添加外部已有节点
      • 自定义节点组 Kubelet 配置
      • 添加备选机型
      • 节点组节点故障检测自愈
      • 配置扩缩容策略
    • 监控日志
      • 使用Prometheus监控集群
      • CCE 事件中心
      • 集群审计仪表盘
      • CCE 集群异常事件报警
      • Java应用监控
      • 集群服务画像
      • 日志管理
      • 集群审计
      • 日志中心
        • 在容器引擎控制台配置采集规则
        • 查看集群控制面日志
        • 日志概述
        • 查看业务日志
        • 使用CRD配置采集规则
    • 网络管理
      • CCE 集群内容器访问集群外服务
      • 容器网段空间耗尽如何继续扩容(VPC-ENI模式)
      • 容器网段空间耗尽如何继续扩容(VPC网络模式)
      • CCE IP Masquerade Agent 用户指南
      • 创建VPC-ENI模式集群
      • 对等连接场景下容器流量转发配置
      • 使用Network Policy网络策略
      • CCE 支持 IPv4 和 IPv6 双栈网络
      • 在CCE集群中使用NetworkPolicy
      • 网络编排
        • 集群 Pod 子网拓扑分布(容器网络 v2)
        • 容器网络 QoS 管理
        • VPC-ENI指定子网分配IP(容器网络 v2)
      • 网络连通性
        • 容器网络通过 NAT 网关访问公网
      • 网络维护
        • CCE容器网络常见错误码对应表
      • DNS
        • DNS 原理概述
        • DNS 问题排查指南
        • CoreDNS 组件手动升级指南
    • 虚拟节点
      • 管理虚拟节点
      • 配置BCIPod
      • 配置bci-profile
    • 备份中心
      • 备份概述
      • 恢复管理
      • 备份仓库
      • 备份管理
    • 巡检与诊断
      • GPU运行环境检查
      • 集群巡检
      • 故障诊断
    • 流量接入
      • NGINX Ingress 使用配置参考
      • CCE基于nginx-ingress实现灰度发布
      • BLB Ingress Annotation说明
      • 通过CCE使用K8S_Ingress
      • 通过YAML创建LoadBalancer_Service
      • 通过CCE使用K8S_Service
      • LoadBalancer Service Annotation说明
      • 使用直连 Pod 模式 LoadBalancer Service
      • Service复用已有负载均衡BLB
      • 通过YAML创建CCE_Ingress
      • 使用 NGINX Ingress
    • 权限管理
      • 配置集群OIDC认证
      • 配置IAM标签权限策略
      • 配置IAM自定义权限策略
      • 配置IAM预置权限策略
      • 权限概述
      • 配置预置RBAC权限策略
    • 配置管理
      • Secret管理
      • Configmap管理
    • 集群管理
      • 集群快照
      • CCE 安全组
      • 查看集群
      • 创建集群
      • 操作集群
      • 升级集群Kubernetes版本
      • 通过kubectl连接集群
      • 托管集群使用说明
      • CCE 支持 GPUSharing 集群
      • CCE节点资源预留说明
      • CCE 节点 CDS 扩容
  • 服务等级协议SLA
    • CCE服务等级协议SLA(V1.0)
  • Solution-Fabric
    • Fabric解决方案
  • API参考
    • 通用说明
    • 公共头和错误返回
    • 概述
  • 常见问题
    • windows下使用kubectl
    • 自动扩缩容常见问题
    • 通过kubectl创建简单的服务
    • 业务应用如何使用负载均衡?
    • 常见问题总览
    • 集群管理常见问题
  • API_V2参考
    • 通用说明
    • Instance相关接口
    • 附录
    • Autoscaler相关接口
    • 组件管理相关接口
    • 套餐适配相关接口
    • Task相关接口
    • 公共头和错误返回
    • Network相关接口
    • 服务域名
    • Cluster相关接口
    • Kubeconfig相关接口
    • InstanceGroup相关接口
    • RBAC相关接口
    • 概述
  • 产品定价
    • 产品定价
  • Solution-Xchain
    • 超级链解决方案
  • SDK
    • Go-SDK
      • 节点组管理
      • 节点管理
      • 集群管理
      • 初始化
      • 安装SDK工具包
      • 概述
所有文档
menu
没有找到结果,请重新输入

容器引擎 CCE

  • 功能发布记录
  • 产品描述
    • 介绍
    • 优势
    • 使用限制
    • 应用场景
    • 核心概念
    • 特性
  • 开发指南
    • EFK日志采集系统部署指南
    • 创建LoadBalancer类型的Service
    • Prometheus监控系统部署指南
    • kubectl管理配置
    • 在CCE集群中使用-Network-Policy
  • 常用工具
    • 视图命令行场景示例
  • 产品公告
    • CCE 新版集群管理发布公告
    • CCE 控制台升级公告
    • Kubernetes 版本发布说明
      • CCE发布Kubernetes 1.18版本说明
      • CCE发布Kubernetes 1.30版本说明
      • CCE Kubernetes 版本更新说明
      • CCE发布Kubernetes 1.22版本说明
      • CCE发布Kubernetes 1.20版本说明
      • CCE发布Kubernetes 1.28版本说明
      • CCE发布Kubernetes 1.24版本说明
      • CCE发布Kubernetes 1.26版本说明
    • 安全漏洞修复公告
      • 漏洞CVE-2020-14386修复公告
      • 修复漏洞CVE-2021-30465公告
      • 漏洞CVE-2019-5736修复公告
      • 漏洞CVE-2025-1097、CVE-2025-1098等修复公告
      • 关于 runc 的安全问题(CVE-2024-21626)影响声明
  • 快速入门
    • 快速部署nginx应用
    • 使用CCE容器引擎流程概述
  • 典型实践
    • CCE集群网络说明及规划
    • CCE典型实践之容器网络模式选择
    • Pod异常问题排查
    • 通过 CCE Ingress 实现虚机和容器服务的统一接入
    • CCE集群使用Jenkins持续发布
    • CCE-访问公网实践
    • Linux系统配置常用参数说明
    • 用户使用自定义 CNI 插件方法
    • CCE典型实践之Guestbook搭建
    • 使用KMS对etcd数据加密
    • 添加CGroup V2节点
    • CCE容器运行时选择
    • CCE使用检查清单
    • VPC-ENI模式集群访问公网实践
    • 利用 Velero 实现将应用跨云迁移到 百度CCE
    • 使用 CNI 配置容器内网络参数
    • CCE Resource Recommender 用户文档
    • CCE集群中使用私有镜像实践
    • 云原生AI
      • 使用 CCE AITraining Operator 实现弹性容错训练
      • 部署 TensorFlow Serving 推理服务
      • GPU虚拟化之隔离性最优型的最佳实践
  • 操作指南
    • 多用户访问控制
    • 使用须知
    • 命名空间管理
      • 设置资源配额
      • 设置资源限制
      • 命名空间基本操作
    • 弹性伸缩
      • 使用 cce-autoscaling-placeholder 实现秒级弹性伸缩
      • CCE 集群节点自动伸缩
      • 容器定时水平伸缩(CronHPA)
      • 容器水平伸缩(HPA)
    • 存储管理
      • 使用云盘CDS
      • 使用并行文件存储PFS
      • 使用对象存储BOS
      • 使用并行文件存储PFS L2
      • 使用本地存储
      • 使用数据湖存储加速工具RapidFS
      • 使用文件存储CFS
      • 概述
    • 节点管理
      • 移出节点
      • kubelet容器监控只读端口风险提示
      • 管理污点
      • 设置GPU显存共享
      • 添加节点
      • 自定义Kubelet参数
      • 设置节点封锁
      • 节点排水
      • 管理节点标签
    • 组件管理
      • CCE CSI BOS Plugin 说明
      • Kube Scheduler 说明文档
      • CCE CSI PFS L2 Plugin
      • CCE NodeLocal DNSCache 说明
      • CCE Ingress NGINX Controller 说明
      • CCE RDMA Device Plugin 说明
      • CCE Node Problem Detector 说明
      • CCE Credential Controller 说明
      • Kube Controller Manager 说明
      • CCE Ingress Controller 说明
      • CCE GPU Manager 说明
      • CCE Backup Controller 说明
      • CCE QoS Agent 说明
      • CCE Descheduler 说明
      • 组件概述
      • CCE Image Accelerate 说明
      • CCE Network Plugin说明
      • Kube ApiServer 说明
      • CCE Log Operator 说明
      • CoreDNS 说明
      • CCE NPU Manager 说明
      • CCE AI Job Scheduler 说明
      • CCE LB Controller 说明
      • CCE P2P Accelerator 说明
      • CCE_Hybrid_Manager说明
      • CCE CSI PFS Plugin 说明
      • CCE Deep Learning Frameworks Operator 说明
      • CCE Node Remedier 说明
      • CCE CSI CDS Plugin 说明
      • CCE Ascend Mindx DL说明
      • CCE Calico Felix 说明
      • CCE Virtual Kubelet组件
      • CCE Fluid说明
      • CCE Onepilot 说明
      • CCE CronHPA Controller 说明
      • CCE 动态调度插件说明
    • 云原生AI
      • 云原生AI概述
      • GPU虚拟化
        • MPS 最佳实践&注意事项
        • GPU独占和共享说明
        • GPU在离线混部使用说明
        • GPU虚拟化适配表
        • 单GPU容器共享多卡使用说明
        • 共享GPU场景下的镜像构建注意事项
        • 关闭节点显存共享功能注意事项
      • 队列管理
        • 逻辑队列和物理队列使用说明
        • 修改队列
        • 删除队列
        • 新建队列
      • 任务管理
        • 基于 NCCL的RDMA分布式训练示例
        • 新建AITraining任务
        • 新建PaddlePaddle任务
        • 删除任务
        • 查看任务信息
        • 新建Mxnet任务
        • 新建TensorFlow任务
        • 新建Pytorch任务
      • 数据集管理
        • 删除数据集
        • 操作数据集
        • 查看数据集
        • 新建数据集
      • AI监控大盘
        • 接入监控实例并开启采集任务
        • NVIDIA芯片资源观测
          • AI Job Scheduler组件
          • GPUManager组件
          • GPU资源池总览
          • GPU节点资源
          • GPU工作负载资源
        • 昇腾芯片资源观测
          • 昇腾节点资源
          • 昇腾资源池总览
          • 昇腾工作负载资源
      • AI 加速套件
        • 使用AIAK-Inference 加速推理业务
        • 使用AIAK-Training Pytorch版
        • AIAK 简介
        • 使用 AIAK-Training 部署分布式训练任务
    • Helm管理
      • Helm模板
      • Helm实例
    • 应用管理
      • 部署
      • 保密字典
      • 服务
      • 配置字典
      • 容器组
      • 概述
    • 镜像仓库
      • 使用容器镜像构建服务
      • 镜像仓库基本操作
    • Serverless集群
      • 在Serverless集群中使用Service
      • 产品概述
      • 创建Serverless集群
    • 工作负载
      • 设置工作负载自动水平伸缩
      • Statefulset管理
      • 使用私有镜像创建工作负载
      • Job管理
      • 查看容器组
      • CronJob管理
      • Daemonset管理
      • 免密拉取容器镜像
      • Deployment管理
    • 节点组管理
      • 节点组管理
      • 节点组介绍
      • 升级节点组
      • 添加外部已有节点
      • 自定义节点组 Kubelet 配置
      • 添加备选机型
      • 节点组节点故障检测自愈
      • 配置扩缩容策略
    • 监控日志
      • 使用Prometheus监控集群
      • CCE 事件中心
      • 集群审计仪表盘
      • CCE 集群异常事件报警
      • Java应用监控
      • 集群服务画像
      • 日志管理
      • 集群审计
      • 日志中心
        • 在容器引擎控制台配置采集规则
        • 查看集群控制面日志
        • 日志概述
        • 查看业务日志
        • 使用CRD配置采集规则
    • 网络管理
      • CCE 集群内容器访问集群外服务
      • 容器网段空间耗尽如何继续扩容(VPC-ENI模式)
      • 容器网段空间耗尽如何继续扩容(VPC网络模式)
      • CCE IP Masquerade Agent 用户指南
      • 创建VPC-ENI模式集群
      • 对等连接场景下容器流量转发配置
      • 使用Network Policy网络策略
      • CCE 支持 IPv4 和 IPv6 双栈网络
      • 在CCE集群中使用NetworkPolicy
      • 网络编排
        • 集群 Pod 子网拓扑分布(容器网络 v2)
        • 容器网络 QoS 管理
        • VPC-ENI指定子网分配IP(容器网络 v2)
      • 网络连通性
        • 容器网络通过 NAT 网关访问公网
      • 网络维护
        • CCE容器网络常见错误码对应表
      • DNS
        • DNS 原理概述
        • DNS 问题排查指南
        • CoreDNS 组件手动升级指南
    • 虚拟节点
      • 管理虚拟节点
      • 配置BCIPod
      • 配置bci-profile
    • 备份中心
      • 备份概述
      • 恢复管理
      • 备份仓库
      • 备份管理
    • 巡检与诊断
      • GPU运行环境检查
      • 集群巡检
      • 故障诊断
    • 流量接入
      • NGINX Ingress 使用配置参考
      • CCE基于nginx-ingress实现灰度发布
      • BLB Ingress Annotation说明
      • 通过CCE使用K8S_Ingress
      • 通过YAML创建LoadBalancer_Service
      • 通过CCE使用K8S_Service
      • LoadBalancer Service Annotation说明
      • 使用直连 Pod 模式 LoadBalancer Service
      • Service复用已有负载均衡BLB
      • 通过YAML创建CCE_Ingress
      • 使用 NGINX Ingress
    • 权限管理
      • 配置集群OIDC认证
      • 配置IAM标签权限策略
      • 配置IAM自定义权限策略
      • 配置IAM预置权限策略
      • 权限概述
      • 配置预置RBAC权限策略
    • 配置管理
      • Secret管理
      • Configmap管理
    • 集群管理
      • 集群快照
      • CCE 安全组
      • 查看集群
      • 创建集群
      • 操作集群
      • 升级集群Kubernetes版本
      • 通过kubectl连接集群
      • 托管集群使用说明
      • CCE 支持 GPUSharing 集群
      • CCE节点资源预留说明
      • CCE 节点 CDS 扩容
  • 服务等级协议SLA
    • CCE服务等级协议SLA(V1.0)
  • Solution-Fabric
    • Fabric解决方案
  • API参考
    • 通用说明
    • 公共头和错误返回
    • 概述
  • 常见问题
    • windows下使用kubectl
    • 自动扩缩容常见问题
    • 通过kubectl创建简单的服务
    • 业务应用如何使用负载均衡?
    • 常见问题总览
    • 集群管理常见问题
  • API_V2参考
    • 通用说明
    • Instance相关接口
    • 附录
    • Autoscaler相关接口
    • 组件管理相关接口
    • 套餐适配相关接口
    • Task相关接口
    • 公共头和错误返回
    • Network相关接口
    • 服务域名
    • Cluster相关接口
    • Kubeconfig相关接口
    • InstanceGroup相关接口
    • RBAC相关接口
    • 概述
  • 产品定价
    • 产品定价
  • Solution-Xchain
    • 超级链解决方案
  • SDK
    • Go-SDK
      • 节点组管理
      • 节点管理
      • 集群管理
      • 初始化
      • 安装SDK工具包
      • 概述
  • 文档中心
  • arrow
  • 容器引擎CCE
  • arrow
  • API_V2参考
  • arrow
  • InstanceGroup相关接口
本页目录
  • 创建节点组
  • 获取节点组详情
  • 删除节点组
  • 修改节点组节点自动扩缩容配置
  • 修改节点组节点副本数
  • 获取集群节点组列表
  • 创建扩容节点组任务
  • 创建缩容节点组任务
  • 移入已有节点

InstanceGroup相关接口

更新时间:2025-08-21

创建节点组

描述

创建节点组

请求结构

Plain Text
1POST /v2/cluster/{clusterID}/instancegroup HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
clusterID String 是 URL 参数 集群 ID
instanceGroupName String 是 Request Body 参数 节点组名称,不可为空
clusterRole String 否 Request Body 参数 节点在集群中的角色. 目前仅支持Node类型阶段组, 默认值为node
shrinkPolicy String 否 Request Body 参数 节点组收缩规则. 可选 [ Priority, Uniform]. 默认为 Priority. Priority 优先收缩掉节点优先值低的节点, Uniform 多子网平均缩容
updatePolicy String 否 Request Body 参数 节点组更新规则. 可选 [ Rolling, Concurrency ]. 默认为 Concurrency. Concurrency 并发更新, Rolling 滚动更新. 该参数暂未启用
cleanPolicy String 否 Request Body 参数 节点清理规则. 可选 [ Remain, Delete ]. 默认为 Delete.
instanceTemplate InstanceTemplate 是 Request Body 参数 节点组的节点配置
replicas Integer 是 Request Body 参数 节点组节点要求的副本数. 取值范围是自然数集
clusterAutoscalerSpec ClusterAutoscalerSpec 否 Request Body 参数 集群自动伸缩配置

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 是否必须 描述
instanceGroupID String 是 节点组 ID
requestID String 是 请求 ID, 问题定位提供该 ID

请求示例

Plain Text
1POST /v2/cluster/cce-f7zeyx1u/instancegroup  HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6	"instanceGroupName": "sdk-testcase",
7	"selector": null,
8	"cleanPolicy": "Delete",
9	"instanceTemplate": {
10		"instanceName": "",
11		"runtimeType": "docker",
12		"clusterRole": "node",
13		"existedOption": {},
14		"machineType": "BCC",
15		"instanceType": "N3",
16		"vpcConfig": {
17			"vpcID": "vpc-pi9fghaxcpnf",
18			"vpcSubnetID": "sbn-ww1xf6a5fi88",
19			"securityGroupID": "g-4mnvpnrfscm1",
20			"availableZone": "zoneA"
21		},
22		"instanceResource": {
23			"cpu": 1,
24			"mem": 4,
25			"rootDiskSize": 40
26		},
27		"imageID": "305eeb25-a693-4cc0-832a-57bccf855771",
28		"instanceOS": {
29			"imageType": "System"
30		},
31		"instanceChargingType": "Postpaid",
32		"instancePreChargingOption": {},
33		"deployCustomConfig": {
34			"dockerConfig": {},
35			"preUserScript": "ls",
36			"postUserScript": "ls"
37		}
38	},
39	"replicas": 3
40}

返回示例

Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: aef503ab-66e2-4b7f-9044-e922389ed03f
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7	"requestID": "aef503ab-66e2-4b7f-9044-e922389ed03f",
8	"instanceGroupID": "cce-ig-dvej1d3y"
9}

获取节点组详情

描述

获取节点组详情

请求结构

Plain Text
1GET /v2/cluster/{clusterID}/instancegroup/{instanceGroupID} HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
clusterID String 是 URL 参数 集群 ID
instanceGroupID String 是 URL 参数 节点组 ID

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 是否必须 描述
requestID String 是 请求 ID, 问题定位提供该 ID
instanceGroup InstanceGroup 是 查询到的节点组详情

请求示例

Plain Text
1GET /v2/cluster/cce-47bqnhmj/instancegroup/cce-ig-796lmt7a  HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: 9ccdfbcf-f989-49e6-9701-6996dee804b1
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7	"requestID": "9ccdfbcf-f989-49e6-9701-6996dee804b1",
8	"instanceGroup": {
9		"spec": {
10			"cceInstanceGroupID": "cce-ig-dvej1d3y",
11			"instanceGroupName": "sdk-testcase",
12			"clusterID": "cce-z6qjgcq7",
13			"clusterRole": "node",
14			"shrinkPolicy": "Priority",
15			"updatePolicy": "Concurrency",
16			"cleanPolicy": "Delete",
17			"instanceTemplate": {
18				"instanceName": "",
19				"runtimeType": "docker",
20				"runtimeVersion": "18.9.2",
21				"clusterID": "cce-z6qjgcq7",
22				"clusterRole": "node",
23				"instanceGroupID": "cce-ig-dvej1d3y",
24				"instanceGroupName": "sdk-testcase",
25				"existedOption": {},
26				"machineType": "BCC",
27				"instanceType": "N3",
28				"bbcOption": {},
29				"vpcConfig": {
30					"vpcID": "vpc-pi9fghaxcpnf",
31					"vpcSubnetID": "sbn-ww1xf6a5fi88",
32					"securityGroupID": "g-4mnvpnrfscm1",
33					"vpcSubnetType": "BCC",
34					"vpcSubnetCIDR": "192.168.16.0/24",
35					"availableZone": "zoneA"
36				},
37				"instanceResource": {
38					"cpu": 1,
39					"mem": 4,
40					"rootDiskType": "hp1",
41					"rootDiskSize": 40
42				},
43				"imageID": "m-4Umtt2i5",
44				"instanceOS": {
45					"imageType": "System",
46					"imageName": "centos-8u0-x86_64-20200601205040",
47					"osType": "linux",
48					"osName": "CentOS",
49					"osVersion": "8.0",
50					"osArch": "x86_64 (64bit)",
51					"osBuild": "2020060100"
52				},
53				"eipOption": {},
54				"instanceChargingType": "Postpaid",
55				"instancePreChargingOption": {},
56				"deleteOption": {
57					"deleteResource": true,
58					"deleteCDSSnapshot": true
59				},
60				"deployCustomConfig": {
61					"dockerConfig": {},
62					"preUserScript": "bHM=",
63					"postUserScript": "bHM="
64				},
65				"labels": {
66					"cluster-id": "cce-z6qjgcq7",
67					"cluster-role": "node",
68					"instance-group-id": "cce-ig-dvej1d3y"
69				},
70				"cceInstancePriority": 5
71			},
72			"replicas": 3,
73			"clusterAutoscalerSpec": {
74				"enabled": false,
75				"minReplicas": 0,
76				"maxReplicas": 0,
77				"scalingGroupPriority": 0
78			}
79		},
80		"status": {
81			"readyReplicas": 3,
82			"pause": {
83				"paused": false,
84				"reason": ""
85			}
86		},
87		"createdAt": "2020-09-27T06:34:51Z"
88	}
89}

删除节点组

描述

删除节点组

请求结构

Plain Text
1DELETE /v2/cluster/{clusterID}/instancegroup/{instanceGroupID} HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
clusterID String 是 URL 参数 集群 ID
instanceGroupID String 是 URL 参数 节点组 ID
deleteInstances Boolean 否 Query 参数 是否删除节点组内节点. 默认为false
releaseAllResource Boolean 否 Query 参数 是否将该节点组中的节点移出集群,并释放虚机资源、后付费公网IP和云磁盘. 默认为false

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 是否必须 描述
requestID String 是 请求 ID, 问题定位提供该 ID

请求示例

Plain Text
1DELETE /v2/cluster/cce-f7zeyx1u/instancegroup/cce-ig-dvej1d3y?deleteInstances=true  HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: b1a9e426-c0ca-4668-a1d8-624c5000d365
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7	"requestID": "b1a9e426-c0ca-4668-a1d8-624c5000d365"
8}

修改节点组节点自动扩缩容配置

描述

修改节点组节点自动扩缩容配置

请求结构

Plain Text
1PUT /v2/cluster/{clusterID}/instancegroup/{instanceGroupID}/autoscaler HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
clusterID String 是 URL 参数 集群 ID
instanceGroupID String 是 URL 参数 节点组 ID
enabled Boolean 是 Request Body 参数 是否启用Autoscaler
minReplicas Integer 是 Request Body 参数 最小副本数. 取值范围是自然数集.
maxReplicas Integer 是 Request Body 参数 最大副本数. 取值范围是自然数集, 需大于minReplicas.
scalingGroupPriority Integer 是 Request Body 参数 伸缩组优先级. 取值范围是自然数集.

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 是否必须 描述
requestID String 是 请求 ID, 问题定位提供该 ID

请求示例

Plain Text
1PUT /v2/cluster/cce-f7zeyx1u/instancegroup/cce-ig-dvej1d3y/autoscaler  HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6	"enabled": true,
7	"minReplicas": 2,
8	"maxReplicas": 5,
9	"scalingGroupPriority": 1
10}

返回示例

Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: 27f91a44-7257-48e7-a8d8-849f45a32da4
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7	"requestID": "27f91a44-7257-48e7-a8d8-849f45a32da4"
8}

修改节点组节点副本数

描述

修改节点组节点副本数

请求结构

Plain Text
1PUT /v2/cluster/{clusterID}/instancegroup/{instanceGroupID}/replicas HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
clusterID String 是 URL 参数 集群 ID
instanceGroupID String 是 URL 参数 节点组 ID
replicas Integer 是 Request Body 参数 期望的节点组节点的副本数. 取值范围是自然数集.
instanceIDs List<String> 否 Request Body 参数 指定被添加或是优先被删除的节点 ID 集合
deleteInstance Boolean 否 Request Body 参数 是否删除节点组收缩时被剔除的节点. 默认为 false. 此值的优先级高于节点组CleanPolicy, 被缩容节点使用该配置.
deleteOption DeleteOption 否 Request Body 参数 修改指定节点删除选项.

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 是否必须 描述
requestID String 是 请求 ID, 问题定位提供该 ID

请求示例

Plain Text
1PUT /v2/cluster/cce-f7zeyx1u/instancegroup/cce-ig-dvej1d3y/replicas  HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6	"replicas": 1,
7	"instanceIDs": null,
8	"deleteInstance": true,
9	"deleteOption": {
10		"deleteResource": true,
11		"deleteCDSSnapshot": true
12	}
13}

返回示例

Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: 6f593304-6787-45ea-8e0f-426ee331cc8b
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7	"requestID": "6f593304-6787-45ea-8e0f-426ee331cc8b"
8}

获取集群节点组列表

描述

获取集群的节点组列表

请求结构

Plain Text
1GET /v2/cluster/{clusterID}/instancegroups HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
clusterID String 是 URL 参数 集群 ID
pageNo Integer 否 Query 参数 查询页码序号. pageNo 或 pageSize 为0时会返回集群全部节点组
pageSize Integer 否 Query 参数 查询结果每页条目数. pageNo 或 pageSize 为0时会返回集群全部节点组

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 是否必须 描述
page ListInstanceGroupPage 是 节点组查询结果页
requestID String 是 请求 ID, 问题定位提供该 ID

请求示例

Plain Text
1GET /v2/cluster/cce-f7zeyx1u/instancegroups?pageNo=1&pageSize=10  HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: 1a65cc49-f3da-4d66-b994-7d7cd6797af5
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7	"requestID": "1a65cc49-f3da-4d66-b994-7d7cd6797af5",
8	"page": {
9		"pageNo": 0,
10		"pageSize": 0,
11		"totalCount": 1,
12		"list": [
13			{
14				"spec": {
15					"cceInstanceGroupID": "cce-ig-dvej1d3y",
16					"instanceGroupName": "sdk-testcase",
17					"clusterID": "cce-z6qjgcq7",
18					"clusterRole": "node",
19					"shrinkPolicy": "Priority",
20					"updatePolicy": "Concurrency",
21					"cleanPolicy": "Delete",
22					"instanceTemplate": {
23						"instanceName": "",
24						"runtimeType": "docker",
25						"runtimeVersion": "18.9.2",
26						"clusterID": "cce-z6qjgcq7",
27						"clusterRole": "node",
28						"instanceGroupID": "cce-ig-dvej1d3y",
29						"instanceGroupName": "sdk-testcase",
30						"existedOption": {},
31						"machineType": "BCC",
32						"instanceType": "N3",
33						"bbcOption": {},
34						"vpcConfig": {
35							"vpcID": "vpc-pi9fghaxcpnf",
36							"vpcSubnetID": "sbn-ww1xf6a5fi88",
37							"securityGroupID": "g-4mnvpnrfscm1",
38							"vpcSubnetType": "BCC",
39							"vpcSubnetCIDR": "192.168.16.0/24",
40							"availableZone": "zoneA"
41						},
42						"instanceResource": {
43							"cpu": 1,
44							"mem": 4,
45							"rootDiskType": "hp1",
46							"rootDiskSize": 40
47						},
48						"imageID": "m-4Umtt2i5",
49						"instanceOS": {
50							"imageType": "System",
51							"imageName": "centos-8u0-x86_64-20200601205040",
52							"osType": "linux",
53							"osName": "CentOS",
54							"osVersion": "8.0",
55							"osArch": "x86_64 (64bit)",
56							"osBuild": "2020060100"
57						},
58						"eipOption": {},
59						"instanceChargingType": "Postpaid",
60						"instancePreChargingOption": {},
61						"deleteOption": {
62							"deleteResource": true,
63							"deleteCDSSnapshot": true
64						},
65						"deployCustomConfig": {
66							"dockerConfig": {},
67							"preUserScript": "bHM=",
68							"postUserScript": "bHM="
69						},
70						"labels": {
71							"cluster-id": "cce-z6qjgcq7",
72							"cluster-role": "node",
73							"instance-group-id": "cce-ig-dvej1d3y"
74						},
75						"cceInstancePriority": 5
76					},
77					"replicas": 3,
78					"clusterAutoscalerSpec": {
79						"enabled": false,
80						"minReplicas": 0,
81						"maxReplicas": 0,
82						"scalingGroupPriority": 0
83					}
84				},
85				"status": {
86					"readyReplicas": 3,
87					"pause": {
88						"paused": false,
89						"reason": ""
90					}
91				},
92				"createdAt": "2020-09-27T06:34:51Z"
93			}
94		]
95	}
96}

创建扩容节点组任务

描述

创建扩容节点组任务。

请求结构

Plain Text
1PUT /v2/cluster/{clusterID}/instancegroup/{instanceGroupID}/scaleup HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
clusterID String 是 URL 参数 集群 ID
instanceGroupID String 是 URL 参数 节点组 ID
upToReplicas Integer 是(upToReplicas和upReplicas两者填其一) Query 参数 扩容节点组的目标副本数,如果选择该参数则必须大于节点组的当前副本数
upReplicas Integer 是(upToReplicas和upReplicas两者填其一) Query 参数 节点组扩容的副本数,如果选择该参数则必须大于0

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
taskID String 节点组扩容任务 ID
requestID String 请求 ID, 问题定位提供该 ID

请求示例

Plain Text
1PUT /api/cce/service/v2/cluster/cce-jvyvb9al/instancegroup/cce-ig-glw5jb7x/scaleup?upToReplicas=4 HTTP/1.1
2Host: cce.bj.baidubce.com
3Content-Type: application/json
4Authorization: authorization string

返回示例

Plain Text
1{
2    "requestID": "deb8d7b9-37b2-4fc2-b956-0db512c37b5e",
3    "taskID": "task-cce-ig-glw5jb7x-scaleup-zibi4ixw"
4}

创建缩容节点组任务

描述

创建缩容节点组任务。

请求结构

Plain Text
1PUT /v2/cluster/{clusterID}/instancegroup/{instanceGroupID}/scaledown HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string

请求参数

参数名称 类型 是否必须 参数位置 描述
clusterID String 是 URL 参数 集群 ID
instanceGroupID String 是 URL 参数 节点组 ID
instancesToBeRemoved List<String> 是 Request Body 参数 缩容节点组时计划从节点组移除的节点 ID 列表
cleanPolicy String 是 Request Body 参数 缩容节点组时是否保留节点对应的实例, 可选 [Remain,Delete]
deleteOption DeleteOption 否 Request Body 参数 修改指定节点删除选项。cleanPolicy为Delete时,需要设置该参数。

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
taskID String 节点组扩容任务 ID
requestID String 请求 ID, 问题定位提供该 ID

请求示例

Plain Text
1PUT /api/cce/service/v2/cluster/cce-91xd2ojb/instancegroup/cce-ig-l68ajx08/scaledown?= HTTP/1.1
2Host: cce.bj.baidubce.com
3Content-Type: application/json
4Authorization: authorization string
5
6{
7    "instancesToBeRemoved": [
8        "cce-91xd2ojb-6y5feg8v",
9        "cce-91xd2ojb-6y5feg8v"
10    ],
11    "cleanPolicy":"Delete",
12    "deleteOption":{
13        "moveOut":true,
14        "deleteResource":false,
15        "deleteCDSSnapshot":false
16    }
17}

返回示例

Plain Text
1{
2    "requestID": "deb8d7b9-37b2-4fc2-b956-0db512c37b5e",
3    "taskID": "task-cce-ig-l68ajx08-scaledown-zibi4ixw"
4}

移入已有节点

描述

移入已有节点到节点组中。

返回头域

除公共头域,无其它特殊头域。

请求结构

Plain Text
1PUT  /v2/cluster/[clusterID]/instancegroup/[instanceGroupID]/attachInstances HTTP/1.1
2Host: cce.bd.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
clusterID string 是 URL 参数 集群 ID,用于标识特定的集群。
instanceGroupID string 是 URL 参数 节点组 ID,用于标识特定的节点组。
inCluster bool 是 Request Body 参数 是否是集群内节点。
useInstanceGroupConfig bool 是 Request Body 参数 针对集群外节点生效,设置为 true 将使用节点组配置。
existedInstances List<InstanceSet> 否 Request Body 参数 配置集群外节点的详细信息。
existedInstancesInCluster List<ExistedInstanceInCluster> 否 Request Body 参数 配置集群内节点的详细信息。

返回示例

Plain Text
1{
2    "requestID": "deb8d7b9-37b2-4fc2-b956-0db512c37b5e",
3    "taskID": "task-cce-ig-l68ajx08-scaledown-zibi4ixw"
4}

请求示例 移入集群外节点

Plain Text
1PUT /api/cce/service/v2/cluster/cce-qfdlj5g9/instancegroup/cce-ig-iw245bl0/attachInstances HTTP/1.1
2Host: cce.bd.baidubce.com
3Authorization: authorization string
4
5{
6    "inCluster": false,
7    "useInstanceGroupConfig": true,
8    "existedInstances": [
9        {
10            "instanceSpec": {
11                "sshKeyID": "k-FH1hIJ0h",
12                "existed": true,
13                "existedOption": {
14                    "existedInstanceID": "i-oCnp4BG5",
15                    "rebuild": true
16                },
17                "machineType": "BCC",
18                "clusterRole": "node",
19                "instanceOS": {
20                    "imageType": "System"
21                },
22                "imageID": "m-PljC8e8k",
23                "instanceResource": {
24                    "cdsList": []
25                }
26            }
27        }
28    ]
29}

移入集群内节点

Plain Text
1PUT /api/cce/service/v2/cluster/cce-qfdlj5g9/instancegroup/cce-ig-iw245bl0/attachInstances HTTP/1.1
2Host: cce.bd.baidubce.com
3Authorization: authorization string
4
5{
6    "inCluster": true,
7    "existedInstancesInCluster": [
8        {
9            "existedInstanceID": "i-oCnp4BG5"
10        }
11    ]
12}

返回示例

Plain Text
1{
2    "requestID": "deb8d7b9-37b2-4fc2-b956-0db512c37b5e",
3    "taskID": "task-cce-ig-l68ajx08-scaledown-zibi4ixw"
4}

上一篇
Kubeconfig相关接口
下一篇
RBAC相关接口