API Ref v1.22 alpha.3

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

@@ -630,6 +630,8 @@ PATCH /apis/certificates.k8s.io/v1/certificatesigningrequests/{name}
 
 200 (<a href="{{< ref "../authentication-resources/certificate-signing-request-v1#CertificateSigningRequest" >}}">CertificateSigningRequest</a>): OK
 
+201 (<a href="{{< ref "../authentication-resources/certificate-signing-request-v1#CertificateSigningRequest" >}}">CertificateSigningRequest</a>): Created
+
 401: Unauthorized
 
 
@@ -678,6 +680,8 @@ PATCH /apis/certificates.k8s.io/v1/certificatesigningrequests/{name}/approval
 
 200 (<a href="{{< ref "../authentication-resources/certificate-signing-request-v1#CertificateSigningRequest" >}}">CertificateSigningRequest</a>): OK
 
+201 (<a href="{{< ref "../authentication-resources/certificate-signing-request-v1#CertificateSigningRequest" >}}">CertificateSigningRequest</a>): Created
+
 401: Unauthorized
 
 
@@ -726,6 +730,8 @@ PATCH /apis/certificates.k8s.io/v1/certificatesigningrequests/{name}/status
 
 200 (<a href="{{< ref "../authentication-resources/certificate-signing-request-v1#CertificateSigningRequest" >}}">CertificateSigningRequest</a>): OK
 
+201 (<a href="{{< ref "../authentication-resources/certificate-signing-request-v1#CertificateSigningRequest" >}}">CertificateSigningRequest</a>): Created
+
 401: Unauthorized
 
 

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

@@ -416,6 +416,8 @@ PATCH /api/v1/namespaces/{namespace}/serviceaccounts/{name}
 
 200 (<a href="{{< ref "../authentication-resources/service-account-v1#ServiceAccount" >}}">ServiceAccount</a>): OK
 
+201 (<a href="{{< ref "../authentication-resources/service-account-v1#ServiceAccount" >}}">ServiceAccount</a>): Created
+
 401: Unauthorized
 
 

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

@@ -40,12 +40,15 @@ TokenRequest requests a token for a given service account.
 
 - **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
 
+  Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **spec** (<a href="{{< ref "../authentication-resources/token-request-v1#TokenRequestSpec" >}}">TokenRequestSpec</a>), required
 
+  Spec holds information about the request being evaluated
 
 - **status** (<a href="{{< ref "../authentication-resources/token-request-v1#TokenRequestStatus" >}}">TokenRequestStatus</a>)
 
+  Status is filled in by the server and indicates whether the token can be authenticated.
 
 
 

content/en/docs/reference/kubernetes-api/authentication-resources/token-review-v1.md

@@ -40,6 +40,7 @@ TokenReview attempts to authenticate a token to a known user. Note: TokenReview
 
 - **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
 
+  Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **spec** (<a href="{{< ref "../authentication-resources/token-review-v1#TokenReviewSpec" >}}">TokenReviewSpec</a>), required
 

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

@@ -351,6 +351,8 @@ PATCH /apis/rbac.authorization.k8s.io/v1/clusterrolebindings/{name}
 
 200 (<a href="{{< ref "../authorization-resources/cluster-role-binding-v1#ClusterRoleBinding" >}}">ClusterRoleBinding</a>): OK
 
+201 (<a href="{{< ref "../authorization-resources/cluster-role-binding-v1#ClusterRoleBinding" >}}">ClusterRoleBinding</a>): Created
+
 401: Unauthorized
 
 

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

@@ -66,11 +66,11 @@ ClusterRole is a cluster level, logical grouping of PolicyRules that can be refe
 
   - **rules.resources** ([]string)
 
-    Resources is a list of resources this rule applies to.  ResourceAll represents all resources.
+    Resources is a list of resources this rule applies to. '*' represents all resources.
 
   - **rules.verbs** ([]string), required
 
-    Verbs is a list of Verbs that apply to ALL the ResourceKinds and AttributeRestrictions contained in this rule.  VerbAll represents all kinds.
+    Verbs is a list of Verbs that apply to ALL the ResourceKinds and AttributeRestrictions contained in this rule. '*' represents all verbs.
 
   - **rules.resourceNames** ([]string)
 
@@ -347,6 +347,8 @@ PATCH /apis/rbac.authorization.k8s.io/v1/clusterroles/{name}
 
 200 (<a href="{{< ref "../authorization-resources/cluster-role-v1#ClusterRole" >}}">ClusterRole</a>): OK
 
+201 (<a href="{{< ref "../authorization-resources/cluster-role-v1#ClusterRole" >}}">ClusterRole</a>): Created
+
 401: Unauthorized
 
 

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

@@ -40,6 +40,7 @@ LocalSubjectAccessReview checks whether or not a user or group can perform an ac
 
 - **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
 
+  Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **spec** (<a href="{{< ref "../authorization-resources/subject-access-review-v1#SubjectAccessReviewSpec" >}}">SubjectAccessReviewSpec</a>), required
 

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

@@ -444,6 +444,8 @@ PATCH /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/rolebindings/{na
 
 200 (<a href="{{< ref "../authorization-resources/role-binding-v1#RoleBinding" >}}">RoleBinding</a>): OK
 
+201 (<a href="{{< ref "../authorization-resources/role-binding-v1#RoleBinding" >}}">RoleBinding</a>): Created
+
 401: Unauthorized
 
 

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

@@ -55,11 +55,11 @@ Role is a namespaced, logical grouping of PolicyRules that can be referenced as
 
   - **rules.resources** ([]string)
 
-    Resources is a list of resources this rule applies to.  ResourceAll represents all resources.
+    Resources is a list of resources this rule applies to. '*' represents all resources.
 
   - **rules.verbs** ([]string), required
 
-    Verbs is a list of Verbs that apply to ALL the ResourceKinds and AttributeRestrictions contained in this rule.  VerbAll represents all kinds.
+    Verbs is a list of Verbs that apply to ALL the ResourceKinds and AttributeRestrictions contained in this rule. '*' represents all verbs.
 
   - **rules.resourceNames** ([]string)
 
@@ -429,6 +429,8 @@ PATCH /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles/{name}
 
 200 (<a href="{{< ref "../authorization-resources/role-v1#Role" >}}">Role</a>): OK
 
+201 (<a href="{{< ref "../authorization-resources/role-v1#Role" >}}">Role</a>): Created
+
 401: Unauthorized
 
 

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

@@ -40,6 +40,7 @@ SelfSubjectAccessReview checks whether or the current user can perform an action
 
 - **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
 
+  Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **spec** (<a href="{{< ref "../authorization-resources/self-subject-access-review-v1#SelfSubjectAccessReviewSpec" >}}">SelfSubjectAccessReviewSpec</a>), required
 

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

@@ -40,6 +40,7 @@ SelfSubjectRulesReview enumerates the set of actions the current user can perfor
 
 - **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
 
+  Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **spec** (<a href="{{< ref "../authorization-resources/self-subject-rules-review-v1#SelfSubjectRulesReviewSpec" >}}">SelfSubjectRulesReviewSpec</a>), required
 
@@ -105,7 +106,7 @@ SelfSubjectRulesReview enumerates the set of actions the current user can perfor
 
 ## SelfSubjectRulesReviewSpec {#SelfSubjectRulesReviewSpec}
 
-
+SelfSubjectRulesReviewSpec defines the specification for SelfSubjectRulesReview.
 
 <hr>
 

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

@@ -40,6 +40,7 @@ SubjectAccessReview checks whether or not a user or group can perform an action.
 
 - **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
 
+  Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **spec** (<a href="{{< ref "../authorization-resources/subject-access-review-v1#SubjectAccessReviewSpec" >}}">SubjectAccessReviewSpec</a>), required
 

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

@@ -40,6 +40,7 @@ APIService represents a server for a particular GroupVersion. Name must be "vers
 
 - **metadata** (<a href="{{< ref "../common-definitions/object-meta#ObjectMeta" >}}">ObjectMeta</a>)
 
+  Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **spec** (<a href="{{< ref "../cluster-resources/api-service-v1#APIServiceSpec" >}}">APIServiceSpec</a>)
 
@@ -166,9 +167,11 @@ APIServiceList is a list of APIService objects.
 
 - **metadata** (<a href="{{< ref "../common-definitions/list-meta#ListMeta" >}}">ListMeta</a>)
 
+  Standard list metadata More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
 - **items** ([]<a href="{{< ref "../cluster-resources/api-service-v1#APIService" >}}">APIService</a>), required
 
+  Items is the list of APIService
 
 
 
@@ -486,6 +489,8 @@ PATCH /apis/apiregistration.k8s.io/v1/apiservices/{name}
 
 200 (<a href="{{< ref "../cluster-resources/api-service-v1#APIService" >}}">APIService</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/api-service-v1#APIService" >}}">APIService</a>): Created
+
 401: Unauthorized
 
 
@@ -534,6 +539,8 @@ PATCH /apis/apiregistration.k8s.io/v1/apiservices/{name}/status
 
 200 (<a href="{{< ref "../cluster-resources/api-service-v1#APIService" >}}">APIService</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/api-service-v1#APIService" >}}">APIService</a>): Created
+
 401: Unauthorized
 
 

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

@@ -492,6 +492,8 @@ PATCH /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}
 
 200 (<a href="{{< ref "../cluster-resources/event-v1#Event" >}}">Event</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/event-v1#Event" >}}">Event</a>): Created
+
 401: Unauthorized
 
 

content/en/docs/reference/kubernetes-api/cluster-resources/flow-schema-v1beta1.md

@@ -588,6 +588,8 @@ PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta1/flowschemas/{name}
 
 200 (<a href="{{< ref "../cluster-resources/flow-schema-v1beta1#FlowSchema" >}}">FlowSchema</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/flow-schema-v1beta1#FlowSchema" >}}">FlowSchema</a>): Created
+
 401: Unauthorized
 
 
@@ -636,6 +638,8 @@ PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta1/flowschemas/{name}/status
 
 200 (<a href="{{< ref "../cluster-resources/flow-schema-v1beta1#FlowSchema" >}}">FlowSchema</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/flow-schema-v1beta1#FlowSchema" >}}">FlowSchema</a>): Created
+
 401: Unauthorized
 
 

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

@@ -442,6 +442,8 @@ PATCH /apis/coordination.k8s.io/v1/namespaces/{namespace}/leases/{name}
 
 200 (<a href="{{< ref "../cluster-resources/lease-v1#Lease" >}}">Lease</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/lease-v1#Lease" >}}">Lease</a>): Created
+
 401: Unauthorized
 
 

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

@@ -492,6 +492,8 @@ PATCH /api/v1/namespaces/{name}
 
 200 (<a href="{{< ref "../cluster-resources/namespace-v1#Namespace" >}}">Namespace</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/namespace-v1#Namespace" >}}">Namespace</a>): Created
+
 401: Unauthorized
 
 
@@ -540,6 +542,8 @@ PATCH /api/v1/namespaces/{name}/status
 
 200 (<a href="{{< ref "../cluster-resources/namespace-v1#Namespace" >}}">Namespace</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/namespace-v1#Namespace" >}}">Namespace</a>): Created
+
 401: Unauthorized
 
 

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

@@ -352,7 +352,7 @@ NodeStatus is information about the current status of a node.
   <a name="ContainerImage"></a>
   *Describe a container image*
 
-  - **images.names** ([]string), required
+  - **images.names** ([]string)
 
     Names by which this image is known. e.g. ["k8s.gcr.io/hyperkube:v1.0.7", "dockerhub.io/google_containers/hyperkube:v1.0.7"]
 
@@ -770,6 +770,8 @@ PATCH /api/v1/nodes/{name}
 
 200 (<a href="{{< ref "../cluster-resources/node-v1#Node" >}}">Node</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/node-v1#Node" >}}">Node</a>): Created
+
 401: Unauthorized
 
 
@@ -818,6 +820,8 @@ PATCH /api/v1/nodes/{name}/status
 
 200 (<a href="{{< ref "../cluster-resources/node-v1#Node" >}}">Node</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/node-v1#Node" >}}">Node</a>): Created
+
 401: Unauthorized
 
 

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

@@ -493,6 +493,8 @@ PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta1/prioritylevelconfigurations/{na
 
 200 (<a href="{{< ref "../cluster-resources/priority-level-configuration-v1beta1#PriorityLevelConfiguration" >}}">PriorityLevelConfiguration</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/priority-level-configuration-v1beta1#PriorityLevelConfiguration" >}}">PriorityLevelConfiguration</a>): Created
+
 401: Unauthorized
 
 
@@ -541,6 +543,8 @@ PATCH /apis/flowcontrol.apiserver.k8s.io/v1beta1/prioritylevelconfigurations/{na
 
 200 (<a href="{{< ref "../cluster-resources/priority-level-configuration-v1beta1#PriorityLevelConfiguration" >}}">PriorityLevelConfiguration</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/priority-level-configuration-v1beta1#PriorityLevelConfiguration" >}}">PriorityLevelConfiguration</a>): Created
+
 401: Unauthorized
 
 

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

@@ -366,6 +366,8 @@ PATCH /apis/node.k8s.io/v1/runtimeclasses/{name}
 
 200 (<a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>): OK
 
+201 (<a href="{{< ref "../cluster-resources/runtime-class-v1#RuntimeClass" >}}">RuntimeClass</a>): Created
+
 401: Unauthorized
 
 

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

@@ -99,6 +99,10 @@ ObjectMeta is metadata that all persisted resources must have, which includes al
 
     Operation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.
 
+  - **managedFields.subresource** (string)
+
+    Subresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between managers, even if they share the same name. For example, a status update will be distinct from a regular update using the same manager name. Note that the APIVersion field is not related to the Subresource field and it always corresponds to the version of the main resource.
+
   - **managedFields.time** (Time)
 
     Time is timestamp of when these fields were set. It should always be empty if Operation is 'Apply'

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

@@ -28,7 +28,7 @@ guide. You can file document formatting bugs against the
 
 ## allowWatchBookmarks {#allowWatchBookmarks}
 
-allowWatchBookmarks requests watch events with type "BOOKMARK". Servers that do not implement bookmarks may ignore this flag and bookmarks are sent at the server's discretion. Clients should not assume bookmarks are returned at any specific interval, nor may they assume the server will send any BOOKMARK event during a session. If this is not a watch, this field is ignored. If the feature gate WatchBookmarks is not enabled in apiserver, this field is ignored.
+allowWatchBookmarks requests watch events with type "BOOKMARK". Servers that do not implement bookmarks may ignore this flag and bookmarks are sent at the server's discretion. Clients should not assume bookmarks are returned at any specific interval, nor may they assume the server will send any BOOKMARK event during a session. If this is not a watch, this field is ignored.
 
 <hr>
 

content/en/docs/reference/kubernetes-api/config-and-storage-resources/config-map-v1.md

@@ -414,6 +414,8 @@ PATCH /api/v1/namespaces/{namespace}/configmaps/{name}
 
 200 (<a href="{{< ref "../config-and-storage-resources/config-map-v1#ConfigMap" >}}">ConfigMap</a>): OK
 
+201 (<a href="{{< ref "../config-and-storage-resources/config-map-v1#ConfigMap" >}}">ConfigMap</a>): Created
+
 401: Unauthorized
 
 

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

@@ -64,9 +64,11 @@ CSIDriverSpec is the specification of a CSIDriver.
 
 - **fsGroupPolicy** (string)
 
-  Defines if the underlying volume supports changing ownership and permission of the volume before being mounted. Refer to the specific FSGroupPolicy values for additional details. This field is alpha-level, and is only honored by servers that enable the CSIVolumeFSGroupPolicy feature gate.
+  Defines if the underlying volume supports changing ownership and permission of the volume before being mounted. Refer to the specific FSGroupPolicy values for additional details. This field is beta, and is only honored by servers that enable the CSIVolumeFSGroupPolicy feature gate.
 
   This field is immutable.
+
+  Defaults to ReadWriteOnceWithFSType, which will examine each volume to determine if Kubernetes should modify ownership and permissions of the volume. With the default policy the defined fsGroup will only be applied if a fstype is defined and the volume's access mode contains ReadWriteOnce.
 
 - **podInfoOnMount** (boolean)
 
@@ -399,6 +401,8 @@ PATCH /apis/storage.k8s.io/v1/csidrivers/{name}
 
 200 (<a href="{{< ref "../config-and-storage-resources/csi-driver-v1#CSIDriver" >}}">CSIDriver</a>): OK
 
+201 (<a href="{{< ref "../config-and-storage-resources/csi-driver-v1#CSIDriver" >}}">CSIDriver</a>): Created
+
 401: Unauthorized
 
 

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

@@ -355,6 +355,8 @@ PATCH /apis/storage.k8s.io/v1/csinodes/{name}
 
 200 (<a href="{{< ref "../config-and-storage-resources/csi-node-v1#CSINode" >}}">CSINode</a>): OK
 
+201 (<a href="{{< ref "../config-and-storage-resources/csi-node-v1#CSINode" >}}">CSINode</a>): Created
+
 401: Unauthorized
 
 

content/en/docs/reference/kubernetes-api/config-and-storage-resources/csi-storage-capacity-v1beta1.md

@@ -436,6 +436,8 @@ PATCH /apis/storage.k8s.io/v1beta1/namespaces/{namespace}/csistoragecapacities/{
 
 200 (<a href="{{< ref "../config-and-storage-resources/csi-storage-capacity-v1beta1#CSIStorageCapacity" >}}">CSIStorageCapacity</a>): OK
 
+201 (<a href="{{< ref "../config-and-storage-resources/csi-storage-capacity-v1beta1#CSIStorageCapacity" >}}">CSIStorageCapacity</a>): Created
+
 401: Unauthorized
 
 

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

@@ -604,6 +604,8 @@ PATCH /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}
 
 200 (<a href="{{< ref "../config-and-storage-resources/persistent-volume-claim-v1#PersistentVolumeClaim" >}}">PersistentVolumeClaim</a>): OK
 
+201 (<a href="{{< ref "../config-and-storage-resources/persistent-volume-claim-v1#PersistentVolumeClaim" >}}">PersistentVolumeClaim</a>): Created
+
 401: Unauthorized
 
 
@@ -657,6 +659,8 @@ PATCH /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}/status
 
 200 (<a href="{{< ref "../config-and-storage-resources/persistent-volume-claim-v1#PersistentVolumeClaim" >}}">PersistentVolumeClaim</a>): OK
 
+201 (<a href="{{< ref "../config-and-storage-resources/persistent-volume-claim-v1#PersistentVolumeClaim" >}}">PersistentVolumeClaim</a>): Created
+
 401: Unauthorized