Skip to content

Commit 3e10e8c

Browse files
committed
Update API resource reference for v1.34
1 parent ae21d9a commit 3e10e8c

22 files changed

+1628
-248
lines changed

‎content/en/docs/reference/kubernetes-api/authentication-resources/pod-certificate-request-v1alpha1.md‎

Lines changed: 902 additions & 0 deletions
Large diffs are not rendered by default.

‎content/en/docs/reference/kubernetes-api/authorization-resources/self-subject-access-review-v1.md‎

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -85,8 +85,6 @@ SelfSubjectAccessReviewSpec is a description of the access request. Exactly one
8585
- **resourceAttributes.fieldSelector** (FieldSelectorAttributes)
8686

8787
fieldSelector describes the limitation on access based on field. It can only limit access, not broaden it.
88-
89-
This field is alpha-level. To use this field, you must enable the `AuthorizeWithSelectors` feature gate (disabled by default).
9088

9189
<a name="FieldSelectorAttributes"></a>
9290
*FieldSelectorAttributes indicates a field limited access. Webhook authors are encouraged to * ensure rawSelector and requirements are not both set * consider the requirements field if set * not try to parse or consider the rawSelector field if set. This is to avoid another CVE-2022-2880 (i.e. getting different systems to agree on how exactly to parse a query is not something we want), see https://www.oxeye.io/resources/golang-parameter-smuggling-attack for more details. For the *SubjectAccessReview endpoints of the kube-apiserver: * If rawSelector is empty and requirements are empty, the request is not limited. * If rawSelector is present and requirements are empty, the rawSelector will be parsed and limited if the parsing succeeds. * If rawSelector is empty and requirements are present, the requirements should be honored * If rawSelector is present and requirements are present, the request is invalid.*
@@ -125,8 +123,6 @@ SelfSubjectAccessReviewSpec is a description of the access request. Exactly one
125123
- **resourceAttributes.labelSelector** (LabelSelectorAttributes)
126124

127125
labelSelector describes the limitation on access based on labels. It can only limit access, not broaden it.
128-
129-
This field is alpha-level. To use this field, you must enable the `AuthorizeWithSelectors` feature gate (disabled by default).
130126

131127
<a name="LabelSelectorAttributes"></a>
132128
*LabelSelectorAttributes indicates a label limited access. Webhook authors are encouraged to * ensure rawSelector and requirements are not both set * consider the requirements field if set * not try to parse or consider the rawSelector field if set. This is to avoid another CVE-2022-2880 (i.e. getting different systems to agree on how exactly to parse a query is not something we want), see https://www.oxeye.io/resources/golang-parameter-smuggling-attack for more details. For the *SubjectAccessReview endpoints of the kube-apiserver: * If rawSelector is empty and requirements are empty, the request is not limited. * If rawSelector is present and requirements are empty, the rawSelector will be parsed and limited if the parsing succeeds. * If rawSelector is empty and requirements are present, the requirements should be honored * If rawSelector is present and requirements are present, the request is invalid.*

‎content/en/docs/reference/kubernetes-api/authorization-resources/subject-access-review-v1.md‎

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -95,8 +95,6 @@ SubjectAccessReviewSpec is a description of the access request. Exactly one of
9595
- **resourceAttributes.fieldSelector** (FieldSelectorAttributes)
9696

9797
fieldSelector describes the limitation on access based on field. It can only limit access, not broaden it.
98-
99-
This field is alpha-level. To use this field, you must enable the `AuthorizeWithSelectors` feature gate (disabled by default).
10098

10199
<a name="FieldSelectorAttributes"></a>
102100
*FieldSelectorAttributes indicates a field limited access. Webhook authors are encouraged to * ensure rawSelector and requirements are not both set * consider the requirements field if set * not try to parse or consider the rawSelector field if set. This is to avoid another CVE-2022-2880 (i.e. getting different systems to agree on how exactly to parse a query is not something we want), see https://www.oxeye.io/resources/golang-parameter-smuggling-attack for more details. For the *SubjectAccessReview endpoints of the kube-apiserver: * If rawSelector is empty and requirements are empty, the request is not limited. * If rawSelector is present and requirements are empty, the rawSelector will be parsed and limited if the parsing succeeds. * If rawSelector is empty and requirements are present, the requirements should be honored * If rawSelector is present and requirements are present, the request is invalid.*
@@ -135,8 +133,6 @@ SubjectAccessReviewSpec is a description of the access request. Exactly one of
135133
- **resourceAttributes.labelSelector** (LabelSelectorAttributes)
136134

