Merge pull request #48075 from windsonsea/leasey

k8s-ci-robot · web-flow · commit 1762dc43f076 · 2024-09-26T14:48:01.000+01:00
[zh] Sync cluster-resources/lease-v1.md
diff --git a/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/lease-v1.md b/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/lease-v1.md
@@ -37,18 +37,22 @@ Lease 定义了租约的概念。
 
 - **kind**: Lease
 
+<!--
 - **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
 
-  <!--
   More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
-  -->
-  更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **spec** (<a href="{{< ref "../cluster-resources/lease-v1#LeaseSpec" >}}">LeaseSpec</a>)
 
-  <!--
   spec contains the specification of the Lease. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
-  -->
+-->
+- **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
+
+  更多信息：
+  https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
+
+- **spec** (<a href="{{< ref "../cluster-resources/lease-v1#LeaseSpec" >}}">LeaseSpec</a>)
+
   spec 包含 Lease 的规约。更多信息：
   https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
 
@@ -57,7 +61,7 @@ Lease 定义了租约的概念。
 <!--
 LeaseSpec is a specification of a Lease.
 -->
-LeaseSpec 是一个 Lease 的规约。
+LeaseSpec 是 Lease 的规约。
 
 <hr>
 
@@ -71,7 +75,7 @@ LeaseSpec 是一个 Lease 的规约。
 
 - **holderIdentity** (string)
 
-  holderIdentity contains the identity of the holder of a current lease.
+  holderIdentity contains the identity of the holder of a current lease. If Coordinated Leader Election is used, the holder identity must be equal to the elected LeaseCandidate.metadata.name field.
 -->
 - **acquireTime** (MicroTime)
 
@@ -83,38 +87,61 @@ LeaseSpec 是一个 Lease 的规约。
 - **holderIdentity** (string)
 
   holderIdentity 包含当前租约持有人的身份。
+  如果使用协调领导者选举（Coordinated Leader Election），
+  则持有人身份必须等于选举出的 LeaseCandidate.metadata.name 字段。
 
 <!--
 - **leaseDurationSeconds** (int32)
 
-  leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measure against time of last observed renewTime.
+  leaseDurationSeconds is a duration that candidates for a lease need to wait to force acquire it. This is measured against the time of last observed renewTime.
 
 - **leaseTransitions** (int32)
 
   leaseTransitions is the number of transitions of a lease between holders.
 
-- **renewTime** (MicroTime)
+- **preferredHolder** (string)
 
-  renewTime is a time when the current holder of a lease has last updated the lease.
-
-  <a name="MicroTime"></a>
-  *MicroTime is version of Time with microsecond level precision.*
+  PreferredHolder signals to a lease holder that the lease has a more optimal holder and should be given up. This field can only be set if Strategy is also set.
 -->
 - **leaseDurationSeconds** (int32)
 
-  leaseDurationSeconds 是租约候选人需要等待强制获取租约的持续时间。这是相对于上次观察到的 renewTime 的度量。
+  leaseDurationSeconds 是租约候选人需要等待强制获取租约的持续时间。
+  这是相对于上次观察到的 renewTime 的度量。
 
 - **leaseTransitions** (int32)
 
   leaseTransitions 是租约持有人之间的转换次数。
 
+- **preferredHolder** (string)
+
+  preferredHolder 向租约持有人发出信号，提示此租约出现一个更优的持有人且应该被放弃。
+  此字段仅在设置了 `strategy` 时才能被设置。
+
+<!--
+- **renewTime** (MicroTime)
+
+  renewTime is a time when the current holder of a lease has last updated the lease.
+
+  <a name="MicroTime"></a>
+  *MicroTime is version of Time with microsecond level precision.*
+
+- **strategy** (string)
+
+  Strategy indicates the strategy for picking the leader for coordinated leader election. If the field is not specified, there is no active coordination for this lease. (Alpha) Using this field requires the CoordinatedLeaderElection feature gate to be enabled.
+-->
 - **renewTime** (MicroTime)
 
   renewTime 是当前租约持有人上次更新租约的时间。
 
   <a name="MicroTime"></a>
   **MicroTime 是具有微秒级精度的时间版本。**
 
+- **strategy**（字符串）
+
+  strategy 指示为协调领导者选举选择领导者的策略。
+  如果此字段未被指定，则此租约没有主动的协调。
+  （Alpha）使用此字段需要启用 CoordinatedLeaderElection 特性门控。
+
 ## LeaseList {#LeaseList}
 
 <!--
@@ -136,11 +163,13 @@ LeaseList 是 Lease 对象的列表。
   标准的列表元数据。更多信息：
   https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
+<!--
 - **items** ([]<a href="{{< ref "../cluster-resources/lease-v1#Lease" >}}">Lease</a>), required
 
-  <!--
   items is a list of schema objects.
-  -->
+-->
+- **items** ([]<a href="{{< ref "../cluster-resources/lease-v1#Lease" >}}">Lease</a>)，必需
+
   items 是架构对象的列表。
 
 <!--
@@ -154,20 +183,16 @@ LeaseList 是 Lease 对象的列表。
 ### `get` read the specified Lease
 
 #### HTTP Request
-
-GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
-
-#### Parameters
 -->
 ### `get` 读取指定的 Lease
 
 #### HTTP 请求
 
 GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
 
-#### 参数
-
 <!--
+#### Parameters
+
 - **name** (*in path*): string, required
 
   name of the Lease
@@ -180,11 +205,13 @@ GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
 
   <a href="{{< ref "../common-parameters/common-parameters#pretty" >}}">pretty</a>
 -->
-- **name** (**路径参数**): string, 必需
+#### 参数
+
+- **name** (**路径参数**): string，必需
 
-  Lease 名称。
+  Lease 的名称。
 
-- **namespace** (**路径参数**): string, 必需
+- **namespace** (**路径参数**): string，必需
 
   <a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
 
@@ -205,10 +232,8 @@ GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
 ### `list` list or watch objects of kind Lease
 
 #### HTTP Request
-
-GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
 -->
-### `list` 列出或监视 Lease 类对象
+### `list` 列出或监视类别为 Lease 的对象
 
 #### HTTP 请求
 
@@ -267,7 +292,7 @@ GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
 -->
 #### 参数
 
-- **namespace** (**路径参数**): string, 必需
+- **namespace** (**路径参数**): string，必需
 
   <a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
 
@@ -329,7 +354,7 @@ GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
 
 #### HTTP Request
 -->
-### `list` 列出或监视 Lease 类对象
+### `list` 列出或监视类别为 Lease 的对象
 
 #### HTTP 请求
 
@@ -381,7 +406,6 @@ GET /apis/coordination.k8s.io/v1/leases
 - **watch** (*in query*): boolean
 
   <a href="{{< ref "../common-parameters/common-parameters#watch" >}}">watch</a>
-
 -->
 #### 参数
 
@@ -476,11 +500,11 @@ POST /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
 -->
 #### 参数
 
-- **namespace** (**路径参数**): string, 必需
+- **namespace** (**路径参数**): string，必需
 
   <a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
 
-- **body**: <a href="{{< ref "../cluster-resources/lease-v1#Lease" >}}">Lease</a>, 必需
+- **body**: <a href="{{< ref "../cluster-resources/lease-v1#Lease" >}}">Lease</a>，必需
 
 - **dryRun** (**查询参数**): string
 
@@ -553,15 +577,15 @@ PUT /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
 -->
 #### 参数
 
-- **name** (**路径参数**): string, 必需
+- **name** (**路径参数**): string，必需
 
   Lease 的名称。
 
-- **namespace** (**路径参数**): string, 必需
+- **namespace** (**路径参数**): string，必需
 
   <a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
 
-- **body**: <a href="{{< ref "../cluster-resources/lease-v1#Lease" >}}">Lease</a>, 必需
+- **body**: <a href="{{< ref "../cluster-resources/lease-v1#Lease" >}}">Lease</a>，必需
 
 - **dryRun** (**查询参数**): string
 
@@ -636,15 +660,15 @@ PATCH /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
 -->
 #### 参数
 
-- **name** (**路径参数**): string, 必需
+- **name** (**路径参数**): string，必需
 
   Lease 的名称。
 
-- **namespace** (**路径参数**): string, 必需
+- **namespace** (**路径参数**): string，必需
 
   <a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
 
-- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>, 必需
+- **body**: <a href="{{< ref "../common-definitions/patch#Patch" >}}">Patch</a>，必需
 
 - **dryRun** (**查询参数**): string
 
@@ -682,7 +706,7 @@ PATCH /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
 
 #### HTTP Request
 -->
-### `delete` 删除一个 Lease
+### `delete` 删除 Lease
 
 #### HTTP 请求
 
@@ -719,11 +743,11 @@ DELETE /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
 -->
 #### 参数
 
-- **name** (**路径参数**): string, 必需
+- **name** (**路径参数**): string，必需
 
   Lease 的名称。
 
-- **namespace** (**路径参数**): string, 必需
+- **namespace** (**路径参数**): string，必需
 
   <a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
 
@@ -826,7 +850,7 @@ DELETE /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
 -->
 #### 参数
 
-- **namespace** (**路径参数**): string, 必需
+- **namespace** (**路径参数**): string，必需
 
   <a href="{{< ref "../common-parameters/common-parameters#namespace" >}}">namespace</a>
 
