Merge pull request #32833 from feloy/api-reference-multi-pages

API reference multi pages for v1.24

Author: k8s-ci-robot

api-ref-assets/api/swagger.json

@@ -405,6 +405,7 @@
   - fields:
     - jobTemplate
     - schedule
+    - timeZone
     - concurrencyPolicy
     - startingDeadlineSeconds
     - suspend

api-ref-assets/config/fields.yaml

@@ -124,7 +124,7 @@ parts:
     version: v1
   - name: CSIStorageCapacity
     group: storage.k8s.io
-    version: v1beta1
+    version: v1
 - name: Authentication Resources
   chapters:
   - name: ServiceAccount

api-ref-assets/config/toc.yaml

@@ -109,8 +109,6 @@ CertificateSigningRequestSpec contains the certificate request.
     3. Signer whose configured minimum is longer than the requested duration
 
   The minimum valid value for expirationSeconds is 600, i.e. 10 minutes.
-  
-  As of v1.22, this field is beta and is controlled via the CSRDuration feature gate.
 
 - **extra** (map[string][]string)
 
@@ -212,11 +210,6 @@ CertificateSigningRequestStatus contains conditions used to indicate approved/de
     Approved and Denied conditions are mutually exclusive. Approved, Denied, and Failed conditions cannot be removed once added.
 
     Only one condition of a given type is allowed.
-    
-    Possible enum values:
-     - `"Approved"` Approved indicates the request was approved and should be issued by the signer.
-     - `"Denied"` Denied indicates the request was denied and should not be issued by the signer.
-     - `"Failed"` Failed indicates the signer failed to issue the certificate.
 
   - **conditions.lastTransitionTime** (Time)
 

content/en/docs/reference/kubernetes-api/authentication-resources/certificate-signing-request-v1.md

@@ -54,7 +54,7 @@ ServiceAccount binds together: * a name, understood by users, and perhaps by per
 
   *Patch strategy: merge on key `name`*
 
-  Secrets is the list of secrets allowed to be used by pods running using this ServiceAccount. More info: https://kubernetes.io/docs/concepts/configuration/secret
+  Secrets is a list of the secrets in the same namespace that pods running using this ServiceAccount are allowed to use. Pods are only limited to this list if this service account has a "kubernetes.io/enforce-mountable-secrets" annotation set to "true". This field should not be used to find auto-generated service account token secrets for use outside of pods. Instead, tokens can be requested directly using the TokenRequest API, or service account token secrets can be manually created. More info: https://kubernetes.io/docs/concepts/configuration/secret
 
 
 

content/en/docs/reference/kubernetes-api/authentication-resources/service-account-v1.md

@@ -90,13 +90,6 @@ NamespaceStatus is information about the current status of a Namespace.
   - **conditions.type** (string), required
 
     Type of namespace controller condition.
-    
-    Possible enum values:
-     - `"NamespaceContentRemaining"` contains information about resources remaining in a namespace.
-     - `"NamespaceDeletionContentFailure"` contains information about namespace deleter errors during deletion of resources.
-     - `"NamespaceDeletionDiscoveryFailure"` contains information about namespace deleter errors during resource discovery.
-     - `"NamespaceDeletionGroupVersionParsingFailure"` contains information about namespace deleter errors parsing GV for legacy types.
-     - `"NamespaceFinalizersRemaining"` contains information about which finalizers are on resources remaining in a namespace.
 
   - **conditions.lastTransitionTime** (Time)
 
@@ -114,9 +107,7 @@ NamespaceStatus is information about the current status of a Namespace.
 
   Phase is the current lifecycle phase of the namespace. More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/
 
-  Possible enum values:
-   - `"Active"` means the namespace is available for use in the system
-   - `"Terminating"` means the namespace is undergoing graceful termination
+  
 
 
 

content/en/docs/reference/kubernetes-api/cluster-resources/namespace-v1.md

@@ -62,7 +62,7 @@ NodeSpec describes the attributes that a node is created with.
 
 - **configSource** (NodeConfigSource)
 
-  Deprecated. If specified, the source of the node's configuration. The DynamicKubeletConfig feature gate must be enabled for the Kubelet to use this field. This field is deprecated as of 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration
+  Deprecated: Previously used to specify the source of the node's configuration for the DynamicKubeletConfig feature. This feature is removed from Kubelets as of 1.24 and will be fully removed in 1.26.
 
   <a name="NodeConfigSource"></a>
   *NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22*
@@ -121,10 +121,7 @@ NodeSpec describes the attributes that a node is created with.
 
     Required. The effect of the taint on pods that do not tolerate the taint. Valid effects are NoSchedule, PreferNoSchedule and NoExecute.
 
-    Possible enum values:
-     - `"NoExecute"` Evict any already-running pods that do not tolerate the taint. Currently enforced by NodeController.
-     - `"NoSchedule"` Do not allow new pods to schedule onto the node unless they tolerate the taint, but allow all pods submitted to Kubelet without going through the scheduler to start, and allow all already-running pods to continue running. Enforced by the scheduler.
-     - `"PreferNoSchedule"` Like TaintEffectNoSchedule, but the scheduler tries not to schedule new pods onto the node, rather than prohibiting new pods from scheduling onto the node entirely. Enforced by the scheduler.
+    
 
   - **taints.key** (string), required
 
@@ -171,13 +168,6 @@ NodeStatus is information about the current status of a node.
   - **addresses.type** (string), required
 
     Node address type, one of Hostname, ExternalIP or InternalIP.
