你正在查看的文档所针对的是 Kubernetes 版本： v1.31
Kubernetes v1.31 版本的文档已不再维护。你现在看到的版本来自于一份静态的快照。如需查阅最新文档，请点击 最新版本。
字段选择器
“字段选择器（Field selectors）”允许你根据一个或多个资源字段的值筛选 Kubernetes 对象。 下面是一些使用字段选择器查询的例子：
metadata.name=my-servicemetadata.namespace!=defaultstatus.phase=Pending
下面这个 kubectl 命令将筛选出
status.phase
字段值为 Running 的所有 Pod：
kubectl get pods --field-selector status.phase=Running
说明：
字段选择器本质上是资源“过滤器（Filters）”。默认情况下，字段选择器/过滤器是未被应用的，
这意味着指定类型的所有资源都会被筛选出来。
这使得 kubectl get pods 和 kubectl get pods --field-selector ""
这两个 kubectl 查询是等价的。
支持的字段
不同的 Kubernetes 资源类型支持不同的字段选择器。
所有资源类型都支持 metadata.name 和 metadata.namespace 字段。
使用不被支持的字段选择器会产生错误。例如：
kubectl get ingress --field-selector foo.bar=baz
Error from server (BadRequest): Unable to find "ingresses" that match label selector "", field selector "foo.bar=baz": "foo.bar" is not a known field selector: only "metadata.name", "metadata.namespace"
支持字段列表
| 类别 | 字段 |
|---|---|
| Pod | spec.nodeNamespec.restartPolicyspec.schedulerNamespec.serviceAccountNamespec.hostNetworkstatus.phasestatus.podIPstatus.nominatedNodeName |
| Event | involvedObject.kindinvolvedObject.namespaceinvolvedObject.nameinvolvedObject.uidinvolvedObject.apiVersioninvolvedObject.resourceVersioninvolvedObject.fieldPathreasonreportingComponentsourcetype |
| Secret | type |
| Namespace | status.phase |
| ReplicaSet | status.replicas |
| ReplicationController | status.replicas |
| Job | status.successful |
| Node | spec.unschedulable |
| CertificateSigningRequest | spec.signerName |
支持的操作符
你可在字段选择器中使用 =、== 和 !=（= 和 == 的意义是相同的）操作符。
例如，下面这个 kubectl 命令将筛选所有不属于 default 命名空间的 Kubernetes 服务：
kubectl get services --all-namespaces --field-selector metadata.namespace!=default
说明：
基于集合的操作符
（in、notin、exists）不支持字段选择算符。
链式选择器
同标签和其他选择器一样，
字段选择器可以通过使用逗号分隔的列表组成一个选择链。
下面这个 kubectl 命令将筛选 status.phase 字段不等于 Running 同时
spec.restartPolicy 字段等于 Always 的所有 Pod：
kubectl get pods --field-selector=status.phase!=Running,spec.restartPolicy=Always
多种资源类型
你能够跨多种资源类型来使用字段选择器。
下面这个 kubectl 命令将筛选出所有不在 default 命名空间中的 StatefulSet 和 Service：
kubectl get statefulsets,services --all-namespaces --field-selector metadata.namespace!=default