大网数据广告活动
Kubernetes 部署与运维

字段选择算符

· 52CE 我爱测

“字段选择算符(Field selectors)”允许你根据一个或多个资源字段的值筛选 Kubernetes 。 下面是一些使用字段选择算符查询的例子:

“字段选择算符(Field selectors)”允许你根据一个或多个资源字段的值筛选 Kubernetes 。 下面是一些使用字段选择算符查询的例子:

  • metadata.name=my-service
  • metadata.namespace!=default
  • status.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 查询是等价的。

支持的字段 {#supported-fields}

不同的 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.nodeName<br>spec.restartPolicy<br>spec.schedulerName<br>spec.serviceAccountName<br>spec.hostNetwork<br>status.phase<br>status.podIP<br>status.podIPs<br>status.nominatedNodeName
Event involvedObject.kind<br>involvedObject.namespace<br>involvedObject.name<br>involvedObject.uid<br>involvedObject.apiVersion<br>involvedObject.resourceVersion<br>involvedObject.fieldPath<br>reason<br>reportingComponent<br>source<br>type
Secret type
Service spec.clusterIP<br>spec.type
Namespace status.phase
ReplicaSet status.replicas
ReplicationController status.replicas
Job status.successful
Node spec.unschedulable
CertificateSigningRequest spec.signerName

自定义资源字段

所有自定义资源类型都支持 metadata.name 和 metadata.namespace 字段。

此外, 的 spec.versions[*].selectableFields 字段声明了自定义资源中哪些其他字段可以用于字段选择算符。 有关如何使用 CustomResourceDefinitions 的字段选择算符的更多信息, 请参阅自定义资源的选择字段。

支持的操作符 {#supported-operators}

你可在字段选择算符中使用 =、== 和 !=(= 和 == 的意义是相同的)操作符。 例如,下面这个 kubectl 命令将筛选所有不属于 default 命名空间的 Kubernetes Service:

kubectl get services  --all-namespaces --field-selector metadata.namespace!=default

基于集合的操作符 (in、notin、exists)不支持字段选择算符。

链式选择算符 {#chained-selectors}

同标签和其他选择算符一样, 字段选择算符可以通过使用逗号分隔的列表组成一个选择链。 下面这个 kubectl 命令将筛选 status.phase 字段不等于 Running 同时 spec.restartPolicy 字段等于 Always 的所有 Pod:

kubectl get pods --field-selector=status.phase!=Running,spec.restartPolicy=Always

多种资源类型 {#multiple-resource-types}

你能够跨多种资源类型来使用字段选择算符。 下面这个 kubectl 命令将筛选出所有不在 default 命名空间中的 StatefulSet 和 Service:

kubectl get statefulsets,services --all-namespaces --field-selector metadata.namespace!=default

来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
Kubernetes 文档贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。