Merge pull request #55648 from my-git9/npp-17127

k8s-ci-robot · web-flow · commit 82a633389b54 · 2026-05-04T05:43:37.000+05:30
[zh-cn]sync event-v1 lease-v1
diff --git a/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/event-v1.md b/content/zh-cn/docs/reference/kubernetes-api/cluster-resources/event-v1.md
@@ -26,6 +26,7 @@ auto_generated: true
 `import "k8s.io/api/events/v1"`
 
 ## Event {#Event}
+
 <!--
 Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system.
 Events have a limited retention time and triggers and messages may evolve with time. 
@@ -48,7 +49,9 @@ Events 应被视为通知性质的、尽最大努力而提供的补充数据。
   <!--
   Standard object's metadata. 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
+  
+  标准的对象元数据。更多信息：
+  https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 <!--
 - **eventTime** (MicroTime), required
@@ -58,7 +61,7 @@ Events 应被视为通知性质的、尽最大努力而提供的补充数据。
 
 - **eventTime** (MicroTime)，必需
 
-  evenTime 是该事件首次被观察到的时间。它是必需的。
+  `evenTime` 是该事件首次被观察到的时间。它是必需的。
 
   <a name="MicroTime"></a>
 
@@ -73,50 +76,57 @@ Events 应被视为通知性质的、尽最大努力而提供的补充数据。
   <!--
   action is what action was taken/failed regarding to the regarding object. It is machine-readable. This field cannot be empty for new Events and it can have at most 128 characters.
   -->
-  action 是针对相关对象所采取的或已失败的动作。字段值是机器可读的。对于新的 Event，此字段不能为空，
+  
+  `action` 是针对相关对象所采取的或已失败的动作。字段值是机器可读的。对于新的 Event，此字段不能为空，
   且最多为 128 个字符。
 
 - **deprecatedCount** (int32)
 
   <!--
   deprecatedCount is the deprecated field assuring backward compatibility with core.v1 Event type.
   -->
-  deprecatedCount 是确保与 core.v1 Event 类型向后兼容的已弃用字段。
+  
+  `deprecatedCount` 是确保与 `core.v1` Event 类型向后兼容的已弃用字段。
 
 - **deprecatedFirstTimestamp** (Time)
 
   <!--
   deprecatedFirstTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type.
   -->
-  deprecatedFirstTimestamp 是确保与 core.v1 Event 类型向后兼容的已弃用字段。
+  
+  `deprecatedFirstTimestamp` 是确保与 `core.v1` Event 类型向后兼容的已弃用字段。
 
   <a name="Time"></a>
   
   <!--
   *Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON.  Wrappers are provided for many of the factory methods that the time package offers.*
   -->
+  
   **Time 是对 time.Time 的封装。Time 支持对 YAML 和 JSON 进行正确封包。为 time 包的许多函数方法提供了封装器。**
 
 - **deprecatedLastTimestamp** (Time)
 
   <!--
   deprecatedLastTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type.
   -->
-  deprecatedLastTimestamp 是确保与 core.v1 Event 类型向后兼容的已弃用字段。
+  
+  `deprecatedLastTimestamp` 是确保与 `core.v1` Event 类型向后兼容的已弃用字段。
 
   <a name="Time"></a>
 
   <!--
   *Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON.  Wrappers are provided for many of the factory methods that the time package offers.*
   --> 
+  
   **Time 是对 time.Time 的封装。Time 支持对 YAML 和 JSON 进行正确封包。为 time 包的许多函数方法提供了封装器。**
 
 - **deprecatedSource** (EventSource)
 
   <!--
   deprecatedSource is the deprecated field assuring backward compatibility with core.v1 Event type.
   -->  
-  deprecatedSource 是确保与 core.v1 Event 类型向后兼容的已弃用字段。
+  
+  `deprecatedSource` 是确保与 `core.v1` Event 类型向后兼容的已弃用字段。
 
   <a name="EventSource"></a>
   
@@ -147,20 +157,23 @@ Events 应被视为通知性质的、尽最大努力而提供的补充数据。
   <!--
   note is a human-readable description of the status of this operation. Maximal length of the note is 1kB, but libraries should be prepared to handle values up to 64kB.
   -->
-  note 是对该操作状态的可读描述。注释的最大长度是 1kB，但是库应该准备好处理最多 64kB 的值。
+  
+  `note` 是对该操作状态的可读描述。注释的最大长度是 1kB，但是库应该准备好处理最多 64kB 的值。
 
 - **reason** (string)
 
   <!--
   reason is why the action was taken. It is human-readable. This field cannot be empty for new Events and it can have at most 128 characters.
   -->
