---
title: "创建K8s集群"
method: POST
path: "/api/v1/k8s/cluster"
tags: ["K8s集群管理"]
---

# 创建K8s集群

`POST /api/v1/k8s/cluster`

创建K8s集群，可选择是否自动部署

## Request body

- ModelCreateKubeClusterRequest
  - `autoDeploy` boolean — 是否自动部署
  - `clusterType` integer — 集群类型:1-自建,2-导入(默认为自建)
  - `deploymentMode` integer — 部署模式:1-单Master,2-多Master
  - `description` string — 集群描述
  - `enabledComponents` string[] — 启用组件
  - `kubeconfig` string — 导入集群参数
  - `name` string, required — 集群名称
  - `nodeConfig` ModelNodeConfig
    - `etcdHostIds` integer[], required — ETCD节点主机ID
    - `masterHostIds` integer[], required — Master节点主机ID
    - `workerHostIds` integer[] — Worker节点主机ID
  - `privateRegistry` string — 私有镜像仓库地址（兼容旧版本）
  - `registryConfig` ModelRegistryConfig
    - `privateRegistry` string — 私有镜像仓库地址
    - `registryPassword` string — 镜像仓库密码
    - `registryUsername` string — 镜像仓库用户名
    - `usePrivateRegistry` boolean — 是否使用私有仓库
  - `registryPassword` string — 镜像仓库密码（兼容旧版本）
  - `registryUsername` string — 镜像仓库用户名（兼容旧版本）
  - `taskDescription` string — 任务描述
  - `taskName` string — 任务名称
  - `version` string — 自建集群参数

## Response `200`

创建成功

- object
  - `code` integer — 状态码
  - `data` object — 返回的数据
    - `clusterType` integer
    - `createdAt` string
    - `credential` string
    - `description` string
    - `id` integer
    - `lastSyncAt` string
    - `masterNodes` integer
    - `name` string
    - `nodeCount` integer
    - `readyNodes` integer
    - `status` integer
    - `updatedAt` string
    - `version` string
    - `workerNodes` integer
  - `message` string — 提示信息

## Other responses

- `400` — 参数错误
- `500` — 服务器错误

---

[API](https://skmtc.net/opsre/apis/devops.md) · [All operations](https://skmtc.net/opsre/apis/devops/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opsre/devops/revisions/25cac8835c4c/schema)