Cluster相关接口

容器引擎 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
  • Cluster相关接口
本页目录
  • 创建集群
  • 集群列表
  • 集群详情
  • 删除集群
  • 更新集群删除保护开关
  • 获取集群事件步骤

Cluster相关接口

更新时间:2025-08-21

创建集群

描述

创建 CCE K8S 集群

请求结构

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

请求头域

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

请求参数

参数名称 类型 是否必须 参数位置 描述
cluster ClusterSpec 是 RequestBody 参数 集群配置
masters List<InstanceSet> 否 RequestBody 参数 集群 Master 配置, 支持异构组合. 当集群类型为托管型时无需设置该参数
nodes List<InstanceSet> 否 RequestBody 参数 集群 Worker 配置, 支持异构组合. 不设置此参数时将会创建仅有master的集群
options CreateClusterOptions 是 RequestBody 参数 集群创建选项. 用户可以设置强制跳过网段冲突检查

返回头域

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

返回参数

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

请求示例: 托管 Master 集群

  • 设置 cluster.masterConfig 的 masterType 设为 managed
  • 无需设置 masters 参数
  • 其它参数参考 API 文档按需设置
Plain Text
1POST /v2/cluster  HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6    "cluster":{
7        "clusterName":"test-open-types",
8        "k8sVersion":"1.16.8",
9        "runtimeType":"docker",
10        "vpcID":"vpc-mwbgygrjb72w",
11        "masterConfig":{
12            "masterType":"managed",
13            "clusterHA":1,
14            "exposedPublic":false,
15            "clusterBLBVPCSubnetID":"sbn-mnbvhnuupv1u",
16            "managedClusterMasterOption":{
17                "masterVPCSubnetZone":"zoneA"
18            }
19        },
20		"containerNetworkConfig": {
21			"mode": "kubenet",
22			"lbServiceVPCSubnetID": "sbn-mnbvhnuupv1u",
23			"clusterPodCIDR": "172.28.0.0/16",
24			"clusterIPServiceCIDR": "172.31.0.0/16"
25		},
26		"k8sCustomConfig": {
27			"kubeAPIQPS": 1000,
28			"kubeAPIBurst": 2000
29		}
30    },
31    "nodes":[
32        {
33            "instanceSpec":{
34                "instanceName":"instance-name",
35                "clusterRole":"node",
36                "existed":false,
37                "machineType":"BCC",
38                "instanceType":"N3",
39                "vpcConfig":{
40                    "vpcID":"vpc-mwbgygrjb72w",
41                    "vpcSubnetID":"sbn-mnbvhnuupv1u",
42                    "availableZone":"zoneA",
43                    "securityGroup": {
44                      "customSecurityGroups": [],
45                      "enableCCERequiredSecurityGroup": true,
46                      "enableCCEOptionalSecurityGroup": true
47                    }
48                },
49                "instanceResource":{
50                    "cpu":4,
51                    "mem":8,
52                    "rootDiskSize":40,
53                    "localDiskSize":0,
54                    "cdsList":[]
55                },
56                "imageID":"m-gTpZ1k6n",
57                "instanceOS":{
58                    "imageType":"System",
59                    "osType":"linux",
60                    "osName":"CentOS",
61                    "osVersion":"7.5",
62                    "osArch":"x86_64 (64bit)"
63                },
64                "needEIP":false,
65                "adminPassword":"test123!T",
66                "instanceChargingType":"Postpaid",
67                "runtimeType":"docker"
68            },
69            "count":1
70        }
71    ]
72}

请求示例: 自定义 Master 集群

  • 设置 cluster.masterConfig 的 masterType 设为 custom
  • 设置 masters 参数
  • 其它参数参考 API 文档按需设置
