平台中心
首页 / API 文档 / 平台管理 / 集群管理 / 集群基础操作 / 更新集群的状态

更新集群的状态

请求信息

请求行

PUT /apis/platform.tkestack.io/v1/clusters/{name}/status

更新指定的集群的状态。

请求行参数

名称 类型 是否必填项 描述
name string 是集群的名称。

请求参数

名称 类型 是否必填项 描述
dryRun string 否当该参数出现时，表示不应该持久化修改。一个无效的或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：All，将处理所有的试运行阶段。
fieldManager string 否fieldManager 是与正在进行这些更改的参与者或实体相关联的名称。值必须少于 128 字符，且仅包含可打印字符，参见 https://golang.org/pkg/unicode/#IsPrint。
pretty string 否如果为 true，则会将返回结果输出成适合打印的格式。

请求体

Content-Type */*

请求体示例

Kubernetes 集群。

{
   "addresses": [
     {
       "host": "192.168.16.53",
       "path": "",
       "port": 6443,
       "type": "Real"
     },
     {
       "host": "192.168.16.54",
       "path": "",
       "port": 6443,
       "type": "Real"
     },
     {
       "host": "192.168.16.55",
       "path": "",
       "port": 6443,
       "type": "Real"
     },
     {
       "host": "192.168.16.52",
       "path": "",
       "port": 6443,
       "type": "Advertise"
     }
   ],
   "clusterCIDR": "10.199.0.0/16",
   "conditions": [
     {
       "lastProbeTime": "2021-09-12T05:14:34Z",
       "lastTransitionTime": "2021-09-12T05:14:34Z",
       "status": "True",
       "type": "EnsureCopyFiles"
     },
     {
       "lastProbeTime": "2021-09-12T05:14:34Z",
       "lastTransitionTime": "2021-09-12T05:14:34Z",
       "status": "True",
       "type": "EnsurePreClusterInstallHook"
     },
     {
       "lastProbeTime": "2021-09-12T05:14:34Z",
       "lastTransitionTime": "2021-09-12T05:14:34Z",
       "status": "True",
       "type": "EnsurePreInstallHook"
     },
     {
       "lastProbeTime": "2021-09-12T05:14:42Z",
       "lastTransitionTime": "2021-09-12T05:14:34Z",
       "status": "True",
       "type": "EnsurePrepareNode"
     },
     {
       "lastProbeTime": "2021-09-12T05:14:42Z",
       "lastTransitionTime": "2021-09-12T05:14:42Z",
       "status": "True",
       "type": "EnsureClusterComplete"
     },
     {
       "lastProbeTime": "2021-09-12T05:15:27Z",
       "lastTransitionTime": "2021-09-12T05:14:42Z",
       "status": "True",
       "type": "EnsureContainerRuntime"
     },
     {
       "lastProbeTime": "2021-09-12T05:16:13Z",
       "lastTransitionTime": "2021-09-12T05:15:27Z",
       "status": "True",
       "type": "EnsureKubeNode"
     },
     {
       "lastProbeTime": "2021-09-12T05:16:13Z",
       "lastTransitionTime": "2021-09-12T05:16:13Z",
       "status": "True",
       "type": "EnsureNodeHostname"
     },
     {
       "lastProbeTime": "2021-09-12T05:17:09Z",
       "lastTransitionTime": "2021-09-12T05:16:13Z",
       "status": "True",
       "type": "EnsureInitMaster"
     },
     {
       "lastProbeTime": "2021-09-12T05:17:11Z",
       "lastTransitionTime": "2021-09-12T05:17:09Z",
       "status": "True",
       "type": "EnsureStoreCredential"
     },
     {
       "lastProbeTime": "2021-09-12T05:17:12Z",
       "lastTransitionTime": "2021-09-12T05:17:11Z",
       "status": "True",
       "type": "EnsureKubeconfig"
     },
     {
       "lastProbeTime": "2021-09-12T05:19:58Z",
       "lastTransitionTime": "2021-09-12T05:17:12Z",
       "status": "True",
       "type": "EnsureJoin"
     },
     {
       "lastProbeTime": "2021-09-12T05:19:58Z",
       "lastTransitionTime": "2021-09-12T05:19:58Z",
       "status": "True",
       "type": "EnsureCreateClusterMark"
     },
     {
       "lastProbeTime": "2021-09-12T05:19:58Z",
       "lastTransitionTime": "2021-09-12T05:19:58Z",
       "status": "True",
       "type": "EnsureCleanupScript"
     },
     {
       "lastProbeTime": "2021-09-12T05:19:58Z",
       "lastTransitionTime": "2021-09-12T05:19:58Z",
       "message": "Skip current condition",
       "reason": "Skip",
       "status": "True",
       "type": "EnsureCNI"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:27Z",
       "lastTransitionTime": "2021-09-12T05:19:58Z",
       "status": "True",
       "type": "EnsureUpdateCISConfiguration"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:29Z",
       "lastTransitionTime": "2021-09-12T05:20:27Z",
       "status": "True",
       "type": "EnsureRenewCertsService"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:29Z",
       "lastTransitionTime": "2021-09-12T05:20:29Z",
       "status": "True",
       "type": "EnsurePostInstallHook"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:29Z",
       "lastTransitionTime": "2021-09-12T05:20:29Z",
       "status": "True",
       "type": "EnsurePostClusterInstallHook"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:29Z",
       "lastTransitionTime": "2021-09-12T05:20:29Z",
       "status": "True",
       "type": "EnsureCleanupCluster"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:29Z",
       "lastTransitionTime": "2021-09-12T05:20:29Z",
       "status": "True",
       "type": "EnsureWaitClusterModuleReady"
     },
     {
       "lastProbeTime": "2021-10-12T03:41:07Z",
       "lastTransitionTime": "2021-09-12T05:23:51Z",
       "status": "True",
       "type": "HealthCheck"
     }
   ],
   "dnsIP": "10.96.0.10",
   "nodeCIDRMaskSize": 24,
   "phase": "Running",
   "resource": {},
   "serviceCIDR": "10.96.0.0/12",
   "version": "1.21.2"
 }

返回信息

Content-Type application/json, application/yaml, application/vnd.kubernetes.protobuf

状态码: 200

OK

返回体示例

Kubernetes 集群。

{
   "addresses": [
     {
       "host": "192.168.16.53",
       "path": "",
       "port": 6443,
       "type": "Real"
     },
     {
       "host": "192.168.16.54",
       "path": "",
       "port": 6443,
       "type": "Real"
     },
     {
       "host": "192.168.16.55",
       "path": "",
       "port": 6443,
       "type": "Real"
     },
     {
       "host": "192.168.16.52",
       "path": "",
       "port": 6443,
       "type": "Advertise"
     }
   ],
   "clusterCIDR": "10.199.0.0/16",
   "conditions": [
     {
       "lastProbeTime": "2021-09-12T05:14:34Z",
       "lastTransitionTime": "2021-09-12T05:14:34Z",
       "status": "True",
       "type": "EnsureCopyFiles"
     },
     {
       "lastProbeTime": "2021-09-12T05:14:34Z",
       "lastTransitionTime": "2021-09-12T05:14:34Z",
       "status": "True",
       "type": "EnsurePreClusterInstallHook"
     },
     {
       "lastProbeTime": "2021-09-12T05:14:34Z",
       "lastTransitionTime": "2021-09-12T05:14:34Z",
       "status": "True",
       "type": "EnsurePreInstallHook"
     },
     {
       "lastProbeTime": "2021-09-12T05:14:42Z",
       "lastTransitionTime": "2021-09-12T05:14:34Z",
       "status": "True",
       "type": "EnsurePrepareNode"
     },
     {
       "lastProbeTime": "2021-09-12T05:14:42Z",
       "lastTransitionTime": "2021-09-12T05:14:42Z",
       "status": "True",
       "type": "EnsureClusterComplete"
     },
     {
       "lastProbeTime": "2021-09-12T05:15:27Z",
       "lastTransitionTime": "2021-09-12T05:14:42Z",
       "status": "True",
       "type": "EnsureContainerRuntime"
     },
     {
       "lastProbeTime": "2021-09-12T05:16:13Z",
       "lastTransitionTime": "2021-09-12T05:15:27Z",
       "status": "True",
       "type": "EnsureKubeNode"
     },
     {
       "lastProbeTime": "2021-09-12T05:16:13Z",
       "lastTransitionTime": "2021-09-12T05:16:13Z",
       "status": "True",
       "type": "EnsureNodeHostname"
     },
     {
       "lastProbeTime": "2021-09-12T05:17:09Z",
       "lastTransitionTime": "2021-09-12T05:16:13Z",
       "status": "True",
       "type": "EnsureInitMaster"
     },
     {
       "lastProbeTime": "2021-09-12T05:17:11Z",
       "lastTransitionTime": "2021-09-12T05:17:09Z",
       "status": "True",
       "type": "EnsureStoreCredential"
     },
     {
       "lastProbeTime": "2021-09-12T05:17:12Z",
       "lastTransitionTime": "2021-09-12T05:17:11Z",
       "status": "True",
       "type": "EnsureKubeconfig"
     },
     {
       "lastProbeTime": "2021-09-12T05:19:58Z",
       "lastTransitionTime": "2021-09-12T05:17:12Z",
       "status": "True",
       "type": "EnsureJoin"
     },
     {
       "lastProbeTime": "2021-09-12T05:19:58Z",
       "lastTransitionTime": "2021-09-12T05:19:58Z",
       "status": "True",
       "type": "EnsureCreateClusterMark"
     },
     {
       "lastProbeTime": "2021-09-12T05:19:58Z",
       "lastTransitionTime": "2021-09-12T05:19:58Z",
       "status": "True",
       "type": "EnsureCleanupScript"
     },
     {
       "lastProbeTime": "2021-09-12T05:19:58Z",
       "lastTransitionTime": "2021-09-12T05:19:58Z",
       "message": "Skip current condition",
       "reason": "Skip",
       "status": "True",
       "type": "EnsureCNI"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:27Z",
       "lastTransitionTime": "2021-09-12T05:19:58Z",
       "status": "True",
       "type": "EnsureUpdateCISConfiguration"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:29Z",
       "lastTransitionTime": "2021-09-12T05:20:27Z",
       "status": "True",
       "type": "EnsureRenewCertsService"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:29Z",
       "lastTransitionTime": "2021-09-12T05:20:29Z",
       "status": "True",
       "type": "EnsurePostInstallHook"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:29Z",
       "lastTransitionTime": "2021-09-12T05:20:29Z",
       "status": "True",
       "type": "EnsurePostClusterInstallHook"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:29Z",
       "lastTransitionTime": "2021-09-12T05:20:29Z",
       "status": "True",
       "type": "EnsureCleanupCluster"
     },
     {
       "lastProbeTime": "2021-09-12T05:20:29Z",
       "lastTransitionTime": "2021-09-12T05:20:29Z",
       "status": "True",
       "type": "EnsureWaitClusterModuleReady"
     },
     {
       "lastProbeTime": "2021-10-12T03:41:07Z",
       "lastTransitionTime": "2021-09-12T05:23:51Z",
       "status": "True",
       "type": "HealthCheck"
     }
   ],
   "dnsIP": "10.96.0.10",
   "nodeCIDRMaskSize": 24,
   "phase": "Running",
   "resource": {},
   "serviceCIDR": "10.96.0.0/12",
   "version": "1.21.2"
 }

返回体说明

名称 类型 描述
apiVersion string 查看公共参数
kind string 查看公共参数
metadata object 查看公共参数
spec object 集群的描述。
字段路径：spec
spec.apiServerExtraArgs object api server的扩展参数。
字段路径：spec.apiServerExtraArgs
spec.clusterCIDR string 容器网络的子网地址（CIDR 格式），例如：10.1.0.0/16，该地址应与节点子网不同。集群创建时的 Pod 可使用该网段内的 IP。
字段路径：spec.clusterCIDR
spec.clusterCredentialRef object LocalObjectReference 包含了足够多的从相同的命名空间中下载参考对象的信息。
字段路径：spec.clusterCredentialRef
clusterCredentialRef.name string 引用对象的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
字段路径：spec.clusterCredentialRef.name
spec.controllerManagerExtraArgs object Controller Manager 额外的配置参数。
字段路径：spec.controllerManagerExtraArgs
spec.displayName string 集群的显示名称。
字段路径：spec.displayName
spec.dnsDomain string DNSDomain 是被 k8s Service 使用的 DNS 域名。默认为 "cluster.local"。
字段路径：spec.dnsDomain
spec.dockerExtraArgs object Docker 额外的配置参数，将写入 /etc/sysconfig/docker，建议不要修改。通过 daemon.json 文件配置 Docker，必须以键、值的方式进行配置。
字段路径：spec.dockerExtraArgs
spec.etcd object Etcd 包含了描述 Etcd 配置的元素。
字段路径：spec.etcd
etcd.external object ExternalEtcd 描述外部 etcd 集群。Kubeadm 不知道证书文件的位置，必须提供它们。
字段路径：spec.etcd.external
external.caFile string CAFile 是一个 SSL 证书颁发机构文件，用于保护 etcd 通信。使用 TLS 连接时必须。
字段路径：spec.etcd.external.caFile
external.certFile string CertFile 是用于保障 etcd 通信安全的 SSL 证书文件。使用 TLS 连接时必须。
字段路径：spec.etcd.external.certFile
external.endpoints array ETCD 成员的端点。ExternalEtcd 所必需的。
字段路径：spec.etcd.external.endpoints
external.endpoints[] string
字段路径：spec.etcd.external.endpoints[]
external.keyFile string KeyFile 是一个 SSL 密钥文件，用于保护 etcd 通信。使用 TLS 连接时必须。
字段路径：spec.etcd.external.keyFile
etcd.local object LocalEtcd 描述了 kubeadm 应该在本地运行 etcd 集群。
字段路径：spec.etcd.local
local.dataDir string DataDir 是 etcd 存放数据的目录。默认为“/var/lib/etcd”。
字段路径：spec.etcd.local.dataDir
local.extraArgs object ExtraArgs 是在内部运行一个静态 Pod 时提供给 etcd 二进制文件的额外参数。
字段路径：spec.etcd.local.extraArgs
local.peerCertSANs array PeerCertSANs 为 etcd 对等签名证书设置额外的主题替代名称。
字段路径：spec.etcd.local.peerCertSANs
local.peerCertSANs[] string
字段路径：spec.etcd.local.peerCertSANs[]
local.serverCertSANs array ServerCertSANs 为 etcd 服务器签名证书设置额外的域名。
字段路径：spec.etcd.local.serverCertSANs
local.serverCertSANs[] string
字段路径：spec.etcd.local.serverCertSANs[]
spec.features object ClusterFeature 记录了集群启用的特性。
字段路径：spec.features
features.authzWebhookAddr object
字段路径：spec.features.authzWebhookAddr
authzWebhookAddr.builtin object
字段路径：spec.features.authzWebhookAddr.builtin
authzWebhookAddr.external object
字段路径：spec.features.authzWebhookAddr.external
external.ip string ExternalAuthzWebhookAddr 的 IP。
字段路径：spec.features.authzWebhookAddr.external.ip
external.port integer (int32) ExternalAuthzWebhookAddr 的端口。
字段路径：spec.features.authzWebhookAddr.external.port
features.csiOperator object
字段路径：spec.features.csiOperator
csiOperator.version string 版本号。
字段路径：spec.features.csiOperator.version
features.enableMasterSchedule boolean 是否允许将应用调度到控制节点上。
字段路径：spec.features.enableMasterSchedule
features.enableMetricsServer boolean 是否启用 metrics 服务。
字段路径：spec.features.enableMetricsServer
features.files array 部署节点时额外复制的文件。
字段路径：spec.features.files
features.files[] object
字段路径：spec.features.files[]
files[].dst string 目标文件，只支持常规文件。
字段路径：spec.features.files[].dst
files[].src string 源文件，仅支持常规文件。
字段路径：spec.features.files[].src
features.gpuType string GPU 类型。
字段路径：spec.features.gpuType
features.ha object
字段路径：spec.features.ha
ha.thirdParty object
字段路径：spec.features.ha.thirdParty
thirdParty.vip string 第三方 HA（Highly Available） 的虚拟 IP。
字段路径：spec.features.ha.thirdParty.vip
thirdParty.vport integer (int32) 第三方 HA（Highly Available） 的虚拟端口。
字段路径：spec.features.ha.thirdParty.vport
ha.tke object
字段路径：spec.features.ha.tke
tke.vip string 自建 HA（Highly Available） 的虚拟 IP。
字段路径：spec.features.ha.tke.vip
tke.vrid integer (int32) 自建 HA（Highly Available） 的 VRID。
字段路径：spec.features.ha.tke.vrid
features.hooks object Hook。
字段路径：spec.features.hooks
features.internalLB boolean 内部负载均衡的开关。
字段路径：spec.features.internalLB
features.ipv6DualStack boolean 是否启用 IPV4/IPV6 双栈。
字段路径：spec.features.ipv6DualStack
features.ipvs boolean Ipvs 开关。
字段路径：spec.features.ipvs
features.publicLB boolean 公共负载均衡开关。
字段路径：spec.features.publicLB
features.skipConditions array SkipConditions 是一系列需要被跳过的状态。
字段路径：spec.features.skipConditions
features.skipConditions[] string
字段路径：spec.features.skipConditions[]
features.upgrade object
字段路径：spec.features.upgrade
upgrade.mode string 升级模式，默认值为 Auto。
字段路径：spec.features.upgrade.mode
upgrade.strategy object 用于控制升级过程的策略。
字段路径：spec.features.upgrade.strategy
strategy.drainNodeBeforeUpgrade boolean 升级前是否逐出节点上的 Pod。如果你的 Pod 不能接受被逐出当前节点，这个值应该是 false。
字段路径：spec.features.upgrade.strategy.drainNodeBeforeUpgrade
strategy.maxUnready string (int-or-string) IntOrString 是一种可以保存 int32 或 string 的类型。当在 JSON 或 YAML 编组和解组中使用时，它会生成或使用内部类型。例如，这允许您拥有一个可以接受名称或数字的 JSON 字段。
字段路径：spec.features.upgrade.strategy.maxUnready
spec.finalizers array 终结器是一个内部的值列表，必须为空才能从存储中永久删除对象。
字段路径：spec.finalizers
spec.finalizers[] string
字段路径：spec.finalizers[]
spec.hostnameAsNodename boolean 如果为 true，将使用节点的 hostname 作为节点名称；如果为 false，将会使用节点 IP 作为节点名称。
字段路径：spec.hostnameAsNodename
spec.kubeletExtraArgs object Kubelet 额外的配置参数。
字段路径：spec.kubeletExtraArgs
spec.machines array 集群节点，代表集群中的控制节点。
字段路径：spec.machines
spec.machines[] object ClusterMachine 是集群的 master 节点定义。
字段路径：spec.machines[]
machines[].displayName string 显示名称。
字段路径：spec.machines[].displayName
machines[].ip string
字段路径：spec.machines[].ip
machines[].ipv6 string IPV6 地址。
字段路径：spec.machines[].ipv6
machines[].labels object
字段路径：spec.machines[].labels
machines[].networkDevice string 网络设备（网卡）名称。
字段路径：spec.machines[].networkDevice
machines[].passPhrase string (byte)
字段路径：spec.machines[].passPhrase
machines[].password string (byte)
字段路径：spec.machines[].password
machines[].port integer (int32)
字段路径：spec.machines[].port
machines[].privateKey string (byte)
字段路径：spec.machines[].privateKey
machines[].proxy object 通过 SSH 服务访问节点的代理。
字段路径：spec.machines[].proxy
proxy.address string 代理服务器的地址，例如：192.168.1.1:1080。
字段路径：spec.machines[].proxy.address
proxy.password string (byte) 访问代理服务器的密码。
字段路径：spec.machines[].proxy.password
proxy.type string 代理的类型。
字段路径：spec.machines[].proxy.type
proxy.username string 访问代理服务器的用户名。
字段路径：spec.machines[].proxy.username
machines[].publicIP string 节点的公网 IP。
字段路径：spec.machines[].publicIP
machines[].role string 节点的类型，控制节点（master）/计算节点（node）。
字段路径：spec.machines[].role
machines[].taints array 可选，节点的污点。
字段路径：spec.machines[].taints
machines[].taints[] object 污点是节点的一个属性，如果节点设置了污点后，底层的 Kubernetes 是不会将 Pod 调度到这个节点上的。
字段路径：spec.machines[].taints[]
taints[].effect string 必须。Pod 上污点的 effect，可选如下三种： NoSchedule：表示不允许调度，已调度的资源不受影响。 PreferNoSchedule：表示尽量不调度。 NoExecute：表示不允许调度，已调度的资源将在 tolerationSeconds 后删除。
字段路径：spec.machines[].taints[].effect
taints[].key string 必须。应用到节点的污点的键。
字段路径：spec.machines[].taints[].key
taints[].timeAdded string (date-time) Time 是时间的包装。Time 支持正确的封送到 YAML 和 JSON。时间包提供方的许多工厂方法都提供了包装器。
字段路径：spec.machines[].taints[].timeAdded
taints[].value string 与污点的键对应的污点的值。
字段路径：spec.machines[].taints[].value
machines[].username string
字段路径：spec.machines[].username
spec.networkArgs object 网络相关的参数。
字段路径：spec.networkArgs
spec.networkDevice string 网卡设备。
字段路径：spec.networkDevice
spec.networkType string 网络模式。
字段路径：spec.networkType
spec.properties object ClusterProperty 记录了集群的属性信息。
字段路径：spec.properties
properties.maxClusterServiceNum integer (int32) 集群最多支持的 Kubernetes Service 个数。
字段路径：spec.properties.maxClusterServiceNum
properties.maxNodePodNum integer (int32) 节点上允许调度的最大 Pod 数。
字段路径：spec.properties.maxNodePodNum
properties.oversoldRatio object 集群的超售比。
字段路径：spec.properties.oversoldRatio
spec.publicAlternativeNames array 签发到证书中的 APIServer 访问地址，只能填写 IP 或域名，最多 253 个字符。
字段路径：spec.publicAlternativeNames
spec.publicAlternativeNames[] string
字段路径：spec.publicAlternativeNames[]
spec.scalingMachines array ScalingMachines 是一组我们想要从集群中添加/删除的机器。
字段路径：spec.scalingMachines
spec.scalingMachines[] object ClusterMachine 是集群的 master 节点定义。
字段路径：spec.scalingMachines[]
scalingMachines[].displayName string 显示名称。
字段路径：spec.scalingMachines[].displayName
scalingMachines[].ip string
字段路径：spec.scalingMachines[].ip
scalingMachines[].ipv6 string IPV6 地址。
字段路径：spec.scalingMachines[].ipv6
scalingMachines[].labels object
字段路径：spec.scalingMachines[].labels
scalingMachines[].networkDevice string 网络设备（网卡）名称。
字段路径：spec.scalingMachines[].networkDevice
scalingMachines[].passPhrase string (byte)
字段路径：spec.scalingMachines[].passPhrase
scalingMachines[].password string (byte)
字段路径：spec.scalingMachines[].password
scalingMachines[].port integer (int32)
字段路径：spec.scalingMachines[].port
scalingMachines[].privateKey string (byte)
字段路径：spec.scalingMachines[].privateKey
scalingMachines[].proxy object 通过 SSH 服务访问节点的代理。
字段路径：spec.scalingMachines[].proxy
proxy.address string 代理服务器的地址，例如：192.168.1.1:1080。
字段路径：spec.scalingMachines[].proxy.address
proxy.password string (byte) 访问代理服务器的密码。
字段路径：spec.scalingMachines[].proxy.password
proxy.type string 代理的类型。
字段路径：spec.scalingMachines[].proxy.type
proxy.username string 访问代理服务器的用户名。
字段路径：spec.scalingMachines[].proxy.username
scalingMachines[].publicIP string 节点的公网 IP。
字段路径：spec.scalingMachines[].publicIP
scalingMachines[].role string 节点的类型，控制节点（master）/计算节点（node）。
字段路径：spec.scalingMachines[].role
scalingMachines[].taints array 可选，节点的污点。
字段路径：spec.scalingMachines[].taints
scalingMachines[].taints[] object 污点是节点的一个属性，如果节点设置了污点后，底层的 Kubernetes 是不会将 Pod 调度到这个节点上的。
字段路径：spec.scalingMachines[].taints[]
taints[].effect string 必须。Pod 上污点的 effect，可选如下三种： NoSchedule：表示不允许调度，已调度的资源不受影响。 PreferNoSchedule：表示尽量不调度。 NoExecute：表示不允许调度，已调度的资源将在 tolerationSeconds 后删除。
字段路径：spec.scalingMachines[].taints[].effect
taints[].key string 必须。应用到节点的污点的键。
字段路径：spec.scalingMachines[].taints[].key
taints[].timeAdded string (date-time) Time 是时间的包装。Time 支持正确的封送到 YAML 和 JSON。时间包提供方的许多工厂方法都提供了包装器。
字段路径：spec.scalingMachines[].taints[].timeAdded
taints[].value string 与污点的键对应的污点的值。
字段路径：spec.scalingMachines[].taints[].value
scalingMachines[].username string
字段路径：spec.scalingMachines[].username
spec.schedulerExtraArgs object Scheduler 额外的配置参数。
字段路径：spec.schedulerExtraArgs
spec.serviceCIDR string Kubernetes Service 的网络地址范围（CIDR 格式），例如：10.96.0.0/12，不可与 Cluster CIDR 的网段重叠。与 MaxClusterServiceNum 互斥。
字段路径：spec.serviceCIDR
spec.tenantID string 租户 ID。
字段路径：spec.tenantID
spec.type string 集群类型，自建或接入。
字段路径：spec.type
spec.version string 集群的版本。
字段路径：spec.version
status object ClusterStatus 代表集群状态的信息。
字段路径：status
status.addresses array 可到达集群的地址列表。
字段路径：status.addresses
status.addresses[] object ClusterAddress 包含了集群地址的信息。
字段路径：status.addresses[]
addresses[].host string 集群地址。
字段路径：status.addresses[].host
addresses[].path string 集群地址的 IP 地址或域名。
字段路径：status.addresses[].path
addresses[].port integer (int32) 集群地址端口号。
字段路径：status.addresses[].port
addresses[].type string 集群地址的类型，包括 Public、ExternalIP、InternalIP。
字段路径：status.addresses[].type
status.clusterCIDR string ClusterCIDR 是容器网络的子网地址（CIDR 格式），例如：10.1.0.0/16，该地址应与节点子网不同。集群创建时的 Pod 可使用该网段内的 IP。
字段路径：status.clusterCIDR
status.components array 集群组件。
字段路径：status.components
status.components[] object ClusterComponent 记录了集群 master 节点的每个组件的副本数量。
字段路径：status.components[]
components[].replicas object ClusterComponentReplicas 记录了集群 master 节点上每个组件的每个状态的副本数量。
字段路径：status.components[].replicas
replicas.available integer (int32) 集群组件副本是否可用。
字段路径：status.components[].replicas.available
replicas.current integer (int32) 当前副本数。
字段路径：status.components[].replicas.current
replicas.desired integer (int32) 期望的副本数。
字段路径：status.components[].replicas.desired
replicas.updated integer (int32) 已更新的副本数。
字段路径：status.components[].replicas.updated
components[].type string 集群组件的类型。
字段路径：status.components[].type
status.conditions array 集群的执行进度。
字段路径：status.conditions
status.conditions[] object ClusterCondition 包括该集群当前条件的详细信息。
字段路径：status.conditions[]
conditions[].lastProbeTime string (date-time) Time 是时间的包装。Time 支持正确的封送到 YAML 和 JSON。时间包提供方的许多工厂方法都提供了包装器。
字段路径：status.conditions[].lastProbeTime
conditions[].lastTransitionTime string (date-time) Time 是时间的包装。Time 支持正确的封送到 YAML 和 JSON。时间包提供方的许多工厂方法都提供了包装器。
字段路径：status.conditions[].lastTransitionTime
conditions[].message string 状态转换的详细可读信息。
字段路径：status.conditions[].message
conditions[].reason string 最后一次状态转换的原因。
字段路径：status.conditions[].reason
conditions[].status string 条件的状态，可以是 True、False、Unknown。
字段路径：status.conditions[].status
conditions[].type string 条件的类型。
字段路径：status.conditions[].type
status.dnsIP string 域名的 IP。
字段路径：status.dnsIP
status.locked boolean 集群的锁定状态。
字段路径：status.locked
status.message string 指示集群为什么在当前条件的可读详细信息。
字段路径：status.message
status.nodeCIDRMaskSize integer (int32) 节点的 CIDR 掩码大小。
字段路径：status.nodeCIDRMaskSize
status.nodeCIDRMaskSizeIPv4 integer (int32) 节点的 IPV4 的 CIDR 掩码大小。
字段路径：status.nodeCIDRMaskSizeIPv4
status.nodeCIDRMaskSizeIPv6 integer (int32) 节点的 IPV6 的 CIDR 掩码大小。
字段路径：status.nodeCIDRMaskSizeIPv6
status.phase string 集群的执行进度阶段。
字段路径：status.phase
status.reason string 指示集群为什么在当前状态的简短 CamelCase 信息。
字段路径：status.reason
status.registryIPs array 镜像仓库 IP。
字段路径：status.registryIPs
status.registryIPs[] string
字段路径：status.registryIPs[]
status.resource object ClusterResource 记录了集群的当前可用的最大资源配额信息。
字段路径：status.resource
resource.allocatable object Allocatable 表示可用于调度的集群资源。默认与 Capacity 相同。
字段路径：status.resource.allocatable
resource.allocated object Allocated 表示已分配的集群资源。
字段路径：status.resource.allocated
resource.capacity object Capacity 表示集群的资源总量。
字段路径：status.resource.capacity
status.secondaryClusterCIDR string secondaryClusterCIDR，用于双栈 IPV4/IPV6。
字段路径：status.secondaryClusterCIDR
status.secondaryServiceCIDR string secondaryServiceCIDR，用于双栈 IPV4/IPV6。
字段路径：status.secondaryServiceCIDR
status.serviceCIDR string Kubernetes Service 的网络地址范围（CIDR 格式），例如：10.96.0.0/12，不可与 Cluster CIDR 的网段重叠。与 MaxClusterServiceNum 互斥。
字段路径：status.serviceCIDR
status.version string 集群版本。
字段路径：status.version

其他状态码

状态码: 201

Created

状态码: 401

Unauthorized