-  reason 是采取行动的原因。它是人类可读的。对于新的 Event，此字段不能为空，且最多为128个字符。
+  
+  `reason` 是采取行动的原因。它是人类可读的。对于新的 Event，此字段不能为空，且最多为128个字符。
 
 - **regarding** (<a href="{{< ref "../common-definitions/object-reference#ObjectReference" >}}">ObjectReference</a>)
 
   <!--
   regarding contains the object this Event is about. In most cases it's an Object reporting controller implements, e.g. ReplicaSetController implements ReplicaSets and this event is emitted because it acts on some changes in a ReplicaSet object.
   -->
+  
   关于包含此 Event 所涉及的对象。在大多数情况下，所指的是报告事件的控制器所实现的一个 Object。
   例如 ReplicaSetController 实现了 ReplicaSet，这个事件被触发是因为控制器对 ReplicaSet 对象做了一些变化。
 
@@ -169,7 +182,8 @@ Events 应被视为通知性质的、尽最大努力而提供的补充数据。
   <!--
   related is the optional secondary object for more complex actions. E.g. when regarding object triggers a creation or deletion of related object.
   -->
-  related 是用于更复杂操作的、可选的、从属性的对象。例如，当 regarding 对象触发 related 对象的创建或删除时。
+  
+  `related` 是用于更复杂操作的、可选的、从属性的对象。例如，当 regarding 对象触发 related 对象的创建或删除时。
 
 - **reportingController** (string)
 
@@ -183,7 +197,8 @@ Events 应被视为通知性质的、尽最大努力而提供的补充数据。
   <!--
   reportingInstance is the ID of the controller instance, e.g. `kubelet-xyzf`. This field cannot be empty for new Events and it can have at most 128 characters.
   -->
-  reportingInstance 为控制器实例的 ID,例如 `kubelet-xyzf`。对于新的 Event，此字段不能为空，且最多为 128 个字符。 
+  
+  `reportingInstance` 为控制器实例的 ID,例如 `kubelet-xyzf`。对于新的 Event，此字段不能为空，且最多为 128 个字符。 
 
 - **series** (EventSeries)
 
@@ -410,6 +425,13 @@ GET /apis/events.k8s.io/v1/namespaces/{namespace}/events
 
   <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
 
+<!--
+- **shardSelector** (*in query*): string
+-->
+- **shardSelector** (**查询参数**): string
+
+  <a href="{{< ref "../common-parameters/common-parameters#shardSelector" >}}">shardSelector</a>
+
 <!--
 - **timeoutSeconds** (*in query*): integer
 -->
@@ -512,6 +534,13 @@ GET /apis/events.k8s.io/v1/events
 
   <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
 
+<!--
+- **shardSelector** (*in query*): string
+-->
+- **shardSelector** (**查询参数**): string
+
+  <a href="{{< ref "../common-parameters/common-parameters#shardSelector" >}}">shardSelector</a>
+
 <!--
 - **timeoutSeconds** (*in query*): integer
 -->
@@ -952,6 +981,13 @@ DELETE /apis/events.k8s.io/v1/namespaces/{namespace}/events
 
   <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
 
+<!--
+- **shardSelector** (*in query*): string
+-->
+- **shardSelector** (**查询参数**): string
+
+  <a href="{{< ref "../common-parameters/common-parameters#shardSelector" >}}">shardSelector</a>
+
 <!--
 - **timeoutSeconds** (*in query*): integer
 -->
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
@@ -53,7 +53,7 @@ Lease 定义了租约的概念。
 
 - **spec** (<a href="{{< ref "../cluster-resources/lease-v1#LeaseSpec" >}}">LeaseSpec</a>)
 
-  spec 包含 Lease 的规约。更多信息：
+  `spec` 包含 Lease 的规约。更多信息：
   https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
 
 ## LeaseSpec {#LeaseSpec}
@@ -79,14 +79,14 @@ LeaseSpec 是 Lease 的规约。
 -->
 - **acquireTime** (MicroTime)
 
-  acquireTime 是当前租约被获取的时间。
+  `acquireTime` 是当前租约被获取的时间。
   
   <a name="MicroTime"></a>
   **MicroTime 是微秒级精确时间的版本。**
 
 - **holderIdentity** (string)
 
-  holderIdentity 包含当前租约持有人的身份。
+  `holderIdentity` 包含当前租约持有人的身份。
   如果使用协调领导者选举（Coordinated Leader Election），
   则持有人身份必须等于选举出的 LeaseCandidate.metadata.name 字段。
 
@@ -105,16 +105,16 @@ LeaseSpec 是 Lease 的规约。
 -->
 - **leaseDurationSeconds** (int32)
 
-  leaseDurationSeconds 是租约候选人需要等待强制获取租约的持续时间。
-  这是相对于上次观察到的 renewTime 的度量。
+  `leaseDurationSeconds` 是租约候选人需要等待强制获取租约的持续时间。
+  这是相对于上次观察到的 `renewTime` 的度量。
 
 - **leaseTransitions** (int32)
 
-  leaseTransitions 是租约持有人之间的转换次数。
+  `leaseTransitions` 是租约持有人之间的转换次数。
 
 - **preferredHolder** (string)
 
-  preferredHolder 向租约持有人发出信号，提示此租约出现一个更优的持有人且应该被放弃。
+  `preferredHolder` 向租约持有人发出信号，提示此租约出现一个更优的持有人且应该被放弃。
   此字段仅在设置了 `strategy` 时才能被设置。
 
 <!--
@@ -131,14 +131,14 @@ LeaseSpec 是 Lease 的规约。
 -->
 - **renewTime** (MicroTime)
 
-  renewTime 是当前租约持有人上次更新租约的时间。
+  `renewTime` 是当前租约持有人上次更新租约的时间。
 
   <a name="MicroTime"></a>
   **MicroTime 是具有微秒级精度的时间版本。**
 
 - **strategy**（字符串）
 
-  strategy 指示为协调领导者选举选择领导者的策略。
+  `strategy` 指示为协调领导者选举选择领导者的策略。
   如果此字段未被指定，则此租约没有主动的协调。
   （Alpha）使用此字段需要启用 CoordinatedLeaderElection 特性门控。
 
@@ -160,6 +160,7 @@ LeaseList 是 Lease 对象的列表。
   <!--
   Standard list metadata. 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
 
@@ -170,7 +171,7 @@ LeaseList 是 Lease 对象的列表。
 -->
 - **items** ([]<a href="{{< ref "../cluster-resources/lease-v1#Lease" >}}">Lease</a>)，必需
 
-  items 是架构对象的列表。
+  `items` 是架构对象的列表。
 
 <!--
 ## Operations {#Operations}
@@ -282,6 +283,10 @@ GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
 
   <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
 
+- **shardSelector** (*in query*): string
+
+  <a href="{{< ref "../common-parameters/common-parameters#shardSelector" >}}">shardSelector</a>
+
 - **timeoutSeconds** (*in query*): integer
 
   <a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -332,6 +337,10 @@ GET /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
 
   <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
 
+- **shardSelector** (**查询参数**): string
+
+  <a href="{{< ref "../common-parameters/common-parameters#shardSelector" >}}">shardSelector</a>
+
 - **timeoutSeconds** (**查询参数**): integer
 
   <a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -399,6 +408,10 @@ GET /apis/coordination.k8s.io/v1/leases
 
   <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
 
+- **shardSelector** (*in query*): string
+
+  <a href="{{< ref "../common-parameters/common-parameters#shardSelector" >}}">shardSelector</a>
+
 - **timeoutSeconds** (*in query*): integer
 
   <a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -445,6 +458,10 @@ GET /apis/coordination.k8s.io/v1/leases
 
   <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
 
+- **shardSelector** (**查询参数**): string
+
+  <a href="{{< ref "../common-parameters/common-parameters#shardSelector" >}}">shardSelector</a>
+
 - **timeoutSeconds** (**查询参数**): integer
 
   <a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -856,6 +873,10 @@ DELETE /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
 
   <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
 
+- **shardSelector** (*in query*): string
+
+  <a href="{{< ref "../common-parameters/common-parameters#shardSelector" >}}">shardSelector</a>
+
 - **timeoutSeconds** (*in query*): integer
 
   <a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
@@ -916,6 +937,10 @@ DELETE /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases
 
   <a href="{{< ref "../common-parameters/common-parameters#sendInitialEvents" >}}">sendInitialEvents</a>
 
+- **shardSelector** (**查询参数**): string
+
+  <a href="{{< ref "../common-parameters/common-parameters#shardSelector" >}}">shardSelector</a>
+
 - **timeoutSeconds** (**查询参数**): integer
 
   <a href="{{< ref "../common-parameters/common-parameters#timeoutSeconds" >}}">timeoutSeconds</a>