Plain Text
1{
2    "cluster":{
3        "clusterName":"create-custom-cluster-reg",
4        "description":"集群描述",
5        "k8sVersion":"1.16.8",
6        "runtimeType":"docker",
7        "vpcID":"vpc-43zsdm46t9rp",
8        "masterConfig":{
9            "masterType":"custom",
10            "exposedPublic":true,
11            "clusterBLBVPCSubnetID":"sbn-vvqsb9b57f24"
12        },
13        "containerNetworkConfig":{
14            "mode":"kubenet",
15            "lbServiceVPCSubnetID":"sbn-vvqsb9b57f24",
16            "nodePortRangeMin":50000,
17            "nodePortRangeMax":51000,
18            "clusterPodCIDR":"10.2.0.0/16",
19            "clusterIPServiceCIDR":"172.16.0.0/16",
20            "maxPodsPerNode":64,
21            "kubeProxyMode":"ipvs"
22        }
23    },
24    "masters":[
25        {
26            "instanceSpec":{
27                "machineType":"BCC",
28                "instanceType":"N3",
29                "vpcConfig":{
30                    "vpcSubnetID":"sbn-vvqsb9b57f24",
31                    "securityGroup": {
32                      "customSecurityGroups": [],
33                      "enableCCERequiredSecurityGroup": true,
34                      "enableCCEOptionalSecurityGroup": true
35                    }
36                },
37                "instanceResource":{
38                    "CPU":4,
39                    "MEM":8
40                },
41                "instanceOS": {
42                    "imageName": "7.5 x86_64 (64bit)",
43                    "imageType": "System",
44                    "osType": "linux",
45                    "osName": "CentOS",
46                    "osVersion": "7.5",
47                    "osArch": "x86_64 (64bit)"
48                },
49                "adminPassword":"test123!T"
50            },
51            "count":1
52        }
53    ],
54    "nodes":[
55        {
56            "instanceSpec":{
57                "machineType":"BCC",
58                "instanceType":"N3",
59                "vpcConfig":{
60                    "vpcSubnetID":"sbn-vvqsb9b57f24",
61                    "securityGroupID":"g-k4tsm0id2g1n"
62                },
63                "instanceResource":{
64                    "CPU":4,
65                    "MEM":8,
66                    "cdsList":[
67                        {
68                            "diskPath":"/data",
69                            "storageType":"cloud_hp1",
70                            "cdsSize":200
71                        }
72                    ]
73                },
74                "instanceOS": {
75                    "imageName": "7.5 x86_64 (64bit)",
76                    "imageType": "System",
77                    "osType": "linux",
78                    "osName": "CentOS",
79                    "osVersion": "7.5",
80                    "osArch": "x86_64 (64bit)"
81                },
82                "adminPassword":"test123!T"
83            },
84            "count":1
85        }
86    ]
87}

请求示例: 已有实例

  • 如果 Master 需要使用已有实例,设置 cluster.masterConfig 的 masterType 设为 custom
  • 添加 Master 或 Node 机器配置时,设置 instanceSpec.existed 为 true 并设置 instanceSpec.existedOption.existedInstanceID 为希望使用的已有节点 ID
  • 如果不希望重装系统,设置 instanceSpec.existedOption.rebuild 为 false 并务必保证机器密码正确,否则节点会因无法部署相关服务而创建失败
  • 如果不希望重装系统,无需设置 instanceSpec.instanceOS 与 instanceSpec.machineType
  • 其它参数参考 API 文档按需设置
Plain Text
1{
2    "cluster":{
3        "clusterName":"create-existed-bcc-cluster-reg",
4        "description":"集群描述",
5        "k8sVersion":"1.16.8",
6        "runtimeType":"docker",
7        "vpcID":"vpc-43zsdm46t9rp",
8        "masterConfig":{
9            "masterType":"custom",
10            "exposedPublic":true,
11            "clusterBLBVPCSubnetID":"sbn-vvqsb9b57f24"
12        },
13        "containerNetworkConfig":{
14            "mode":"kubenet",
15            "lbServiceVPCSubnetID":"sbn-vvqsb9b57f24",
16            "nodePortRangeMin":30000,
17            "nodePortRangeMax":32768,
18            "clusterPodCIDR":"10.0.0.0/16",
19            "clusterIPServiceCIDR":"172.16.0.0/16",
20            "maxPodsPerNode":256,
21            "kubeProxyMode":"ipvs"
22        }
23    },
24    "masters":[
25        {
26            "instanceSpec":{
27                "existed":true,
28                "existedOption":{
29                    "existedInstanceID":"i-SxeBLkcN",
30                    "rebuild":true
31                },
32                "machineType":"BCC",
33                "instanceOS": {
34                    "imageName": "7.5 x86_64 (64bit)",
35                    "imageType": "System",
36                    "osType": "linux",
37                    "osName": "CentOS",
38                    "osVersion": "7.5",
39                    "osArch": "x86_64 (64bit)"
40                },
41                "adminPassword":"test123!T"
42            }
43        }
44    ],
45    "nodes":[
46        {
47            "instanceSpec":{
48                "existed":true,
49                "existedOption":{
50                    "existedInstanceID":"i-M56Un1DO",
51                    "rebuild":true
52                },
53                "machineType":"BCC",
54                "instanceOS": {
55                    "imageName": "7.5 x86_64 (64bit)",
56                    "imageType": "System",
57                    "osType": "linux",
58                    "osName": "CentOS",
59                    "osVersion": "7.5",
60                    "osArch": "x86_64 (64bit)"
61                },
62                "adminPassword":"test123!T"
63            }
64        }
65    ]
66}