-    
-    Possible enum values:
-     - `"ExternalDNS"` identifies a DNS name which resolves to an IP address which has the characteristics of a NodeExternalIP. The IP it resolves to may or may not be a listed NodeExternalIP address.
-     - `"ExternalIP"` identifies an IP address which is, in some way, intended to be more usable from outside the cluster then an internal IP, though no specific semantics are defined. It may be a globally routable IP, though it is not required to be. External IPs may be assigned directly to an interface on the node, like a NodeInternalIP, or alternatively, packets sent to the external IP may be NAT'ed to an internal node IP rather than being delivered directly (making the IP less efficient for node-to-node traffic than a NodeInternalIP).
-     - `"Hostname"` identifies a name of the node. Although every node can be assumed to have a NodeAddress of this type, its exact syntax and semantics are not defined, and are not consistent between different clusters.
-     - `"InternalDNS"` identifies a DNS name which resolves to an IP address which has the characteristics of a NodeInternalIP. The IP it resolves to may or may not be a listed NodeInternalIP address.
-     - `"InternalIP"` identifies an IP address which is assigned to one of the node's network interfaces. Every node should have at least one address of this type. An internal IP is normally expected to be reachable from every other node, but may not be visible to hosts outside the cluster. By default it is assumed that kube-apiserver can reach node internal IPs, though it is possible to configure clusters where this is not the case. NodeInternalIP is the default type of node IP, and does not necessarily imply that the IP is ONLY reachable internally. If a node has multiple internal IPs, no specific semantics are assigned to the additional IPs.
 
 - **allocatable** (map[string]<a href="{{< ref "../common-definitions/quantity#Quantity" >}}">Quantity</a>)
 
@@ -203,13 +193,6 @@ NodeStatus is information about the current status of a node.
   - **conditions.type** (string), required
 
     Type of node condition.
-    
-    Possible enum values:
-     - `"DiskPressure"` means the kubelet is under pressure due to insufficient available disk.
-     - `"MemoryPressure"` means the kubelet is under pressure due to insufficient available memory.
-     - `"NetworkUnavailable"` means that network for the node is not correctly configured.
-     - `"PIDPressure"` means the kubelet is under pressure due to insufficient available PID.
-     - `"Ready"` means kubelet is healthy and ready to accept pods.
 
   - **conditions.lastHeartbeatTime** (Time)
 
@@ -396,7 +379,7 @@ NodeStatus is information about the current status of a node.
 
   - **nodeInfo.containerRuntimeVersion** (string), required
 
-    ContainerRuntime Version reported by the node through runtime remote API (e.g. docker://1.5.0).
+    ContainerRuntime Version reported by the node through runtime remote API (e.g. containerd://1.4.2).
 
   - **nodeInfo.kernelVersion** (string), required
 
@@ -430,10 +413,7 @@ NodeStatus is information about the current status of a node.
 
   NodePhase is the recently observed lifecycle phase of the node. More info: https://kubernetes.io/docs/concepts/nodes/node/#phase The field is never populated, and now is deprecated.
 
-  Possible enum values:
-   - `"Pending"` means the node has been created/added by the system, but not configured.
-   - `"Running"` means the node has been configured and has Kubernetes components running.
-   - `"Terminated"` means the node has been removed from the cluster.
+  
 
 - **volumesAttached** ([]AttachedVolume)
 

content/en/docs/reference/kubernetes-api/cluster-resources/node-v1.md

@@ -50,7 +50,6 @@ RuntimeClass defines a class of container runtime supported in the cluster. The
 
   Overhead represents the resource overhead associated with running a pod for a given RuntimeClass. For more details, see
    https://kubernetes.io/docs/concepts/scheduling-eviction/pod-overhead/
-  This field is in beta starting v1.18 and is only honored by servers that enable the PodOverhead feature.
 
   <a name="Overhead"></a>
   *Overhead structure represents the resource overhead associated with running a pod.*
@@ -87,9 +86,7 @@ RuntimeClass defines a class of container runtime supported in the cluster. The
 
       Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a pod can tolerate all taints of a particular category.
 
-      Possible enum values:
-       - `"Equal"`
-       - `"Exists"`
+      
 
     - **scheduling.tolerations.value** (string)
 
@@ -99,10 +96,7 @@ RuntimeClass defines a class of container runtime supported in the cluster. The
 
       Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule, PreferNoSchedule and NoExecute.
 
-      Possible enum values:
-       - `"NoExecute"` Evict any already-running pods that do not tolerate the taint. Currently enforced by NodeController.
-       - `"NoSchedule"` Do not allow new pods to schedule onto the node unless they tolerate the taint, but allow all pods submitted to Kubelet without going through the scheduler to start, and allow all already-running pods to continue running. Enforced by the scheduler.
-       - `"PreferNoSchedule"` Like TaintEffectNoSchedule, but the scheduler tries not to schedule new pods onto the node, rather than prohibiting new pods from scheduling onto the node entirely. Enforced by the scheduler.
+      
 
     - **scheduling.tolerations.tolerationSeconds** (int64)
 

content/en/docs/reference/kubernetes-api/cluster-resources/runtime-class-v1.md

@@ -44,9 +44,7 @@ ListMeta describes metadata that synthetic resources must have, including lists
 
 - **selfLink** (string)
 
-  selfLink is a URL representing this object. Populated by the system. Read-only.
-  
-  DEPRECATED Kubernetes will stop propagating this field in 1.20 release and the field is planned to be removed in 1.21 release.
+  Deprecated: selfLink is a legacy read-only field that is no longer populated by the system.
 
 
 

content/en/docs/reference/kubernetes-api/common-definitions/list-meta.md

@@ -38,13 +38,7 @@ A node selector requirement is a selector that contains values, a key, and an op
 
   Represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. Gt, and Lt.
 
-  Possible enum values:
-   - `"DoesNotExist"`
-   - `"Exists"`
-   - `"Gt"`
-   - `"In"`
-   - `"Lt"`
-   - `"NotIn"`
+  
 
 - **values** ([]string)