如何通过Python API为Google Kubernetes Engine集群工作负载添加/更新标签

首先明确核心混淆点：你现在调用的是GCP云资源管理API，作用是给GKE集群这个云资源打云平台层面的标签，多用于GCP账单拆分、权限管控等场景，和Kubernetes集群内部工作负载的标签是完全独立的两套体系。你的最终需求是修改集群内的工作负载标签，应该用Kubernetes Python客户端直接操作集群API，不需要调用GCP的container API。

以下是你现有代码报错的原因：

1. 第一个报错Unknown name "labels": Cannot find field：GKE设置集群资源标签的接口请求体要求的顶层字段是resource_labels而非labels，同时必须传入label_fingerprint字段做并发控制，不能省略。
2. 第二个报错除了字段值格式错误（resource_labels要求是键值对字典，你传了字符串value）之外，你使用的projectId/zone/clusterId三个参数已经被官方废弃，导致请求路径里三个参数为空，接口无法定位目标集群。

场景1：修改GKE集群本身的云平台标签（若你确实需要该操作） #

正确实现代码如下：

from google.oauth2 import service_account
from googleapiclient import discovery
import pprint

credentials = service_account.Credentials.get_application_default()
service = discovery.build('container', 'v1', credentials=credentials)

# 用新版name参数替代废弃的三个参数，格式为projects/{项目ID}/locations/{区域}/clusters/{集群名}
cluster_name = "projects/testingproject/locations/us-east1/clusters/testing-cluster"

# 先调用get接口获取当前的label_fingerprint，每次更新必须传入最新的指纹做并发校验
cluster_info = service.projects().locations().clusters().get(name=cluster_name).execute()
current_fingerprint = cluster_info['labelFingerprint']

# 构造请求体，resource_labels是你要设置的所有标签的键值对
set_labels_body = {
    "resource_labels": {
        "自定义标签键1": "标签值1",
        "自定义标签键2": "标签值2"
    },
    "label_fingerprint": current_fingerprint
}

request = service.projects().locations().clusters().setLabels(name=cluster_name, body=set_labels_body)
response = request.execute()
pprint(response)

场景2：修改GKE集群内部的工作负载标签（你的最终需求） #

不需要调用GCP的API，直接使用Kubernetes Python客户端操作即可：
首先安装依赖：
pip install kubernetes google-auth

实现代码：

from kubernetes import client, config
import google.auth
from google.auth.transport.requests import Request

# 用GCP凭证登录GKE集群
credentials, project_id = google.auth.default(scopes=['https://www.googleapis.com/auth/cloud-platform'])
auth_req = Request()
credentials.refresh(auth_req)

# 配置K8s客户端
configuration = client.Configuration()
configuration.host = "https://你的GKE集群endpoint地址" # 可在GKE集群详情页获取该地址
configuration.api_key_prefix['authorization'] = 'Bearer'
configuration.api_key['authorization'] = credentials.token
# 私有集群可根据实际情况配置SSL校验，测试场景可临时关闭校验
configuration.verify_ssl = False

client.Configuration.set_default(configuration)
v1_apps = client.AppsV1Api()

# 假设你要修改的是Deployment类型的工作负载，命名空间根据实际情况调整
namespace = "default"
workload_name = "matei-testing-2000-gke-ops"

# 获取当前工作负载配置
current_deployment = v1_apps.read_namespaced_deployment(name=workload_name, namespace=namespace)
# 若要修改Pod模板的标签修改spec.template.metadata.labels，若要修改Deployment本身的标签修改metadata.labels即可
current_deployment.spec.template.metadata.labels["自定义新标签键"] = "新标签值"

# 提交更新
api_response = v1_apps.patch_namespaced_deployment(
    name=workload_name,
    namespace=namespace,
    body=current_deployment
)
print(f"工作负载标签更新成功，资源版本：{api_response.metadata.resource_version}")

提示：如果你的工作负载是StatefulSet、DaemonSet等其他类型，替换对应的API方法即可，更新逻辑和上述Deployment的逻辑完全一致。

内容的提问来源于stack exchange，提问作者happymatei