Skip to content

Commit 1e2ed88

Browse files
feloyfeloy
committed
Generated content
1 parent f301c27 commit 1e2ed88

21 files changed

+314
-438
lines changed

‎content/en/docs/reference/kubernetes-api/authentication-resources/self-subject-review-v1beta1.md renamed to ‎content/en/docs/reference/kubernetes-api/authentication-resources/self-subject-review-v1.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
api_metadata:
3-
apiVersion: "authentication.k8s.io/v1beta1"
4-
import: "k8s.io/api/authentication/v1beta1"
3+
apiVersion: "authentication.k8s.io/v1"
4+
import: "k8s.io/api/authentication/v1"
55
kind: "SelfSubjectReview"
66
content_type: "api_reference"
77
description: "SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request."
8-
title: "SelfSubjectReview v1beta1"
8+
title: "SelfSubjectReview"
99
weight: 6
1010
auto_generated: true
1111
---
@@ -21,9 +21,9 @@ guide. You can file document formatting bugs against the
2121
[reference-docs](https://github.com/kubernetes-sigs/reference-docs/) project.
2222
-->
2323

24-
`apiVersion: authentication.k8s.io/v1beta1`
24+
`apiVersion: authentication.k8s.io/v1`
2525

26-
`import "k8s.io/api/authentication/v1beta1"`
26+
`import "k8s.io/api/authentication/v1"`
2727

2828

2929
## SelfSubjectReview {#SelfSubjectReview}
@@ -32,7 +32,7 @@ SelfSubjectReview contains the user information that the kube-apiserver has abou
3232

3333
<hr>
3434

35-
- **apiVersion**: authentication.k8s.io/v1beta1
35+
- **apiVersion**: authentication.k8s.io/v1
3636

3737

3838
- **kind**: SelfSubjectReview
@@ -42,7 +42,7 @@ SelfSubjectReview contains the user information that the kube-apiserver has abou
4242

4343
Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
4444

45-
- **status** (<a href="{{< ref "../authentication-resources/self-subject-review-v1beta1#SelfSubjectReviewStatus" >}}">SelfSubjectReviewStatus</a>)
45+
- **status** (<a href="{{< ref "../authentication-resources/self-subject-review-v1#SelfSubjectReviewStatus" >}}">SelfSubjectReviewStatus</a>)
4646

4747
Status is filled in by the server with the user attributes.
4848

@@ -98,12 +98,12 @@ SelfSubjectReviewStatus is filled by the kube-apiserver and sent back to a user.
9898

9999
#### HTTP Request
100100

101-
POST /apis/authentication.k8s.io/v1beta1/selfsubjectreviews
101+
POST /apis/authentication.k8s.io/v1/selfsubjectreviews
102102

103103
#### Parameters
104104

105105

106-
- **body**: <a href="{{< ref "../authentication-resources/self-subject-review-v1beta1#SelfSubjectReview" >}}">SelfSubjectReview</a>, required
106+
- **body**: <a href="{{< ref "../authentication-resources/self-subject-review-v1#SelfSubjectReview" >}}">SelfSubjectReview</a>, required
107107

108108

109109

@@ -132,11 +132,11 @@ POST /apis/authentication.k8s.io/v1beta1/selfsubjectreviews
132132
#### Response
133133

134134

135-
200 (<a href="{{< ref "../authentication-resources/self-subject-review-v1beta1#SelfSubjectReview" >}}">SelfSubjectReview</a>): OK
135+
200 (<a href="{{< ref "../authentication-resources/self-subject-review-v1#SelfSubjectReview" >}}">SelfSubjectReview</a>): OK
136136

137-
201 (<a href="{{< ref "../authentication-resources/self-subject-review-v1beta1#SelfSubjectReview" >}}">SelfSubjectReview</a>): Created
137+
201 (<a href="{{< ref "../authentication-resources/self-subject-review-v1#SelfSubjectReview" >}}">SelfSubjectReview</a>): Created
138138

139-
202 (<a href="{{< ref "../authentication-resources/self-subject-review-v1beta1#SelfSubjectReview" >}}">SelfSubjectReview</a>): Accepted
139+
202 (<a href="{{< ref "../authentication-resources/self-subject-review-v1#SelfSubjectReview" >}}">SelfSubjectReview</a>): Accepted
140140

141141
401: Unauthorized
142142

‎content/en/docs/reference/kubernetes-api/authorization-resources/cluster-role-binding-v1.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ api_metadata:
66
content_type: "api_reference"
77
description: "ClusterRoleBinding references a ClusterRole, but not contain it."
88
title: "ClusterRoleBinding"
9-
weight: 7
9+
weight: 6
1010
auto_generated: true
1111
---
1212

@@ -44,7 +44,7 @@ ClusterRoleBinding references a ClusterRole, but not contain it. It can referen
4444

4545
- **roleRef** (RoleRef), required
4646

47-
RoleRef can only reference a ClusterRole in the global namespace. If the RoleRef cannot be resolved, the Authorizer must return an error.
47+
RoleRef can only reference a ClusterRole in the global namespace. If the RoleRef cannot be resolved, the Authorizer must return an error. This field is immutable.
4848

4949
<a name="RoleRef"></a>
5050
*RoleRef contains information that points to the role being used*

‎content/en/docs/reference/kubernetes-api/authorization-resources/cluster-role-v1.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: "ClusterRole is a cluster level, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding or ClusterRoleBinding."
88
title: "ClusterRole"
9-
weight: 6
9+
weight: 5
1010
auto_generated: true
1111
---
1212

‎content/en/docs/reference/kubernetes-api/authorization-resources/role-binding-v1.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ api_metadata:
66
content_type: "api_reference"
77
description: "RoleBinding references a role, but does not contain it."
88
title: "RoleBinding"
9-
weight: 9
9+
weight: 8
1010
auto_generated: true
1111
---
1212

@@ -44,7 +44,7 @@ RoleBinding references a role, but does not contain it. It can reference a Role
4444

4545
- **roleRef** (RoleRef), required
4646

47-
RoleRef can reference a Role in the current namespace or a ClusterRole in the global namespace. If the RoleRef cannot be resolved, the Authorizer must return an error.
47+
RoleRef can reference a Role in the current namespace or a ClusterRole in the global namespace. If the RoleRef cannot be resolved, the Authorizer must return an error. This field is immutable.
4848

4949
<a name="RoleRef"></a>
5050
*RoleRef contains information that points to the role being used*

‎content/en/docs/reference/kubernetes-api/authorization-resources/role-v1.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: "Role is a namespaced, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding."
88
title: "Role"
9-
weight: 8
9+
weight: 7
1010
auto_generated: true
1111
---
1212

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

Lines changed: 0 additions & 142 deletions
This file was deleted.

‎content/en/docs/reference/kubernetes-api/cluster-resources/priority-level-configuration-v1beta3.md

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,27 @@ PriorityLevelConfigurationSpec specifies the configuration of a priority level.
6464

6565
`type` indicates whether this priority level is subject to limitation on request execution. A value of `"Exempt"` means that requests of this priority level are not subject to a limit (and thus are never queued) and do not detract from the capacity made available to other priority levels. A value of `"Limited"` means that (a) requests of this priority level _are_ subject to limits and (b) some of the server's limited capacity is made available exclusively to this priority level. Required.
6666

67+
- **exempt** (ExemptPriorityLevelConfiguration)
68+
69+
`exempt` specifies how requests are handled for an exempt priority level. This field MUST be empty if `type` is `"Limited"`. This field MAY be non-empty if `type` is `"Exempt"`. If empty and `type` is `"Exempt"` then the default values for `ExemptPriorityLevelConfiguration` apply.
70+
71+
<a name="ExemptPriorityLevelConfiguration"></a>
72+
*ExemptPriorityLevelConfiguration describes the configurable aspects of the handling of exempt requests. In the mandatory exempt configuration object the values in the fields here can be modified by authorized users, unlike the rest of the `spec`.*
73+
74+
- **exempt.lendablePercent** (int32)
75+
76+
`lendablePercent` prescribes the fraction of the level's NominalCL that can be borrowed by other priority levels. This value of this field must be between 0 and 100, inclusive, and it defaults to 0. The number of seats that other levels can borrow from this level, known as this level's LendableConcurrencyLimit (LendableCL), is defined as follows.
77+
78+
LendableCL(i) = round( NominalCL(i) * lendablePercent(i)/100.0 )
79+
80+
- **exempt.nominalConcurrencyShares** (int32)
81+
82+
`nominalConcurrencyShares` (NCS) contributes to the computation of the NominalConcurrencyLimit (NominalCL) of this level. This is the number of execution seats nominally reserved for this priority level. This DOES NOT limit the dispatching from this priority level but affects the other priority levels through the borrowing mechanism. The server's concurrency limit (ServerCL) is divided among all the priority levels in proportion to their NCS values:
83+
84+
NominalCL(i) = ceil( ServerCL * NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)
85+
86+
Bigger numbers mean a larger nominal concurrency limit, at the expense of every other priority level. This field has a default value of zero.
87+
6788
- **limited** (LimitedPriorityLevelConfiguration)
6889

6990
`limited` specifies how requests are handled for a Limited priority level. This field must be non-empty if and only if `type` is `"Limited"`.
@@ -121,9 +142,9 @@ PriorityLevelConfigurationSpec specifies the configuration of a priority level.
121142

122143
`nominalConcurrencyShares` (NCS) contributes to the computation of the NominalConcurrencyLimit (NominalCL) of this level. This is the number of execution seats available at this priority level. This is used both for requests dispatched from this priority level as well as requests dispatched from other priority levels borrowing seats from this level. The server's concurrency limit (ServerCL) is divided among the Limited priority levels in proportion to their NCS values:
123144

124-
NominalCL(i) = ceil( ServerCL * NCS(i) / sum_ncs ) sum_ncs = sum[limited priority level k] NCS(k)
145+
NominalCL(i) = ceil( ServerCL * NCS(i) / sum_ncs ) sum_ncs = sum[priority level k] NCS(k)
125146

126-
Bigger numbers mean a larger nominal concurrency limit, at the expense of every other Limited priority level. This field has a default value of 30.
147+
Bigger numbers mean a larger nominal concurrency limit, at the expense of every other priority level. This field has a default value of 30.
127148

128149

129150

‎content/en/docs/reference/kubernetes-api/common-definitions/label-selector.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,6 @@ A label selector is a label query over a set of resources. The result of matchLa
3939

4040
- **matchExpressions.key** (string), required
4141

42-
*Patch strategy: merge on key `key`*
43-
4442
key is the label key that the selector applies to.
4543

4644
- **matchExpressions.operator** (string), required

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

Lines changed: 44 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -163,9 +163,52 @@ PersistentVolumeClaimStatus is the current status of a persistent volume claim.
163163

164164
accessModes contains the actual access modes the volume backing the PVC has. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
165165

166+
- **allocatedResourceStatuses** (map[string]string)
167+
168+
allocatedResourceStatuses stores status of resource being resized for the given PVC. Key names follow standard Kubernetes label syntax. Valid values are either:
169+
* Un-prefixed keys:
170+
- storage - the capacity of the volume.
171+
* Custom resources must use implementation-defined prefixed names such as "example.com/my-custom-resource"
172+
Apart from above values - keys that are unprefixed or have kubernetes.io prefix are considered reserved and hence may not be used.
173+
174+
ClaimResourceStatus can be in any of following states:
175+
- ControllerResizeInProgress:
176+
State set when resize controller starts resizing the volume in control-plane.
177+
- ControllerResizeFailed:
178+
State set when resize has failed in resize controller with a terminal error.
179+
- NodeResizePending:
180+
State set when resize controller has finished resizing the volume but further resizing of
181+
volume is needed on the node.
182+
- NodeResizeInProgress:
183+
State set when kubelet starts resizing the volume.
184+
- NodeResizeFailed:
185+
State set when resizing has failed in kubelet with a terminal error. Transient errors don't set
186+
NodeResizeFailed.
187+
For example: if expanding a PVC for more capacity - this field can be one of the following states:
188+
- pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeInProgress"
189+
- pvc.status.allocatedResourceStatus['storage'] = "ControllerResizeFailed"
190+
- pvc.status.allocatedResourceStatus['storage'] = "NodeResizePending"
191+
- pvc.status.allocatedResourceStatus['storage'] = "NodeResizeInProgress"
192+
- pvc.status.allocatedResourceStatus['storage'] = "NodeResizeFailed"
193+
When this field is not set, it means that no resize operation is in progress for the given PVC.
194+
195+
A controller that receives PVC update with previously unknown resourceName or ClaimResourceStatus should ignore the update for the purpose it was designed. For example - a controller that only is responsible for resizing capacity of the volume, should ignore PVC updates that change other valid resources associated with PVC.
196+
197+
This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature.
198+
166199
- **allocatedResources** (map[string]<a href="{{< ref "../common-definitions/quantity#Quantity" >}}">Quantity</a>)
167200

168-
allocatedResources is the storage resource within AllocatedResources tracks the capacity allocated to a PVC. It may be larger than the actual capacity when a volume expansion operation is requested. For storage quota, the larger value from allocatedResources and PVC.spec.resources is used. If allocatedResources is not set, PVC.spec.resources alone is used for quota calculation. If a volume expansion capacity request is lowered, allocatedResources is only lowered if there are no expansion operations in progress and if the actual volume capacity is equal or lower than the requested capacity. This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature.
201+
allocatedResources tracks the resources allocated to a PVC including its capacity. Key names follow standard Kubernetes label syntax. Valid values are either:
202+
* Un-prefixed keys:
203+
- storage - the capacity of the volume.
204+
* Custom resources must use implementation-defined prefixed names such as "example.com/my-custom-resource"
205+
Apart from above values - keys that are unprefixed or have kubernetes.io prefix are considered reserved and hence may not be used.
206+
207+
Capacity reported here may be larger than the actual capacity when a volume expansion operation is requested. For storage quota, the larger value from allocatedResources and PVC.spec.resources is used. If allocatedResources is not set, PVC.spec.resources alone is used for quota calculation. If a volume expansion capacity request is lowered, allocatedResources is only lowered if there are no expansion operations in progress and if the actual volume capacity is equal or lower than the requested capacity.
208+
209+
A controller that receives PVC update with previously unknown resourceName should ignore the update for the purpose it was designed. For example - a controller that only is responsible for resizing capacity of the volume, should ignore PVC updates that change other valid resources associated with PVC.
210+
211+
This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature.
169212

170213
- **capacity** (map[string]<a href="{{< ref "../common-definitions/quantity#Quantity" >}}">Quantity</a>)
171214

@@ -212,10 +255,6 @@ PersistentVolumeClaimStatus is the current status of a persistent volume claim.
212255

213256
phase represents the current phase of PersistentVolumeClaim.
214257

215-
- **resizeStatus** (string)
216-
217-
resizeStatus stores status of resize operation. ResizeStatus is not set by default but when expansion is complete resizeStatus is set to empty string by resize controller or kubelet. This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature.
218-
219258

220259

221260

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

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -852,6 +852,13 @@ PersistentVolumeStatus is the current status of a persistent volume.
852852

853853
<hr>
854854

855+
- **lastPhaseTransitionTime** (Time)
856+
857+
lastPhaseTransitionTime is the time the phase transitioned from one to another and automatically resets to current time everytime a volume phase transitions. This is an alpha field and requires enabling PersistentVolumeLastPhaseTransitionTime feature.
858+
859+
<a name="Time"></a>
860+
*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.*
861+
855862
- **message** (string)
856863

857864
message is a human-readable message indicating details about why the volume is in this state.

0 commit comments

Comments
 (0)