# LabelSelector

> 标签选择算符是对一组资源的标签查询。

---

LLMS index: [llms.txt](/llms.txt)

---

<!--
api_metadata:
  apiVersion: ""
  import: "k8s.io/apimachinery/pkg/apis/meta/v1"
  kind: "LabelSelector"
content_type: "api_reference"
description: "A label selector is a label query over a set of resources."
title: "LabelSelector"
weight: 2
auto_generated: true
-->

`import "k8s.io/apimachinery/pkg/apis/meta/v1"`

<!-- 
A label selector is a label query over a set of resources. The result of matchLabels and matchExpressions are ANDed. An empty label selector matches all objects. A null label selector matches no objects.
-->
标签选择算符是对一组资源的标签查询。
`matchLabels` 和 `matchExpressions` 的结果按逻辑与的关系组合。
一个 `empty` 标签选择算符匹配所有对象。一个 `null` 标签选择算符不匹配任何对象。

<hr>

<!--
- **matchExpressions** ([]LabelSelectorRequirement)

  *Atomic: will be replaced during a merge*

  matchExpressions is a list of label selector requirements. The requirements are ANDed.

  <a name="LabelSelectorRequirement"></a>
  *A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.*
-->
- **matchExpressions** ([]LabelSelectorRequirement)
  
  **原子性：将在合并期间被替换**

  `matchExpressions` 是标签选择算符要求的列表，这些要求的结果按逻辑与的关系来计算。
   
  <a name="LabelSelectorRequirement"></a> 
  **标签选择算符要求是包含值、键和关联键和值的运算符的选择算符。**
 
  <!-- 
  - **matchExpressions.key** (string), required

    key is the label key that the selector applies to.
  -->

  - **matchExpressions.key** (string)，必需
    
    `key` 是选择算符应用的标签键。
  
  <!-- 
  - **matchExpressions.operator** (string), required

    operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.        
  -->
   
  - **matchExpressions.operator** (string)，必需
 
    `operator` 表示键与一组值的关系。有效的运算符包括 `In`、`NotIn`、`Exists` 和 `DoesNotExist`。
    
  <!--
  - **matchExpressions.values** ([]string)

    *Atomic: will be replaced during a merge*

    values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
  -->
   
  - **matchExpressions.values** ([]string)
  
    **原子性：将在合并期间被替换**

    `values` 是一个字符串值数组。如果运算符为 `In` 或 `NotIn`，则 `values` 数组必须为非空。
    如果运算符是 `Exists` 或 `DoesNotExist`，则 `values` 数组必须为空。
    该数组在策略性合并补丁（Strategic Merge Patch）期间被替换。
  
<!--
- **matchLabels** (map[string]string)

  matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
-->
- **matchLabels** (map[string]string)
  
  `matchLabels` 是 {`key`,`value`} 键值对的映射。

  `matchLabels` 映射中的单个 {`key`,`value`} 键值对相当于 `matchExpressions` 的一个元素，
  其键字段为 `key`，运算符为 `In`，`values` 数组仅包含 `value`。

  所表达的需求最终要按逻辑与的关系组合。