CustomResourceDefinitionVersion

CustomResourceDefinitionVersion describes a version for CRD.

Schema URL

https://raw.githubusercontent.com/nlamirault/schema-hub/main/schemas/apiextensions.api.k8s.io/CustomResourceDefinitionVersion_v1.json

▶ Usage examples

VS Code / yaml-language-server

# yaml-language-server: $schema=https://raw.githubusercontent.com/nlamirault/schema-hub/main/schemas/apiextensions.api.k8s.io/CustomResourceDefinitionVersion_v1.json

kubeconform

kubeconform -schema-location 'https://raw.githubusercontent.com/nlamirault/schema-hub/main/schemas/{{ .Group }}/{{ .ResourceKind }}_{{ .ResourceAPIVersion }}.json' manifest.yaml

Resource Structure

additionalPrinterColumnsarray

additionalPrinterColumns specifies additional columns returned in Table output. See https://kubernetes.io/docs/reference/using-api/api-concepts/#receiving-resources-as-tables for details. If no columns are specified, a single column displaying the age of the custom resource is used.

deprecatedboolean

deprecated indicates this version of the custom resource API is deprecated. When set to true, API requests to this version receive a warning header in the server response. Defaults to false.

deprecationWarningstring

deprecationWarning overrides the default warning returned to API clients. May only be set when `deprecated` is true. The default warning indicates this version is deprecated and recommends use of the newest served version of equal or greater stability, if one exists.

namestringRequired

name is the version name, e.g. “v1”, “v2beta1”, etc. The custom resources are served under this version at `/apis/<group>/<version>/...` if `served` is true.

schemaobject

schema describes the schema used for validation, pruning, and defaulting of this version of the custom resource.

selectableFieldsarray

selectableFields specifies paths to fields that may be used as field selectors. A maximum of 8 selectable fields are allowed. See https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors

servedbooleanRequired

served is a flag enabling/disabling this version from being served via REST APIs

storagebooleanRequired

storage indicates this version should be used when persisting custom resources to storage. There must be exactly one version with storage=true.

subresourcesobject

subresources specify what subresources this version of the defined custom resource have.