beta API version · group apiextensions.k8s.io

apiextensions.k8s.io/v1beta1

Removed in 1.22

No Kubernetes release since 1.22 serves apiVersion: apiextensions.k8s.io/v1beta1. Objects that were stored through it are still in etcd and readable through the replacement version; only manifests and clients that name this version break.

Kinds in apiextensions.k8s.io/v1beta1

Kind	Introduced	Deprecated	Stops being served	Use instead
ConversionReview	1.13	1.19	1.22	apiextensions.k8s.io/v1
CustomResourceDefinition	1.7	1.16	1.22	apiextensions.k8s.io/v1

Served in which releases

Kind162025303537

ConversionReview

CustomResourceDefinition

served served, deprecated exists but off by default not served · 1.16 to 1.37

Migrating off apiextensions.k8s.io/v1beta1

CustomResourceDefinition removed in 1.22

Move to apiextensions.k8s.io/v1, served since 1.16. Existing objects stay readable through the new version.

What changes:

spec.scope is no longer defaulted to Namespaced and must be explicitly specified
spec.version is removed in v1; use spec.versions instead
spec.validation is removed in v1; use spec.versions[*].schema instead
spec.subresources is removed in v1; use spec.versions[*].subresources instead
spec.additionalPrinterColumns is removed in v1; use spec.versions[*].additionalPrinterColumns instead
spec.conversion.webhookClientConfig is moved to spec.conversion.webhook.clientConfig in v1
spec.conversion.conversionReviewVersions is moved to spec.conversion.webhook.conversionReviewVersions in v1
spec.versions[*].schema.openAPIV3Schema is now required when creating v1 CustomResourceDefinition objects, and must be a structural schema
spec.preserveUnknownFields: true is disallowed when creating v1 CustomResourceDefinition objects; it must be specified within schema definitions as x-kubernetes-preserve-unknown-fields: true
In additionalPrinterColumns items, the JSONPath field was renamed to jsonPath in v1 (fixes #66531)

- apiVersion: apiextensions.k8s.io/v1beta1
+ apiVersion: apiextensions.k8s.io/v1
  kind: CustomResourceDefinition

To convert files mechanically: kubectl convert -f old.yaml --output-version apiextensions.k8s.io/v1 (the kubectl-convert plugin, installed separately). Review defaults it fills in.

Other versions of apiextensions.k8s.io

apiextensions.k8s.io/v1 Stable

Check your manifests for apiextensions.k8s.io/v1beta1 and other removed versions →