137135
labelSelector describes the limitation on access based on labels. It can only limit access, not broaden it.
138-
139-
This field is alpha-level. To use this field, you must enable the `AuthorizeWithSelectors` feature gate (disabled by default).
140136

141137
<a name="LabelSelectorAttributes"></a>
142138
*LabelSelectorAttributes indicates a label limited access. Webhook authors are encouraged to * ensure rawSelector and requirements are not both set * consider the requirements field if set * not try to parse or consider the rawSelector field if set. This is to avoid another CVE-2022-2880 (i.e. getting different systems to agree on how exactly to parse a query is not something we want), see https://www.oxeye.io/resources/golang-parameter-smuggling-attack for more details. For the *SubjectAccessReview endpoints of the kube-apiserver: * If rawSelector is empty and requirements are empty, the request is not limited. * If rawSelector is present and requirements are empty, the rawSelector will be parsed and limited if the parsing succeeds. * If rawSelector is empty and requirements are present, the requirements should be honored * If rawSelector is present and requirements are present, the request is invalid.*

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -131,7 +131,7 @@ NodeSpec describes the attributes that a node is created with.
131131

132132
- **taints.timeAdded** (Time)
133133

134-
TimeAdded represents the time at which the taint was added. It is only written for NoExecute taints.
134+
TimeAdded represents the time at which the taint was added.
135135

136136
<a name="Time"></a>
137137
*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.*

‎content/en/docs/reference/kubernetes-api/common-parameters/common-parameters.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ api_metadata:
66
content_type: "api_reference"
77
description: ""
88
title: "Common Parameters"
9-
weight: 10
9+
weight: 11
1010
auto_generated: true
1111
---
1212

‎content/en/docs/reference/kubernetes-api/config-and-storage-resources/csi-driver-v1.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ CSIDriverSpec is the specification of a CSIDriver.
5858

5959
- **attachRequired** (boolean)
6060

61-
attachRequired indicates this CSI volume driver requires an attach operation (because it implements the CSI ControllerPublishVolume() method), and that the Kubernetes attach detach controller should call the attach volume interface which checks the volumeattachment status and waits until the volume is attached before proceeding to mounting. The CSI external-attacher coordinates with CSI volume driver and updates the volumeattachment status when the attach operation is complete. If the CSIDriverRegistry feature gate is enabled and the value is specified to false, the attach operation will be skipped. Otherwise the attach operation will be called.
61+
attachRequired indicates this CSI volume driver requires an attach operation (because it implements the CSI ControllerPublishVolume() method), and that the Kubernetes attach detach controller should call the attach volume interface which checks the volumeattachment status and waits until the volume is attached before proceeding to mounting. The CSI external-attacher coordinates with CSI volume driver and updates the volumeattachment status when the attach operation is complete. If the value is specified to false, the attach operation will be skipped. Otherwise the attach operation will be called.
6262

6363
This field is immutable.
6464

@@ -74,7 +74,7 @@ CSIDriverSpec is the specification of a CSIDriver.
7474

7575
nodeAllocatableUpdatePeriodSeconds specifies the interval between periodic updates of the CSINode allocatable capacity for this driver. When set, both periodic updates and updates triggered by capacity-related failures are enabled. If not set, no updates occur (neither periodic nor upon detecting capacity-related failures), and the allocatable.count remains static. The minimum allowed value for this field is 10 seconds.
7676

77-
This is an alpha feature and requires the MutableCSINodeAllocatableCount feature gate to be enabled.
77+
This is a beta feature and requires the MutableCSINodeAllocatableCount feature gate to be enabled.
7878

7979
This field is mutable.
8080

‎content/en/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ PersistentVolumeClaimSpec describes the common attributes of storage devices and
138138

139139
- **volumeAttributesClassName** (string)
140140

