# 集群移出容器舰队 - LeaveGroup #### 功能介绍 集群移出容器舰队 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ucs/ucs_api_0026.html)。 #### URI POST /v1/clusters/{clusterid}/unjoin 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | clusterid | 是 | String | 集群id | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 否 | String | 身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | kind | String | API类型，固定值"Cluster"，该值不可修改。 | | apiVersion | String | API版本，固定值"v1"，该值不可修改。 | | metadata | [ObjectMeta] object | 集群的基本信息，为集合类的元素类型，包含一组由不同名称定义的属性。 | | spec | [ClusterSpec] object | spec是集合类的元素类型，您对需要管理的集群对象进行详细描述的主体部分都在spec中给出。UCS通过spec的描述来创建或更新对象。 | | status | [ClusterStatus] object | 集合类的元素类型，用于记录对象在系统中的当前状态信息。 | 表4ObjectMeta | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 用于定义对象间所有权关系，管理对象的依赖关系和垃圾回收机制，支持控制器对资源的管理 | 表5ManagedFieldsEntry | 参数 | 参数类型 | 描述 | |:---|:---|:---| | manager | String | 管理者的名称 | | operation | String | 记录导致此条目创建的操作类型，只能是 Apply 或 Update 两种操作类型 | | apiVersion | String | 该管理者定义字段时所依据的资源 API 版本 | | time | String | 此管理条目被创建或最后一次更新的时间戳 | | fieldsType | String | 固定为 "FieldsV1"，标记字段结构格式 | | fieldsV1 | Object | 用于存储实际被管理的字段信息 | 表6OwnerReference | 参数 | 参数类型 | 描述 | |:---|:---|:---| | apiVersion | String | 标识引用对象的API版本 | | kind | String | 引用对象的类型 | | name | String | 引用对象的名称 | | uid | String | 引用对象的uid | | controller | Boolean | 如果为true，表示该引用指向管理该资源的控制器 | | blockOwnerDeletion | Boolean | 当为true且拥有者有名为"foregroundDeletion"的finalizer 时，会阻止拥有者被删除，直到这个引用被移除 | 表7ClusterSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | syncMode | String | 集群和karmada控制面之间的同步模式 | | clusterGroupID | String | 容器舰队id | | manageType | String | 集群类型，取值如下： - grouped：在舰队中纳管的集群 - discrete：未加入舰队的集群 | | ruleNamespaces | Array of [RuleNamespace] objects | 集群包含的RuleNamespace列表 | | apiEndpoint | String | apiserver地址 | | secretRef | [LocalSecretReference] object | 访问集群的secret信息 | | insecureSkipTLSVerification | Boolean | 是否跳过https校验 | | proxyURL | String | 代理链接 | | provider | String | 提供商 | | type | String | 集群类型： - 华为云：cce、turbo、turbopro - 伙伴云：ctc、cmc - 本地集群：baremetal、vmware、agile - 附着集群：ack、aks、eks、gke、tke、openshift、privatek8s | | category | String | 集群类别： - self：华为云集群 - partnercloud：伙伴云集群 - onpremise：本地集群 - attachedcluster：附着集群 | | enableDistMgt | Boolean | CCE Turbo集群是否支持管理边缘基础设施。 | | region | String | 区域 | | country | String | 国家 | | city | String | 城市 | | projectID | String | 项目id | | projectName | String | 项目名 | | zone | String | 地区 | | taints | Array of [Taint] objects | 污点 | | IsDownloadedCert | Boolean | 是否已经下载过证书 | | policyId | String | 策略管理id | | operatorNamespace | String | 集群所属domainID | | connectProxyEndpoints | Array of [ConnectEndpoint] objects | 连接代理服务器的终端节点服务ID列表，仅非华为云集群返回该字段 | 表8RuleNamespace | 参数 | 参数类型 | 描述 | |:---|:---|:---| | rules | Array of [RuleInfo] objects | 权限策略列表 | | namespaces | Array of strings | 命名空间列表 | 表9RuleInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | ruleID | String | 权限策略id | | ruleName | String | 权限策略名字 | 表10LocalSecretReference | 参数 | 参数类型 | 描述 | |:---|:---|:---| | namespace | String | 资源的命名空间 | | name | String | 资源名称 | 表11Taint | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | 键 | | value | String | 值 | | effect | String | effect信息 | | timeadded | String | 时间戳信息 | 表12ConnectEndpoint | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | 取值：当前仅支持 VPCEP | | name | String | 资源名称，当type是VPCEP时为VPCEP Service的名称 | | id | String | 资源id，当type是VPCEP时为VPCEP Service的id | | region | String | 资源所在的region | 表13ClusterStatus | 参数 | 参数类型 | 描述 | |:---|:---|:---| | kubernetesVersion | String | kubernetes版本 | | conditions | Array of [ConditionStatus] objects | conditions信息 | | nodeSummary | [NodeSummary] object | 节点统计信息 | | resourceSummary | [ResourceSummary] object | 资源统计信息 | | endpoints | Array of [Endpoint] objects | 端点 | | phase | String | 阶段状态信息 | | reason | String | 表述上次状况变化的原因 | | message | String | 上次状态转换的详细信息 | | arrearFreeze | String | 欠费冻结 | | policeFreeze | String | 公安冻结 | | apiEnablements | Array of [APIEnablement] objects | 开启的资源列表 | 表14ConditionStatus | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | 状态类型： - Ready，表示集群是否可用 - Cluster，表示集群的网络连接状态 - Federation，表示集群的联邦状态 | | status | String | 集群状态： - Ready类型： - True：集群已就绪，状态健康并且准备好接收工作负载 - False：集群未就绪 - Cluster类型： - Initializing：集群正在初始化 - Failed：集群初始化失败，包括集群注册超时或集群版本不支持 - Available：集群已成功初始化并可用 - Unavailable：集群不可用 - Unjoining：集群正在移出舰队 - UnjoinFailed：集群移出舰队失败 - UnjoinSuccess：集群移出舰队成功 - Unregistering：集群注销中 - UnregisterFailed：集群注销失败 - Federation类型： - Federalized：集群已加入联邦 - Federalizing：集群正在加入联邦 - Failed：集群加入联邦失败 - Removing：集群正在移出联邦 - Abnormal：集群在联邦中状态异常 | | observedgeneration | Integer | 状态对象的版本 | | lastTransitionTime | String | 上次状态更新的时间 | | reason | String | 状态原因 | | message | String | 状态信息 | 表15NodeSummary | 参数 | 参数类型 | 描述 | |:---|:---|:---| | totalNum | Integer | 集群中所有节点的个数。 | | readyNum | Integer | 集群中已就绪节点的数量。 | 表16ResourceSummary | 参数 | 参数类型 | 描述 | |:---|:---|:---| | allocatable | Map\ | 可分配的资源 | | allocating | Map\ | 分配中的资源 | | allocated | Map\ | 已分配的资源 | | capacity | Map\ | 资源总量 | 表17Endpoint | 参数 | 参数类型 | 描述 | |:---|:---|:---| | url | String | 端口URL地址 | | type | String | 端口类型 | | status | String | 端口状态信息 | 表18APIEnablement | 参数 | 参数类型 | 描述 | |:---|:---|:---| | groupVersion | String | 资源组版本 | | resources | Array of [APIResource] objects | 资源类型、名称 | 表19APIResource | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 资源名 | | kind | String | 资源类别 | **状态码：400** 表20响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | String | - | **状态码：403** 表21响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | String | - | **状态码：404** 表22响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | String | - | **状态码：500** 表23响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | String | - | #### 请求示例 集群移出容器舰队 ``` POST https://ucs.myhuaweicloud.com/v1/clusters/{clusterid}/unjoin ``` #### 响应示例 **状态码：200** 集群移出容器舰队成功 ``` { "kind" : "Cluster", "apiVersion" : "v1", "metadata" : { "name" : "test11111", "uid" : "6cbb5b34-7c14-4402-be57-86c564aac4db", "creationTimestamp" : "2026-06-10T07:09:06Z", "annotations" : { "vpcId" : "" } }, "spec" : { "syncMode" : "Push", "manageType" : "discrete", "apiEndpoint" : "https://10.0.0.37:5443", "provider" : "huaweicloud", "type" : "agile", "category" : "onpremise", "country" : "CN", "city" : "120000", "IsDownloadedCert" : false, "operatorNamespace" : "05495693d180d3c90f9ec0171879f760", "connectProxyEndpoints" : [ { "type" : "VPCEP", "name" : "cn-north-7.open-vpcep.06f87620-9b54-4188-aec0-4b63bff3f66a", "id" : "06f87620-9b54-4188-aec0-4b63bff3f66a", "region" : "cn-north-7" } ] }, "status" : { "conditions" : [ { "type" : "Ready", "status" : "False", "lastTransitionTime" : "2026-06-10T15:09:06.271143+08:00", "reason" : "Initializing" }, { "type" : "Cluster", "status" : "Initializing", "lastTransitionTime" : "2026-06-10T15:09:06.271143+08:00", "reason" : "ClusterInitializing" } ], "phase" : "Initializing", "arrearFreeze" : "false", "policeFreeze" : "false" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 集群移出容器舰队成功 | | 400 | 客户端请求错误，服务器无法执行请求 | | 403 | 服务器拒绝执行请求 | | 404 | 资源不存在 | | 500 | 服务器内部错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ucs/ErrorCode.html)。