差异化更新集群的状态
请求信息
请求行
PATCH /apis/platform.tkestack.io/v1/clusters/{name}/status
差异化更新指定的集群的状态。
请求行参数
| 名称 | 类型 | 是否必填项 | 描述 | 
|---|---|---|---|
| name | string | 是 | 集群的名称。 | 
请求参数
| 名称 | 类型 | 是否必填项 | 描述 | 
|---|---|---|---|
| dryRun | string | 否 | 当该参数出现时,表示不应该持久化修改。一个无效的或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:All,将处理所有的试运行阶段。 | 
| fieldManager | string | 否 | fieldManager 是与进行这些更改的角色或实体相关联的名称。 该值必须少于或少于 128 个字符,并且只能包含可打印的字符。 | 
| force | boolean | 否 | Force 将“强制”应用请求。 这意味着用户将重新获取其他人拥有的冲突字段。 对于未应用的 PATCH 请求,必须取消设置强制标志。 | 
| pretty | string | 否 | 如果为 true,则会将返回结果输出成适合打印的格式。 | 
请求体
Content-Type 
                application/json-patch+json,
                application/merge-patch+json,
                application/strategic-merge-patch+json,
                application/apply-patch+yaml
请求体示例
Patch 方法,为了给 Kubernetes Patch 请求体一个具体的名称和类型。
{
   "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 |