请求示例:挂载CDS
有时我们希望在新建节点的同时为节点挂载 1 到多个 CDS,此时在创建集群时,为节点设置 CDS 参数和相关挂载路径即可。示例如下。
需要注意的是,每个路径下只能挂载一个 CDS,但一个路径的子路径下可以挂载另一个 CDS,例如 /a 目录下仅可挂载一个 CDS,但 /a/b 目录下可以挂载另一个 CDS。
已有节点仅可挂载 CDS 到指定路径,不会新建 CDS。因此当已有节点试图挂载 CDS 到指定 Path 但找不到满足条件的 CDS 时,将会忽略相关 CDS 配置。

Plain Text
1{
2    ......
3    
4    "masters":[
5        {
6            "instanceSpec":{
7                ......
8                "instanceResource": {
9                    "cdsList": [
10                         {diskPath: "/home/cce", storageType: "cloud_hp1", cdsSize: 50}
11                     ] 
12                },
13                ......
14            }
15        }
16    ],
17    "nodes":[
18        {
19            "instanceSpec":{
20                ......
21                "instanceResource": {
22                    "cdsList": [
23                         {diskPath: "/home/cce", storageType: "cloud_hp1", cdsSize: 60}
24                     ] 
25                },
26                ......
27            }
28        }
29    ]
30}

返回示例

Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: d2ce8f50-529a-4663-9265-ad08c94633c8
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5{
6    "clusterID": "cce-NqYwWEhu",
7    "requestID": "d2ce8f50-529a-4663-9265-ad08c94633c8"
8}

集群列表

描述

查询用户 CCE K8S 集群列表

请求结构

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

请求头域

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

请求参数

参数名称 类型 是否必须 参数位置 描述
keywordType String 否 Query 参数 集群模糊查询字段,可选 [ clusterName, clusterID ],默认值为 clusterName
keyword String 否 Query 参数 查询关键词,默认值为空字符串
orderBy String 否 Query 参数 集群查询排序字段,可选 [ clusterName, clusterID, createdAt ],默认值为 clusterName
order String 否 Query 参数 排序方式,可选 [ ASC, DESC ], ASC 为升序,DESC 为降序,默认值为 ASC
pageNo Integer 否 Query 参数 页码,默认值为1
pageSize Integer 否 Query 参数 单页结果数,默认值为10

返回头域

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

返回参数

参数名称 类型 描述 描述
clusterPage ClusterPage 是 集群分页查询返回结果
requestID String 是 请求 ID, 问题定位提供该 ID

请求示例

