Skip to content

Commit 56828ee

Browse files
authored
Merge pull request #42244 from feloy/dev-1.28-api-ref
V1.28 api reference multi-pages
2 parents 4d6a4c2 + 1e2ed88 commit 56828ee

25 files changed

+8151
-24111
lines changed

api-ref-assets/api/swagger.json

Lines changed: 7820 additions & 23666 deletions
Large diffs are not rendered by default.

api-ref-assets/config/fields.yaml

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,7 @@
8888
- fields:
8989
- nominatedNodeName
9090
- hostIP
91+
- hostIPs
9192
- startTime
9293
- phase
9394
- message
@@ -99,6 +100,7 @@
99100
- initContainerStatuses
100101
- containerStatuses
101102
- ephemeralContainerStatuses
103+
- resourceClaimStatuses
102104
- resize
103105

104106
- definition: io.k8s.api.core.v1.Container
@@ -137,6 +139,7 @@
137139
- livenessProbe
138140
- readinessProbe
139141
- startupProbe
142+
- restartPolicy
140143
- name: Security Context
141144
fields:
142145
- securityContext
@@ -228,6 +231,7 @@
228231
fields:
229232
- terminationMessagePath
230233
- terminationMessagePolicy
234+
- restartPolicy
231235
- name: Debugging
232236
fields:
233237
- stdin
@@ -393,9 +397,14 @@
393397
fields:
394398
- selector
395399
- manualSelector
396-
- name: Alpha level
400+
- name: Beta level
397401
fields:
398402
- podFailurePolicy
403+
- name: Alpha level
404+
fields:
405+
- backoffLimitPerIndex
406+
- maxFailedIndexes
407+
- podReplacementPolicy
399408

400409
- definition: io.k8s.api.batch.v1.JobStatus
401410
field_categories:
@@ -411,6 +420,10 @@
411420
- name: Beta level
412421
fields:
413422
- ready
423+
- name: Alpha level
424+
fields:
425+
- failedIndexes
426+
- terminating
414427

415428
- definition: io.k8s.api.batch.v1.CronJobSpec
416429
field_categories:

api-ref-assets/config/toc.yaml

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -153,7 +153,7 @@ parts:
153153
version: v1alpha1
154154
- name: SelfSubjectReview
155155
group: authentication.k8s.io
156-
version: v1beta1
156+
version: v1
157157
- name: Authorization Resources
158158
chapters:
159159
- name: LocalSubjectAccessReview
@@ -168,9 +168,6 @@ parts:
168168
- name: SubjectAccessReview
169169
group: authorization.k8s.io
170170
version: v1
171-
- name: SelfSubjectReview
172-
group: authentication.k8s.io
173-
version: v1alpha1
174171
- name: ClusterRole
175172
group: rbac.authorization.k8s.io
176173
version: v1
@@ -218,7 +215,7 @@ parts:
218215
version: v1
219216
- name: ValidatingAdmissionPolicy
220217
group: admissionregistration.k8s.io
221-
version: v1alpha1
218+
version: v1beta1
222219
otherDefinitions:
223220
- ValidatingAdmissionPolicyList
224221
- ValidatingAdmissionPolicyBinding

api-ref-generator

Submodule api-ref-generator updated 142 files
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.

0 commit comments

Comments
 (0)