141-
volumeAttributesClassName may be used to set the VolumeAttributesClass used by this claim. If specified, the CSI driver will create or update the volume with the attributes defined in the corresponding VolumeAttributesClass. This has a different purpose than storageClassName, it can be changed after the claim is created. An empty string value means that no VolumeAttributesClass will be applied to the claim but it's not allowed to reset this field to empty string once it is set. If unspecified and the PersistentVolumeClaim is unbound, the default VolumeAttributesClass will be set by the persistentvolume controller if it exists. If the resource referred to by volumeAttributesClass does not exist, this PersistentVolumeClaim will be set to a Pending state, as reflected by the modifyVolumeStatus field, until such as a resource exists. More info: https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (Beta) Using this field requires the VolumeAttributesClass feature gate to be enabled (off by default).
141+
volumeAttributesClassName may be used to set the VolumeAttributesClass used by this claim. If specified, the CSI driver will create or update the volume with the attributes defined in the corresponding VolumeAttributesClass. This has a different purpose than storageClassName, it can be changed after the claim is created. An empty string or nil value indicates that no VolumeAttributesClass will be applied to the claim. If the claim enters an Infeasible error state, this field can be reset to its previous value (including nil) to cancel the modification. If the resource referred to by volumeAttributesClass does not exist, this PersistentVolumeClaim will be set to a Pending state, as reflected by the modifyVolumeStatus field, until such as a resource exists. More info: https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/
142142

143143

144144

@@ -248,11 +248,11 @@ PersistentVolumeClaimStatus is the current status of a persistent volume claim.
248248

249249
- **currentVolumeAttributesClassName** (string)
250250

251-
currentVolumeAttributesClassName is the current name of the VolumeAttributesClass the PVC is using. When unset, there is no VolumeAttributeClass applied to this PersistentVolumeClaim This is a beta field and requires enabling VolumeAttributesClass feature (off by default).
251+
currentVolumeAttributesClassName is the current name of the VolumeAttributesClass the PVC is using. When unset, there is no VolumeAttributeClass applied to this PersistentVolumeClaim
252252

253253
- **modifyVolumeStatus** (ModifyVolumeStatus)
254254

255-
ModifyVolumeStatus represents the status object of ControllerModifyVolume operation. When this is unset, there is no ModifyVolume operation being attempted. This is a beta field and requires enabling VolumeAttributesClass feature (off by default).
255+
ModifyVolumeStatus represents the status object of ControllerModifyVolume operation. When this is unset, there is no ModifyVolume operation being attempted.
256256

257257
<a name="ModifyVolumeStatus"></a>
258258
*ModifyVolumeStatus represents the status object of ControllerModifyVolume operation*

��content/en/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-v1.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -125,7 +125,7 @@ PersistentVolumeSpec is the specification of a persistent volume.
125125

126126
- **volumeAttributesClassName** (string)
127127

128-
Name of VolumeAttributesClass to which this persistent volume belongs. Empty value is not allowed. When this field is not set, it indicates that this volume does not belong to any VolumeAttributesClass. This field is mutable and can be changed by the CSI driver after a volume has been updated successfully to a new class. For an unbound PersistentVolume, the volumeAttributesClassName will be matched with unbound PersistentVolumeClaims during the binding process. This is a beta field and requires enabling VolumeAttributesClass feature (off by default).
128+
Name of VolumeAttributesClass to which this persistent volume belongs. Empty value is not allowed. When this field is not set, it indicates that this volume does not belong to any VolumeAttributesClass. This field is mutable and can be changed by the CSI driver after a volume has been updated successfully to a new class. For an unbound PersistentVolume, the volumeAttributesClassName will be matched with unbound PersistentVolumeClaims during the binding process.
129129

130130
- **volumeMode** (string)
131131

‎content/en/docs/reference/kubernetes-api/config-and-storage-resources/volume-attachment-v1.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ VolumeAttachmentStatus is the status of a VolumeAttachment request.
110110

111111
errorCode is a numeric gRPC code representing the error encountered during Attach or Detach operations.
112112

113-
This is an optional, alpha field that requires the MutableCSINodeAllocatableCount feature gate being enabled to be set.
113+
This is an optional, beta field that requires the MutableCSINodeAllocatableCount feature gate being enabled to be set.
114114

115115
- **attachError.message** (string)
116116

@@ -138,7 +138,7 @@ VolumeAttachmentStatus is the status of a VolumeAttachment request.
138138

139139
errorCode is a numeric gRPC code representing the error encountered during Attach or Detach operations.
140140

141-
This is an optional, alpha field that requires the MutableCSINodeAllocatableCount feature gate being enabled to be set.
141+
This is an optional, beta field that requires the MutableCSINodeAllocatableCount feature gate being enabled to be set.
142142

143143
- **detachError.message** (string)
144144

0 commit comments

Comments
 (0)