Plain Text
1GET /v2/clusters?keywordType=clusterName&keyword=&orderBy=clusterID&order=ASC&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: 97342dc7-29a1-4ed9-a75d-904bb293d295
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7	"clusterPage": {
8		"keywordType": "clusterName",
9		"keyword": "",
10		"orderBy": "clusterID",
11		"order": "ASC",
12		"pageNo": 1,
13		"pageSize": 10,
14		"totalCount": 1,
15		"clusterList": [
16			{
17				"spec": {
18					"clusterID": "cce-shpdaa9l",
19					"clusterName": "sdk-ccev2-test",
20					"clusterType": "normal",
21					"description": "",
22					"k8sVersion": "1.16.8",
23					"vpcID": "vpc-aj2rcjm084y5",
24					"vpcCIDR": "192.168.0.0/16",
25					"plugins": [
26						"ip-masq-agent",
27						"core-dns",
28						"kube-proxy",
29						"metrics-server",
30						"nvidia-gpu"
31					],
32					"masterConfig": {
33						"masterType": "managed",
34						"clusterHA": 1,
35						"clusterBLBVPCSubnetID": "sbn-0dizryuc81c0",
36						"managedClusterMasterOption": {
37							"masterVPCSubnetZone": "zoneA"
38						}
39					},
40					"containerNetworkConfig": {
41						"mode": "kubenet",
42						"ipVersion": "ipv4",
43						"lbServiceVPCSubnetID": "sbn-0dizryuc81c0",
44						"nodePortRangeMin": 30000,
45						"nodePortRangeMax": 32767,
46						"clusterPodCIDR": "172.28.0.0/16",
47						"clusterIPServiceCIDR": "172.31.0.0/16",
48						"maxPodsPerNode": 128,
49						"kubeProxyMode": "ipvs"
50					}
51				},
52				"status": {
53					"clusterBLB": {
54						"id": "lb-1454d5c4",
55						"vpcIP": "100.64.230.44",
56						"eip": ""
57					},
58					"clusterPhase": "running",
59					"nodeNum": 0
60				},
61				"createdAt": "2020-09-04T01:58:12Z",
62				"updatedAt": "2020-09-04T02:00:37Z"
63			}
64		]
65	},
66	"requestID": "97342dc7-29a1-4ed9-a75d-904bb293d295"
67}

集群详情

描述

查询指定集群详情

请求结构

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

请求头域

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

请求参数

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

返回头域

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

返回参数

参数名称 类型 是否必须 描述
cluster Cluster 是 集群详情查询结果
requestID String 是 请求 ID, 问题定位提供该 ID

请求示例

Plain Text
1GET /v2/cluster/cce-zyt88sqy  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: 928a21b5-d117-4a83-a274-fd7d6f413524
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7	"cluster": {
8		"spec": {
9			"clusterID": "cce-shpdaa9l",
10			"clusterName": "sdk-ccev2-test",
11			"clusterType": "normal",
12			"description": "",
13			"k8sVersion": "1.16.8",
14			"vpcID": "vpc-aj2rcjm084y5",
15			"vpcCIDR": "192.168.0.0/16",
16			"plugins": [
17				"ip-masq-agent",
18				"core-dns",
19				"kube-proxy",
20				"metrics-server",
21				"nvidia-gpu"
22			],
23			"masterConfig": {
24				"masterType": "managed",
25				"clusterHA": 1,
26				"clusterBLBVPCSubnetID": "sbn-0dizryuc81c0",
27				"managedClusterMasterOption": {
28					"masterVPCSubnetZone": "zoneA"
29				}
30			},
31			"containerNetworkConfig": {
32				"mode": "kubenet",
33				"ipVersion": "ipv4",
34				"lbServiceVPCSubnetID": "sbn-0dizryuc81c0",
35				"nodePortRangeMin": 30000,
36				"nodePortRangeMax": 32767,
37				"clusterPodCIDR": "172.28.0.0/16",
38				"clusterIPServiceCIDR": "172.31.0.0/16",
39				"maxPodsPerNode": 128,
40				"kubeProxyMode": "ipvs"
41			}
42		},
43		"status": {
44			"clusterBLB": {
45				"id": "lb-1454d5c4",
46				"vpcIP": "100.64.230.44",
47				"eip": ""
48			},
49			"clusterPhase": "running",
50			"nodeNum": 0
51		},
52		"createdAt": "2020-09-04T01:58:12Z",
53		"updatedAt": "2020-09-04T02:00:37Z"
54	},
55	"requestID": "928a21b5-d117-4a83-a274-fd7d6f413524"
56}

删除集群

描述

删除指定集群

请求结构

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

请求头域

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

请求参数

参数名称 类型 是否必须 参数位置 描述
clusterID String 是 URL 参数 集群 ID
deleteResource Boolean 否 Query 参数 是否删除相关资源(后付费公网IP和云磁盘),默认值为 false
deleteCDSSnapshot Boolean 否 Query 参数 是否删除云磁盘快照,默认值为 false
moveOut Boolean 否 Query 参数 集群删除是否保留节点,默认值为 false

