文档首页/ 华为云UCS/ API参考/ API/ 容器舰队/ 更新容器舰队描述信息 - UpdateClusterGroup
更新时间：2026-06-30 GMT+08:00
查看PDF
分享

更新容器舰队描述信息 - UpdateClusterGroup

功能介绍

更新集群所属的容器舰队description信息；需要用户对相应容器舰队有更新权限

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

PUT /v1/clustergroups/{clustergroupid}/description

表1 路径参数

参数

是否必选

参数类型

描述

clustergroupid

是

String

容器舰队ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值

Content-Type

是

String

消息体的类型（格式），仅支持application/json
表3 请求Body参数

参数

是否必选

参数类型

描述

description

是

String

容器舰队描述信息

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

kind

String

API类型，固定值"ClusterGroup"，该值不可修改。

apiVersion

String

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

metadata

ObjectMeta object

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

spec

ClusterGroupSpec object

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

status

ClusterGroupStatus object

运行状态信息。集合类的元素类型，用于记录对象在系统中的当前运行状态相关信息。
表5 ObjectMeta

参数

参数类型

描述

uid

String

资源ID

name

String

资源名称

generateName

String

当未提供name时，服务器使用的前缀来生成唯一名称

namespace

String

命名空间

labels

Map<String,String>

标签

annotations

Map<String,String>

注解

creationTimestamp

String

创建时间

updateTimestamp

String

更新时间

resourceVersion

String

资源内部版本

generation

Integer

资源期望状态的代数

managedFields

Array of ManagedFieldsEntry objects

记录哪些字段由哪些工作流管理

ownerReferences

Array of OwnerReference objects

用于定义对象间所有权关系，管理对象的依赖关系和垃圾回收机制，支持控制器对资源的管理
表6 ManagedFieldsEntry

参数

参数类型

描述

manager

String

管理者的名称

operation

String

记录导致此条目创建的操作类型，只能是 Apply 或 Update 两种操作类型

apiVersion

String

该管理者定义字段时所依据的资源 API 版本

time

String

此管理条目被创建或最后一次更新的时间戳

fieldsType

String

固定为 "FieldsV1"，标记字段结构格式

fieldsV1

Object

用于存储实际被管理的字段信息
表7 OwnerReference

参数

参数类型

描述

apiVersion

String

标识引用对象的API版本

kind

String

引用对象的类型

name

String

引用对象的名称

uid

String

引用对象的uid

controller

Boolean

如果为true，表示该引用指向管理该资源的控制器

blockOwnerDeletion

Boolean

当为true且拥有者有名为"foregroundDeletion"的finalizer 时，会阻止拥有者被删除，直到这个引用被移除
表8 ClusterGroupSpec

参数

参数类型

描述

ruleNamespaces

Array of strings

权限策略关联的命名空间列表

federationId

String

舰队启用联邦ID

description

String

描述信息

dnsSuffix

Array of strings

舰队对应联邦的DNS后缀，开启联邦后可见

federationExpirationTimestamp

String

联邦到期时间戳

policyId

String

策略管理id

federationVersion

String

舰队启用联邦的版本

connectGatewayEndpoints

Array of ConnectEndpoint objects

集群联邦连接网关节点列表，仅当舰队开启集群联邦时有值
表9 ConnectEndpoint

参数

参数类型

描述

type

String

取值：当前仅支持 VPCEP

name

String

资源名称，当type是VPCEP时为VPCEP Service的名称

id

String

资源id，当type是VPCEP时为VPCEP Service的id

region

String

资源所在的region
表10 ClusterGroupStatus

参数

参数类型

描述

conditions

Array of ClusterGroupCondition objects

舰队启用联邦或权限策略信息
表11 ClusterGroupCondition

参数

参数类型

描述

type

String

舰队启用联邦或权限策略的类型：

  • Federation：舰队启用联邦状态类型

  • FedClusterConnection：联邦集群连接状态类型

  • Policy：权限策略类型"

status

String

舰队启用的联邦或权限策略的状态

  • 联邦状态：

    • Creating：联邦正在创建中

    • CreateFailed：联邦创建失败

    • Available：联邦已创建并可用

    • Connecting：集群正在加入联邦

    • Connected：集群已加入联邦

    • Unavailable：联邦不可用

    • Failed：联邦开启失败

    • Deleting：联邦正在关闭

    • DeleteFailed：联邦关闭失败

    • Upgrading：联邦正在升级

    • UpgradeFailed：联邦升级失败

    • Rollback：联邦版本正在回滚

    • RollbackFailed：联邦版本回滚失败

    • Freezed：联邦已被冻结

    • Freezing：联邦冻结中

    • UnFreezing：联邦解冻中

  • 联邦权限策略状态：

    • Running：策略管理运行中

    • Abnormal：策略管理状态异常

    • Reconciling：策略管理调和中

    • ReconcileFailed：策略管理调和失败

    • Closing：策略管理功能关闭中

reason

String

状态原因

message

String

状态信息

lastTransitionTime

String

状态更新时间

状态码：400

表12 响应Body参数

参数

参数类型

描述

-

String

-

状态码：403

表13 响应Body参数

参数

参数类型

描述

-

String

-

状态码：404

表14 响应Body参数

参数

参数类型

描述

-

String

-

状态码：500

表15 响应Body参数

参数

参数类型

描述

-

String

-

请求示例

更新容器舰队的描述信息

PUT https://ucs.myhuaweicloud.com/v1/clustergroups/{clustergroupid}/description

{
  "description" : "aaaaaaaaa"
}

响应示例

状态码：200

更新成功

{
  "kind" : "ClusterGroup",
  "apiVersion" : "v1",
  "metadata" : {
    "name" : "zhc-test",
    "uid" : "039aa474-d4ab-4796-947f-88e7aa40e027",
    "creationTimestamp" : "2025-05-23 07:31:58.424696 +0000 UTC",
    "updateTimestamp" : "2026-06-10 08:36:09.005996 +0000 UTC"
  },
  "spec" : {
    "description" : "aaaaaaaaa"
  },
  "status" : { }
}

状态码

状态码

描述

200

更新成功

400

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

403

服务器拒绝执行请求

404

资源不存在

500

服务器内部错误

错误码

请参见错误码。

父主题： 容器舰队