更新集群
功能介绍
更新集群。当前仅允许更新附着集群和本地集群的国家/城市，允许更新多云集群的工作节点个数。
URI
PUT /v1/clusters/{clusterid}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
clusterid |
是 |
String |
集群ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
身份认证信息 最小长度：1 最大长度：16384 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
kind |
是 |
String |
API类型，固定值“Cluster”，该值不可修改。 |
|
apiVersion |
是 |
String |
API版本，固定值“v1”，该值不可修改。 |
|
metadata |
否 |
ObjectMeta object |
集群的基本信息，为集合类的元素类型，包含一组由不同名称定义的属性。 |
|
spec |
否 |
UpdateClusterSpec object |
spec是集合类的元素类型，您对需要管理的集群对象进行详细描述的主体部分都在spec中给出。UCS通过spec的描述来创建或更新对象。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
uid |
否 |
String |
集群ID |
|
name |
否 |
String |
集群名称。 |
|
labels |
否 |
Map<String,String> |
标签 |
|
creationTimestamp |
否 |
String |
创建时间。它以 RFC3339 形式表示，采用 UTC。 |
|
updateTimestamp |
否 |
String |
更新时间戳 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
country |
否 |
String |
集群所在国家信息 |
|
city |
否 |
String |
集群所在城市信息 |
|
workerConfig |
否 |
WorkerConfig object |
工作节点配置，仅支持多云集群 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
replicas |
否 |
Integer |
节点个数 |
|
strategy |
否 |
NodeUpgradeStrategy object |
节点更新策略 |
响应参数
无
请求示例
更新集群区域
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 |
服务器内部错误 |
错误码
请参见错误码。
