# 更新容器舰队的联邦对应的zone - UpdateClusterGroupAssociatedZones #### 功能介绍 更新容器舰队的集群联邦关联的zone #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ucs/ucs_api_0026.html)。 #### URI PUT /v1/clustergroups/{clustergroupid}/associatedzones 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | clustergroupid | 是 | String | 容器舰队id | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 否 | String | 身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值 | | Content-Type | 是 | String | 消息体的类型（格式），仅支持application/json | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dnsSuffix | 否 | Array of strings | 在联邦管理的域名访问功能中，用于更改根域名 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | kind | String | API类型，固定值"ClusterGroup"，该值不可修改。 | | apiVersion | String | API版本，固定值"v1"，该值不可修改。 | | metadata | [ObjectMeta] object | 舰队的基本信息，为集合类的元素类型，包含一组由不同名称定义的属性。 | | spec | [ClusterGroupSpec] object | spec是集合类的元素类型，您对需要管理的对象进行详细描述的主体部分都在spec中给出。UCS通过spec的描述来创建或更新对象。 | | status | [ClusterGroupStatus] object | 运行状态信息。集合类的元素类型，用于记录对象在系统中的当前运行状态相关信息。 | 表5ObjectMeta | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uid | String | 资源ID | | name | String | 资源名称 | | generateName | String | 当未提供name时，服务器使用的前缀来生成唯一名称 | | namespace | String | 命名空间 | | labels | Map\ | 标签 | | annotations | Map\ | 注解 | | creationTimestamp | String | 创建时间 | | updateTimestamp | String | 更新时间 | | resourceVersion | String | 资源内部版本 | | generation | Integer | 资源期望状态的代数 | | managedFields | Array of [ManagedFieldsEntry] objects | 记录哪些字段由哪些工作流管理 | | ownerReferences | Array of [OwnerReference] objects | 用于定义对象间所有权关系，管理对象的依赖关系和垃圾回收机制，支持控制器对资源的管理 | 表6ManagedFieldsEntry | 参数 | 参数类型 | 描述 | |:---|:---|:---| | manager | String | 管理者的名称 | | operation | String | 记录导致此条目创建的操作类型，只能是 Apply 或 Update 两种操作类型 | | apiVersion | String | 该管理者定义字段时所依据的资源 API 版本 | | time | String | 此管理条目被创建或最后一次更新的时间戳 | | fieldsType | String | 固定为 "FieldsV1"，标记字段结构格式 | | fieldsV1 | Object | 用于存储实际被管理的字段信息 | 表7OwnerReference | 参数 | 参数类型 | 描述 | |:---|:---|:---| | apiVersion | String | 标识引用对象的API版本 | | kind | String | 引用对象的类型 | | name | String | 引用对象的名称 | | uid | String | 引用对象的uid | | controller | Boolean | 如果为true，表示该引用指向管理该资源的控制器 | | blockOwnerDeletion | Boolean | 当为true且拥有者有名为"foregroundDeletion"的finalizer 时，会阻止拥有者被删除，直到这个引用被移除 | 表8ClusterGroupSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 集群联邦连接网关节点列表，仅当舰队开启集群联邦时有值 | 表9ConnectEndpoint | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | 取值：当前仅支持 VPCEP | | name | String | 资源名称，当type是VPCEP时为VPCEP Service的名称 | | id | String | 资源id，当type是VPCEP时为VPCEP Service的id | | region | String | 资源所在的region | 表10ClusterGroupStatus | 参数 | 参数类型 | 描述 | |:---|:---|:---| | conditions | Array of [ClusterGroupCondition] objects | 舰队启用联邦或权限策略信息 | 表11ClusterGroupCondition | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | - | **状态码：500** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | String | - | #### 请求示例 更新容器舰队的联邦对应的zone ``` POST https://ucs.myhuaweicloud.com/v1/clustergroups/{clustergroupid}/associatedzones { "dnsSuffix" : [ "wpwebsite.com" ] } ``` #### 响应示例 **状态码：200** 更新成功 ``` { "kind" : "ClusterGroup", "apiVersion" : "v1", "metadata" : { "name" : "test", "uid" : "11ef720d-aa89-4f65-84a6-6e6b3468b19e", "creationTimestamp" : "2025-12-18 15:24:04.855513 +0000 UTC", "updateTimestamp" : "2026-04-07 07:21:53.619909 +0000 UTC" }, "spec" : { "federationId" : "3851d65d-1975-4ed4-a36a-6b8ae9e6c7c7", "federationVersion" : "v1.10.7-t0327", "dnsSuffix" : [ "wpwebsite.com" ] }, "status" : { } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 更新成功 | | 400 | 客户端请求错误，服务器无法执行请求 | | 500 | 服务器内部错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ucs/ErrorCode.html)。