如何通过kubectl查询K8s资源所属API组及解析apiVersion含义

先明确你的疑问： #

kubectl api-resources返回的APIVERSION列（比如apps/v1）里，API组是斜杠左侧的apps，右侧的v1是该API组下的具体版本。在RBAC的Role/ClusterRole配置中，apiGroups字段只需要填写这个左侧的组名，不需要带版本。

通用查询指定资源API组的方法： #

• 方法1：用kubectl api-resources精准过滤
  直接过滤目标资源，从输出的APIVERSION列提取组名：

# 查询deployment的API信息
kubectl api-resources | grep -i deployment

输出示例：

deployments                       deploy       apps/v1                       true         Deployment

这里apps/v1的apps就是API组。如果是pod、service这类核心资源，APIVERSION会显示v1（无斜杠），它们的API组是空字符串""（RBAC配置时可以填""或"core"，效果一致）。

• 方法2：用kubectl explain查看资源元信息
  通过explain命令直接查看资源的API组和版本：

kubectl explain deployment

输出开头会显示：

KIND:     Deployment
VERSION:  apps/v1

这里的apps就是该资源所属的API组。

• 方法3：查看API资源的完整定义（进阶）
  通过Kubernetes API的原始端点获取资源的完整配置，直接读取group字段：

# 需要jq工具格式化输出，没有的话可以去掉|之后的部分
kubectl get --raw /apis/apps/v1 | jq '.resources[] | select(.name=="deployments")'

返回结果里的group字段会明确显示apps，version字段显示v1。

举个RBAC配置的例子： #

如果要给Role添加deployment的操作权限，正确的配置应该是：

apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: deployment-ops
rules:
- apiGroups: ["apps"]  # 这里填写API组名apps
  resources: ["deployments", "deployments/scale"]
  verbs: ["get", "list", "update", "delete"]

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