更新时间:2024-04-30 GMT+08:00

更新集群

功能介绍

更新集群。当前仅允许更新附着集群和本地集群的国家/城市,允许更新多云集群的工作节点个数。

URI

PUT /v1/clusters/{clusterid}

表1 路径参数

参数

是否必选

参数类型

描述

clusterid

String

集群ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

身份认证信息

最小长度:1

最大长度:16384

表3 请求Body参数

参数

是否必选

参数类型

描述

kind

String

API类型,固定值“Cluster”,该值不可修改。

apiVersion

String

API版本,固定值“v1”,该值不可修改。

metadata

ObjectMeta object

集群的基本信息,为集合类的元素类型,包含一组由不同名称定义的属性。

spec

UpdateClusterSpec object

spec是集合类的元素类型,您对需要管理的集群对象进行详细描述的主体部分都在spec中给出。UCS通过spec的描述来创建或更新对象。

表4 ObjectMeta

参数

是否必选

参数类型

描述

uid

String

集群ID

name

String

集群名称。

labels

Map<String,String>

标签

creationTimestamp

String

创建时间。它以 RFC3339 形式表示,采用 UTC。

updateTimestamp

String

更新时间戳

表5 UpdateClusterSpec

参数

是否必选

参数类型

描述

country

String

集群所在国家信息

city

String

集群所在城市信息

workerConfig

WorkerConfig object

工作节点配置,仅支持多云集群

表6 WorkerConfig

参数

是否必选

参数类型

描述

replicas

Integer

节点个数

strategy

NodeUpgradeStrategy object

节点更新策略

表7 NodeUpgradeStrategy

参数

是否必选

参数类型

描述

type

String

策略类型

rollingUpdate

RollingUpdateNodeUpgradeStrategy object

滚动更新

表8 RollingUpdateNodeUpgradeStrategy

参数

是否必选

参数类型

描述

maxUnavailable

Object

最大不可用个数

maxSurge

Object

允许超出期望的最大个数

deletePolicy

String

删除策略:Random、Oldest、Newest

响应参数

请求示例

更新集群区域

PUT https://ucs.myhuaweicloud.com/v1/clusters/{clusterid}

{
  "kind" : "Cluster",
  "apiVersion" : "v1",
  "metadata" : {
    "annotations" : {
      "kubeconfig" : "{\"kind\":\"Config\",\"apiVersion\":\"v1\",\"preferences\":{},\"clusters\":[{\"name\":\"internalCluster\",\"cluster\":{\"server\":\"https://100.94.13.93:5443\",\"insecure-skip-tls-verify\":true}}],\"users\":[{\"name\":\"user\",\"user\":{\"client-certificate-data\":\"\",\"client-key-data\":\"\"}}],\"contexts\":[{\"name\":\"internal\",\"context\":{\"cluster\":\"internalCluster\",\"user\":\"user\"}}],\"current-context\":\"internal\"}"
    }
  },
  "spec" : {
    "country" : "AL",
    "city" : "AL"
  }
}

响应示例

状态码

状态码

描述

200

集群信息更新成功

400

客户端请求错误,服务器无法执行请求

403

服务器拒绝执行请求

500

服务器内部错误

错误码

请参见错误码