返回头域

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

返回参数

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

请求示例

Plain Text
1DELETE /v2/cluster/cce-uqc4lju1?deleteResource=true&deleteCDSSnapshot=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: 105ce04b-1a42-4f77-9d22-ab6f413f9d69
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7    "requestID": "105ce04b-1a42-4f77-9d22-ab6f413f9d69"
8}

更新集群删除保护开关

描述

更新集群删除保护开关

请求结构

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

请求头域

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

请求参数

参数名称 类型 是否必须 参数位置 描述
clusterID String 是 URL 参数 集群 ID
forbidDelete Boolean 是 RequestBody 参数 是否打开或关闭集群删除保护,true为打开,false为关闭

返回头域

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

返回参数

参数名称 类型 是否必须 描述
success Boolean 是 请求是否成功
forbidDelete Boolean 是 集群删除保护状态,true为打开,false为关闭

请求示例

Plain Text
1PUT v2/cluster/cce-5gw06fjs/forbiddelete HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6    "forbidDelete": false
7}

返回示例

Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: 3d61a898-b804-4d6f-8c7c-b741d2ffbe45
3Date: Wed, 11 Dec 2024 02:59:18 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7    "success": true,
8    "forbidDelete": true
9}

获取集群事件步骤

描述

获取创建或删除过程中集群所处的事件步骤。

请求结构

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

请求头域

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

请求参数

参数名称 类型 是否必选 参数位置 描述
clusterID String 是 URL 参数 集群 ID

返回头域

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

返回参数

参数名称 类型 是否必选 描述
status String 是 事件类型
steps List<Step> 是 集群操作步骤
requestID String 是 请求ID

请求示例

Plain Text
1GET v2/event/cluster/cce-j8pb3dm0  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: 08eb305a-87fb-4360-8a27-42b9561edf4a
3Date: Fri, 12 Aug 2022 03:10:30 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7    "status": "created",
8    "steps": [
9        {
10            "stepName": "创建基础证书",
11            "stepStatus": "done",
12            "ready": true,
13            "startTime": "2022-07-12T09:23:07Z",
14            "finishedTime": "2022-07-12T09:23:07Z",
15            "retryCount": 1,
16            "errInfo": {}
17        },
18        {
19            "stepName": "创建 BLB",
20            "stepStatus": "done",
21            "ready": true,
22            "startTime": "2022-07-12T09:23:07Z",
23            "finishedTime": "2022-07-12T09:23:16Z",
24            "costSeconds": 9,
25            "retryCount": 1,
26            "errInfo": {}
27        },
28        {
29            "stepName": "创建 EIP",
30            "stepStatus": "done",
31            "ready": true,
32            "startTime": "2022-07-12T09:23:16Z",
33            "finishedTime": "2022-07-12T09:23:25Z",
34            "costSeconds": 9,
35            "retryCount": 1,
36            "errInfo": {}
37        },
38        {
39            "stepName": "创建 Master",
40            "stepStatus": "done",
41            "ready": true,
42            "startTime": "2022-07-12T09:23:25Z",
43            "finishedTime": "2022-07-12T09:23:54Z",
44            "costSeconds": 29,
45            "retryCount": 1,
46            "errInfo": {}
47        },
48        {
49            "stepName": "连通 APIServer",
50            "stepStatus": "done",
51            "ready": true,
52            "startTime": "2022-07-12T09:23:54Z",
53            "finishedTime": "2022-07-12T09:25:52Z",
54            "costSeconds": 118,
55            "retryCount": 2,
56            "errInfo": {}
57        },
58        {
59            "stepName": "部署 K8S 插件",
60            "stepStatus": "done",
61            "ready": true,
62            "startTime": "2022-07-12T09:25:53Z",
63            "finishedTime": "2022-07-12T09:26:34Z",
64            "costSeconds": 41,
65            "retryCount": 1,
66            "errInfo": {}
67        }
68    ],
69    "requestID": "562c76ee-c65f-4673-9574-89222f1cd210"
70}

上一篇
服务域名
下一篇
Kubeconfig相关接口