更新集群 - UpdateCluster
功能介绍
更新集群。当前仅允许更新附着集群和本地集群的国家/城市，允许更新多云集群的工作节点个数。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
PUT /v1/clusters/{clusterid}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
clusterid |
是 |
String |
集群ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
身份认证信息 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
kind |
是 |
String |
API类型，固定值“Cluster”，该值不可修改。 |
|
apiVersion |
是 |
String |
API版本，固定值“v1”，该值不可修改。 |
|
metadata |
否 |
UpdateObjectMeta object |
集群的基本信息，为集合类的元素类型，包含一组由不同名称定义的属性。 |
|
spec |
否 |
UpdateClusterSpec object |
spec是集合类的元素类型，您对需要管理的集群对象进行详细描述的主体部分都在spec中给出。UCS通过spec的描述来创建或更新对象。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
country |
否 |
String |
集群所在国家信息 |
|
city |
否 |
String |
集群所在城市信息 |
|
workerConfig |
否 |
WorkerConfig object |
工作节点配置，仅支持多云集群 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
replicas |
否 |
Integer |
节点个数 |
|
strategy |
否 |
NodeUpgradeStrategy object |
节点更新策略 |
响应参数
状态码：200
集群信息更新成功
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
- |
String |
- |
状态码：403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
- |
String |
- |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
- |
String |
- |
请求示例
更新集群区域
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://ip: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
集群信息更新成功
{ }
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
集群信息更新成功 |
|
400 |
客户端请求错误，服务器无法执行请求 |
|
403 |
服务器拒绝执行请求 |
|
500 |
服务器内部错误 |
错误码
请参见错误码。
