全部文档
当前文档
最近更新时间：2026-10-14 10:27:54
本文介绍容器服务1.0集群标签注入功能，包括标签键值规则、支持的资源范围、特殊场景及组件生效方式。通过本文，您可以了解如何为集群及其关联云资源统一注入标签，并参考操作步骤完成存量标签补全，满足费用分账与资源筛选需求。
KCE 容器服务1.0支持自动为集群及其关联云资源注入统一标签：标签键为 KCE_ClusterId，标签值为该资源所属集群的集群 ID。您可以在标签管理页面中查看并管理标签，并基于该标签进行费用分账与资源筛选。
集群创建使用的 KEC、EPC、EBS 等资源会添加集群标签，详见资源范围。
标签键统一为 KCE_ClusterId，标签值为对应集群的 ID。
对于多集群共享的特殊资源如LB和Klog，由容器服务新创建的资源会绑定集群标签、使用已有资源则不绑定标签。
支持注入资源标签的类型如下：
KEC 云服务器实例
EPC 裸金属服务器实例
EBS 云硬盘
LB 负载均衡
EIP 弹性 IP
Klog 日志池
KCE 容器集群
特殊场景：
添加节点实例：添加云服务器和裸金属服务器节点，在新建实例和添加已有实例两种场景均会打标签。
EIP 弹性 IP：集群 APIServer 开启公网访问时绑定的弹性 EIP 会绑定集群标签；用户为节点自行绑定 EIP 的场景，不会自动注入标签。
KCE 平台新建资源默认注入集群标签Tag，已创建的存量资源（存量资源指在2026年10月13日19:00时前创建的资源）补齐集群标签需要提交工单提供用户 ID、集群 ID 和机房信息并对接执行存量更新。
此外，注意相关组件需要升级、组件的生效方式如下：
组件 | 生效方式 | 组件版本 | 操作说明 |
ebs-csi | 升级组件后，新增资源默认同步；存量补 tag 需通过命令行参数控制开关 | ebs-csi 1.0.6 | 暂未开放控制台升级，如需请提交工单操作 |
VPC-CNI | 升级组件后，新增和存量默认同步 | VPC-CNI 1.5.17 | 新建集群和已有集群安装组件、存量集群低版本升级可通过控制台操作（路径详见组件生命周期管理） |
CCM | 升级组件后，新增资源默认同步；存量补 tag 需通过环境参数控制开关 | / | 暂未开放控制台升级，如需请提交工单操作升级； 存量 SLB 通过环境变量 |
CSI 存量云硬盘补 tag 操作
存量云硬盘补 tag 通过命令行参数控制开关，操作步骤如下：
执行以下命令编辑 CSI 部署：
kubectl edit deployment csi-ebs-controller -n kube-system2. 找到 csi-ebsplugin 容器的 args 段，将 --enable-cluster-tag-backfill 由 false 改成 true：
- name: csi-ebsplugin
image: ...
args:
- --endpoint=$(CSI_ENDPOINT)
- --driver=com.ksc.csi.diskplugin
- --enable-cluster-tag=true
- --enable-cluster-tag-backfill=false # ← 把 false 改成 true标签配额默认限制如下：
每个用户最多 1000 个标签键；
每个标签键最多 100 个标签值；
每个资源最多可以有 20 个不同的标签键。
集群标签会占用一个标签 key 额度（
KCE_ClusterId）。此标签 key 下占用的标签值额度为用户账号下的集群数量。用户可在标签管理页面中查看并管理标签。请关注资源标签使用情况，超配额会导致绑定标签失败。如需提升配额，请联系资源管理平台。
纯净模式