Standard object metadata.

Spec is the specification of the AdminKubeconfigRequest.

Status is the status of the AdminKubeconfigRequest.

ExpirationSeconds is the requested validity duration of the credential. The credential issuer may return a credential with a different validity duration so a client needs to check the ‘expirationTimestamp’ field in a response. Defaults to 1 hour.

Kubeconfig contains the kubeconfig with cluster-admin privileges for the shoot cluster.

ExpirationTimestamp is the expiration timestamp of the returned credential.

Standard object metadata.

Specification of the Backup Bucket.

Most recently observed status of the Backup Bucket.

Standard object metadata.

Spec contains the specification of the Backup Entry.

Status contains the most recently observed status of the Backup Entry.

Standard object metadata.

Spec defines the provider environment properties.

Standard object metadata.

Type is the deployment type.

ProviderConfig contains type-specific configuration. It contains assets that deploy the controller.

Standard object metadata.

Spec contains the specification of this installation. If the object’s deletion timestamp is set, this field is immutable.

Status contains the status of this installation.

Standard object metadata.

Spec contains the specification of this registration. If the object’s deletion timestamp is set, this field is immutable.

Standard object metadata.

Spec contains the specification of this Plant. If the object’s deletion timestamp is set, this field is immutable.

Status contains the status of this Plant.

Standard object metadata.

Spec defines the project properties.

Most recently observed status of the Project.

Standard object metadata.

Spec defines the Quota constraints.

Standard object metadata.

SecretRef is a reference to a secret object in the same or another namespace. This field is immutable.

Quotas is a list of references to Quota objects in the same or another namespace. This field is immutable.

Provider defines the provider type of the SecretBinding. This field is immutable when the SecretBindingProviderValidation feature gate is enabled.

Standard object metadata.

Spec contains the specification of this installation.

Status contains the status of this installation.

Standard object metadata.

Specification of the Shoot cluster. If the object’s deletion timestamp is set, this field is immutable.

Most recently observed status of the Shoot cluster.

Enabled indicates whether the addon is enabled or not.

KubernetesDashboard holds configuration settings for the kubernetes dashboard addon.

NginxIngress holds configuration settings for the nginx-ingress addon.

Name is the name of the plugin.

Config is the configuration of the plugin.

MonitoringEmailReceivers is a list of recipients for alerts

AuditPolicy contains configuration settings for audit policy of the kube-apiserver.

ConfigMapRef is a reference to a ConfigMap object in the same namespace, which contains the audit policy for the kube-apiserver.

Name is an an availability zone name.

UnavailableMachineTypes is a list of machine type names that are not availability in this zone.

UnavailableVolumeTypes is a list of volume type names that are not availability in this zone.

Type is the type of provider.

Region is the region of the bucket.

Provider holds the details of cloud provider of the object store. This field is immutable.

ProviderConfig is the configuration passed to BackupBucket resource.

SecretRef is a reference to a secret that contains the credentials to access object store.

SeedName holds the name of the seed allocated to BackupBucket for running controller. This field is immutable.

ProviderStatus is the configuration passed to BackupBucket resource.

LastOperation holds information about the last operation on the BackupBucket.

LastError holds information about the last occurred error during an operation.

ObservedGeneration is the most recent generation observed for this BackupBucket. It corresponds to the BackupBucket’s generation, which is updated on mutation by the API Server.

GeneratedSecretRef is reference to the secret generated by backup bucket, which will have object store specific credentials.

BucketName is the name of backup bucket for this Backup Entry.

SeedName holds the name of the seed to which this BackupEntry is scheduled

LastOperation holds information about the last operation on the BackupEntry.

LastError holds information about the last occurred error during an operation.

ObservedGeneration is the most recent generation observed for this BackupEntry. It corresponds to the BackupEntry’s generation, which is updated on mutation by the API Server.

SeedName is the name of the seed to which this BackupEntry is currently scheduled. This field is populated at the beginning of a create/reconcile operation. It is used when moving the BackupEntry between seeds.

MigrationStartTime is the time when a migration to a different seed was initiated.

The name of the CRI library. Supported values are docker and containerd.

ContainerRuntimes is the list of the required container runtimes supported for a worker pool.

Type is the cloud type

Region is the cloud region

CABundle is a certificate bundle which will be installed onto every host machine of shoot cluster targeting this profile.

Kubernetes contains constraints regarding allowed values of the ‘kubernetes’ block in the Shoot specification.

MachineImages contains constraints regarding allowed values for machine images in the Shoot specification.

MachineTypes contains constraints regarding allowed values for machine types in the ‘workers’ block in the Shoot specification.

ProviderConfig contains provider-specific configuration for the profile.

Regions contains constraints regarding allowed values for regions and zones.

SeedSelector contains an optional list of labels on Seed resources that marks those seeds whose shoots may use this provider profile. An empty list means that all seeds of the same provider type are supported. This is useful for environments that are of the same type (like openstack) but may have different “instances”/landscapes. Optionally a list of possible providers can be added to enable cross-provider scheduling. By default, the provider type of the seed must match the shoot’s provider.

Type is the name of the provider.

VolumeTypes contains constraints regarding allowed values for volume types in the ‘workers’ block in the Shoot specification.

ScaleDownDelayAfterAdd defines how long after scale up that scale down evaluation resumes (default: 1 hour).

ScaleDownDelayAfterDelete how long after node deletion that scale down evaluation resumes, defaults to scanInterval (default: 0 secs).

ScaleDownDelayAfterFailure how long after scale down failure that scale down evaluation resumes (default: 3 mins).

ScaleDownUnneededTime defines how long a node should be unneeded before it is eligible for scale down (default: 30 mins).

ScaleDownUtilizationThreshold defines the threshold in fraction (0.0 - 1.0) under which a node is being removed (default: 0.5).

ScanInterval how often cluster is reevaluated for scale up or down (default: 10 secs).

Expander defines the algorithm to use during scale up (default: least-waste). See: https://github.com/gardener/autoscaler/blob/machine-controller-manager-provider/cluster-autoscaler/FAQ.md#what-are-expanders.

MaxNodeProvisionTime defines how long CA waits for node to be provisioned (default: 20 mins).

MaxGracefulTerminationSeconds is the number of seconds CA waits for pod termination when trying to scale down a node (default: 600).

IgnoreTaints specifies a list of taint keys to ignore in node templates when considering to scale a node group.

Cloud describes the cloud information

Kubernetes describes kubernetes meta information (e.g., version)

Type of the condition.

Status of the condition, one of True, False, Unknown.

Last time the condition transitioned from one status to another.

Last time the condition was updated.

The reason for the condition’s last transition.

A human readable message indicating details about the transition.

Well-defined error codes in case the condition reports a problem.

Type is the type of the Container Runtime.

ProviderConfig is the configuration passed to container runtime resource.

RegistrationRef is used to reference a ControllerRegistration resource. The name field of the RegistrationRef is immutable.

SeedRef is used to reference a Seed resource. The name field of the SeedRef is immutable.

DeploymentRef is used to reference a ControllerDeployment resource.

Conditions represents the latest available observations of a ControllerInstallations’s current state.

ProviderStatus contains type-specific status.

Policy controls how the controller is deployed. It defaults to ‘OnDemand’.

SeedSelector contains an optional label selector for seeds. Only if the labels match then this controller will be considered for a deployment. An empty list means that all seeds are selected.

DeploymentRefs holds references to ControllerDeployments. Only one element is support now.

Resources is a list of combinations of kinds (DNSProvider, Infrastructure, Generic, …) and their actual types (aws-route53, gcp, auditlog, …).

Deployment contains information for how this controller is deployed.

Kind is the resource kind, for example “OperatingSystemConfig”.

Type is the resource type, for example “coreos” or “ubuntu”.

GloballyEnabled determines if this ControllerResource is required by all Shoot clusters.

ReconcileTimeout defines how long Gardener should wait for the resource reconciliation.

Primary determines if the controller backed by this ControllerRegistration is responsible for the extension resource’s lifecycle. This field defaults to true. There must be exactly one primary controller for this kind/type combination. This field is immutable.

Autoscaling contains the settings related to autoscaling of the Core DNS components running in the data plane of the Shoot cluster.

The mode of the autoscaling to be used for the Core DNS components running in the data plane of the Shoot cluster. Supported values are horizontal and cluster-proportional.

Domain is the external available domain of the Shoot cluster. This domain will be written into the kubeconfig that is handed out to end-users. This field is immutable.

Providers is a list of DNS providers that shall be enabled for this shoot cluster. Only relevant if not a default domain is used.

Include is a list of domains that shall be included.

Exclude is a list of domains that shall be excluded.

Domains contains information about which domains shall be included/excluded for this provider.

Primary indicates that this DNSProvider is used for shoot related domains.

SecretName is a name of a secret containing credentials for the stated domain and the provider. When not specified, the Gardener will use the cloud provider credentials referenced by the Shoot and try to find respective credentials there (primary provider only). Specifying this field may override this behavior, i.e. forcing the Gardener to only look into the given secret.

Type is the DNS provider type.

Zones contains information about which hosted zones shall be included/excluded for this provider.

Name of the volume to make it referencable.

Type is the type of the volume.

VolumeSize is the size of the volume.

Encrypted determines if the volume should be encrypted.

Name is the name of the ControllerDeployment that is being referred to.

Name is the name of the endpoint

URL is the url of the endpoint

Purpose is the purpose of the endpoint

Version is the version identifier.

ExpirationDate defines the time at which this version expires.

Classification defines the state of a version (preview, supported, deprecated)

Type is the type of the extension resource.

ProviderConfig is the configuration passed to extension resource.

Disabled allows to disable extensions that were marked as ‘globally enabled’ by Gardener administrators.

ID is the Docker container id of the Gardener which last acted on a resource.

Name is the hostname (pod name) of the Gardener which last acted on a resource.

Version is the version of the Gardener which last acted on a resource.

Enabled specifies whether the Shoot needs to be hibernated or not. If it is true, the Shoot’s desired state is to be hibernated. If it is false or nil, the Shoot’s desired state is to be awakened.

Schedules determine the hibernation schedules.

Start is a Cron spec at which time a Shoot will be hibernated.

End is a Cron spec at which time a Shoot will be woken up.

Location is the time location in which both start and and shall be evaluated.

The period after which a ready pod transition is considered to be the first.

The configurable window at which the controller will choose the highest recommendation for autoscaling.

The configurable period at which the horizontal pod autoscaler considers a Pod “not yet ready” given that it’s unready and it has transitioned to unready during that time.

The period for syncing the number of pods in horizontal pod autoscaler.

The minimum change (from 1.0) in the desired-to-actual metrics ratio for the horizontal pod autoscaler to consider scaling.

Domain specifies the IngressDomain of the Seed cluster pointing to the ingress controller endpoint. It will be used to construct ingress URLs for system applications running in Shoot clusters. Once set this field is immutable.

Controller configures a Gardener managed Ingress Controller listening on the ingressDomain

Kind defines which kind of IngressController to use, for example nginx

ProviderConfig specifies infrastructure specific configuration for the ingressController

(Members of KubernetesConfig are embedded into this type.)

AdmissionPlugins contains the list of user-defined admission plugins (additional to those managed by Gardener), and, if desired, the corresponding configuration.

APIAudiences are the identifiers of the API. The service account token authenticator will validate that tokens used against the API are bound to at least one of these audiences. Defaults to [“kubernetes”].

AuditConfig contains configuration settings for the audit of the kube-apiserver.

EnableBasicAuthentication defines whether basic authentication should be enabled for this cluster or not.

OIDCConfig contains configuration settings for the OIDC provider.

RuntimeConfig contains information about enabled or disabled APIs.

ServiceAccountConfig contains configuration settings for the service account handling of the kube-apiserver.

WatchCacheSizes contains configuration of the API server’s watch cache sizes. Configuring these flags might be useful for large-scale Shoot clusters with a lot of parallel update requests and a lot of watching controllers (e.g. large shooted Seed clusters). When the API server’s watch cache’s capacity is too small to cope with the amount of update requests and watchers for a particular resource, it might happen that controller watches are permanently stopped with too old resource version errors. Starting from kubernetes v1.19, the API server’s watch cache size is adapted dynamically and setting the watch cache size flags will have no effect, except when setting it to 0 (which disables the watch cache).

Requests contains configuration for request-specific settings for the kube-apiserver.

EnableAnonymousAuthentication defines whether anonymous requests to the secure port of the API server should be allowed (flag --anonymous-auth). See: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/

EventTTL controls the amount of time to retain events. Defaults to 1h.

MaxNonMutatingInflight is the maximum number of non-mutating requests in flight at a given time. When the server exceeds this, it rejects requests.

MaxMutatingInflight is the maximum number of mutating requests in flight at a given time. When the server exceeds this, it rejects requests.

(Members of KubernetesConfig are embedded into this type.)

HorizontalPodAutoscalerConfig contains horizontal pod autoscaler configuration settings for the kube-controller-manager.

NodeCIDRMaskSize defines the mask size for node cidr in cluster (default is 24). This field is immutable.

PodEvictionTimeout defines the grace period for deleting pods on failed nodes. Defaults to 2m.

NodeMonitorGracePeriod defines the grace period before an unresponsive node is marked unhealthy.

(Members of KubernetesConfig are embedded into this type.)

Mode specifies which proxy mode to use. defaults to IPTables.

Enabled indicates whether kube-proxy should be deployed or not. Depending on the networking extensions switching kube-proxy off might be rejected. Consulting the respective documentation of the used networking extension is recommended before using this field. defaults to true if not specified.

(Members of KubernetesConfig are embedded into this type.)

KubeMaxPDVols allows to configure the KUBE_MAX_PD_VOLS environment variable for the kube-scheduler. Please find more information here: https://kubernetes.io/docs/concepts/storage/storage-limits/#custom-limits Note that using this field is considered alpha-/experimental-level and is on your own risk. You should be aware of all the side-effects and consequences when changing it.

(Members of KubernetesConfig are embedded into this type.)

CPUCFSQuota allows you to disable/enable CPU throttling for Pods.

CPUManagerPolicy allows to set alternative CPU management policies (default: none).

EvictionHard describes a set of eviction thresholds (e.g. memory.available<1Gi) that if met would trigger a Pod eviction. Default: memory.available: “100Mi/1Gi/5%” nodefs.available: “5%” nodefs.inodesFree: “5%” imagefs.available: “5%” imagefs.inodesFree: “5%”

EvictionMaxPodGracePeriod describes the maximum allowed grace period (in seconds) to use when terminating pods in response to a soft eviction threshold being met. Default: 90

EvictionMinimumReclaim configures the amount of resources below the configured eviction threshold that the kubelet attempts to reclaim whenever the kubelet observes resource pressure. Default: 0 for each resource

EvictionPressureTransitionPeriod is the duration for which the kubelet has to wait before transitioning out of an eviction pressure condition. Default: 4m0s

EvictionSoft describes a set of eviction thresholds (e.g. memory.available<1.5Gi) that if met over a corresponding grace period would trigger a Pod eviction. Default: memory.available: “200Mi/1.5Gi/10%” nodefs.available: “10%” nodefs.inodesFree: “10%” imagefs.available: “10%” imagefs.inodesFree: “10%”

EvictionSoftGracePeriod describes a set of eviction grace periods (e.g. memory.available=1m30s) that correspond to how long a soft eviction threshold must hold before triggering a Pod eviction. Default: memory.available: 1m30s nodefs.available: 1m30s nodefs.inodesFree: 1m30s imagefs.available: 1m30s imagefs.inodesFree: 1m30s

MaxPods is the maximum number of Pods that are allowed by the Kubelet. Default: 110

PodPIDsLimit is the maximum number of process IDs per pod allowed by the kubelet.

ImagePullProgressDeadline describes the time limit under which if no pulling progress is made, the image pulling will be cancelled. Default: 1m

FailSwapOn makes the Kubelet fail to start if swap is enabled on the node. (default true).

KubeReserved is the configuration for resources reserved for kubernetes node components (mainly kubelet and container runtime). When updating these values, be aware that cgroup resizes may not succeed on active worker nodes. Look for the NodeAllocatableEnforced event to determine if the configuration was applied. Default: cpu=80m,memory=1Gi,pid=20k

SystemReserved is the configuration for resources reserved for system processes not managed by kubernetes (e.g. journald). When updating these values, be aware that cgroup resizes may not succeed on active worker nodes. Look for the NodeAllocatableEnforced event to determine if the configuration was applied.

ImageGCHighThresholdPercent describes the percent of the disk usage which triggers image garbage collection. Default: 50

ImageGCLowThresholdPercent describes the percent of the disk to which garbage collection attempts to free. Default: 40

SerializeImagePulls describes whether the images are pulled one at a time. Default: true

MemoryAvailable is the threshold for the free memory on the host server.

ImageFSAvailable is the threshold for the free disk space in the imagefs filesystem (docker images and container writable layers).

ImageFSInodesFree is the threshold for the available inodes in the imagefs filesystem.

NodeFSAvailable is the threshold for the free disk space in the nodefs filesystem (docker volumes, logs, etc).

NodeFSInodesFree is the threshold for the available inodes in the nodefs filesystem.

MemoryAvailable is the threshold for the memory reclaim on the host server.

ImageFSAvailable is the threshold for the disk space reclaim in the imagefs filesystem (docker images and container writable layers).

ImageFSInodesFree is the threshold for the inodes reclaim in the imagefs filesystem.

NodeFSAvailable is the threshold for the disk space reclaim in the nodefs filesystem (docker volumes, logs, etc).

NodeFSInodesFree is the threshold for the inodes reclaim in the nodefs filesystem.

MemoryAvailable is the grace period for the MemoryAvailable eviction threshold.

ImageFSAvailable is the grace period for the ImageFSAvailable eviction threshold.

ImageFSInodesFree is the grace period for the ImageFSInodesFree eviction threshold.

NodeFSAvailable is the grace period for the NodeFSAvailable eviction threshold.

NodeFSInodesFree is the grace period for the NodeFSInodesFree eviction threshold.

CPU is the reserved cpu.

Memory is the reserved memory.

EphemeralStorage is the reserved ephemeral-storage.

PID is the reserved process-ids.

AllowPrivilegedContainers indicates whether privileged containers are allowed in the Shoot (default: true).

ClusterAutoscaler contains the configuration flags for the Kubernetes cluster autoscaler.

KubeAPIServer contains configuration settings for the kube-apiserver.

KubeControllerManager contains configuration settings for the kube-controller-manager.

KubeScheduler contains configuration settings for the kube-scheduler.

KubeProxy contains configuration settings for the kube-proxy.

Kubelet contains configuration settings for the kubelet.

Version is the semantic Kubernetes version to use for the Shoot cluster.

VerticalPodAutoscaler contains the configuration flags for the Kubernetes vertical pod autoscaler.

EnableStaticTokenKubeconfig indicates whether static token kubeconfig secret should be present in garden cluster (default: true).

FeatureGates contains information about enabled feature gates.

(Members of Addon are embedded into this type.)

AuthenticationMode defines the authentication mode for the kubernetes-dashboard.

Version is the semantic Kubernetes version to use for the Plant cluster.

Versions is the list of allowed Kubernetes versions with optional expiration dates for Shoot clusters.

A human readable message indicating details about the last error.

ID of the task which caused this last error

Well-defined error codes of the last error(s).

Last time the error was reported

A human readable message indicating details about the last operation.

Last time the operation state transitioned from one to another.

The progress in percentage (0-100) of the last operation.

Status of the last operation, one of Aborted, Processing, Succeeded, Error, Failed.

Type of the last operation, one of Create, Reconcile, Delete.

Type is the machine type of the worker group.

Image holds information about the machine image to use for all nodes of this pool. It will default to the latest version of the first image stated in the referenced CloudProfile if no value has been provided.

MachineDrainTimeout is the period after which machine is forcefully deleted.

MachineHealthTimeout is the period after which machine is declared failed.

MachineCreationTimeout is the period after which creation of the machine is declared failed.

MaxEvictRetries are the number of eviction retries on a pod after which drain is declared failed, and forceful deletion is triggered.

NodeConditions are the set of conditions if set to true for the period of MachineHealthTimeout, machine will be declared failed.

Name is the name of the image.

Versions contains versions, expiration dates and container runtimes of the machine image

(Members of ExpirableVersion are embedded into this type.)

CRI list of supported container runtime and interfaces supported by this version

CPU is the number of CPUs for this machine type.

GPU is the number of GPUs for this machine type.

Memory is the amount of memory for this machine type.

Name is the name of the machine type.

Storage is the amount of storage associated with the root volume of this machine type.

Usable defines if the machine type can be used for shoot clusters.

Class is the class of the storage type.

StorageSize is the storage size.

Type is the type of the storage.

MinSize is the minimal supported storage size. This overrides any other common minimum size configuration from spec.volumeTypes[*].minSize.

AutoUpdate contains information about which constraints should be automatically updated.

TimeWindow contains information about the time window for maintenance operations.

ConfineSpecUpdateRollout prevents that changes/updates to the shoot specification will be rolled out immediately. Instead, they are rolled out during the shoot’s maintenance time window. There is one exception that will trigger an immediate roll out which is changes to the Spec.Hibernation.Enabled field.

KubernetesVersion indicates whether the patch Kubernetes version may be automatically updated (default: true).

MachineImageVersion indicates whether the machine image version may be automatically updated (default: true).

Begin is the beginning of the time window in the format HHMMSS+ZONE, e.g. “220000+0100”. If not present, a random value will be computed.

End is the end of the time window in the format HHMMSS+ZONE, e.g. “220000+0100”. If not present, the value will be computed based on the “Begin” value.

Alerting contains information about the alerting configuration for the shoot cluster.

Name of the resource reference.

ResourceRef is a reference to a resource.

Type identifies the type of the networking plugin. This field is immutable.

ProviderConfig is the configuration passed to network resource.

Pods is the CIDR of the pod network. This field is immutable.

Nodes is the CIDR of the entire node network. This field is immutable.

Services is the CIDR of the service network. This field is immutable.

(Members of Addon are embedded into this type.)

LoadBalancerSourceRanges is list of allowed IP sources for NginxIngress

Config contains custom configuration for the nginx-ingress-controller configuration. See https://github.com/kubernetes/ingress-nginx/blob/master/docs/user-guide/nginx-configuration/configmap.md#configuration-options

ExternalTrafficPolicy controls the .spec.externalTrafficPolicy value of the load balancer Service exposing the nginx-ingress. Defaults to Cluster.

If set, the OpenID server’s certificate will be verified by one of the authorities in the oidc-ca-file, otherwise the host’s root CA set will be used.

ClientAuthentication can optionally contain client configuration used for kubeconfig generation.

The client ID for the OpenID Connect client, must be set if oidc-issuer-url is set.

If provided, the name of a custom OpenID Connect claim for specifying user groups. The claim value is expected to be a string or array of strings. This flag is experimental, please see the authentication documentation for further details.

If provided, all groups will be prefixed with this value to prevent conflicts with other authentication strategies.

The URL of the OpenID issuer, only HTTPS scheme will be accepted. If set, it will be used to verify the OIDC JSON Web Token (JWT).

key=value pairs that describes a required claim in the ID Token. If set, the claim is verified to be present in the ID Token with a matching value.

List of allowed JOSE asymmetric signing algorithms. JWTs with a ‘alg’ header value not in this list will be rejected. Values are defined by RFC 7518 https://tools.ietf.org/html/rfc7518#section-3.1

The OpenID claim to use as the user name. Note that claims other than the default (‘sub’) is not guaranteed to be unique and immutable. This flag is experimental, please see the authentication documentation for further details. (default “sub”)

If provided, all usernames will be prefixed with this value. If not provided, username claims other than ‘email’ are prefixed by the issuer URL to avoid clashes. To skip any prefixing, provide the value ‘-’.

Extra configuration added to kubeconfig’s auth-provider. Must not be any of idp-issuer-url, client-id, client-secret, idp-certificate-authority, idp-certificate-authority-data, id-token or refresh-token

The client Secret for the OpenID Connect client.

SecretRef is a reference to a Secret object containing the Kubeconfig of the external kubernetes clusters to be added to Gardener.

Endpoints is the configuration plant endpoints

Conditions represents the latest available observations of a Plant’s current state.

ObservedGeneration is the most recent generation observed for this Plant. It corresponds to the Plant’s generation, which is updated on mutation by the API Server.

ClusterInfo is additional computed information about the newly added cluster (Plant)

(Members of Subject are embedded into this type.)

Subject is representing a user name, an email address, or any other identifier of a user, group, or service account that has a certain role.

Role represents the role of this member. IMPORTANT: Be aware that this field will be removed in the v1 version of this API in favor of the roles list. TODO: Remove this field in favor of the roles list in v1.

Roles represents the list of roles of this member.

CreatedBy is a subject representing a user name, an email address, or any other identifier of a user who created the project. This field is immutable.

Description is a human-readable description of what the project is used for.

Owner is a subject representing a user name, an email address, or any other identifier of a user owning the project. IMPORTANT: Be aware that this field will be removed in the v1 version of this API in favor of the owner role. The only way to change the owner will be by moving the owner role. In this API version the only way to change the owner is to use this field. TODO: Remove this field in favor of the owner role in v1.

Purpose is a human-readable explanation of the project’s purpose.

Members is a list of subjects representing a user name, an email address, or any other identifier of a user, group, or service account that has a certain role.

Namespace is the name of the namespace that has been created for the Project object. A nil value means that Gardener will determine the name of the namespace. This field is immutable.

Tolerations contains the tolerations for taints on seed clusters.

ObservedGeneration is the most recent generation observed for this project.

Phase is the current phase of the project.

StaleSinceTimestamp contains the timestamp when the project was first discovered to be stale/unused.

StaleAutoDeleteTimestamp contains the timestamp when the project will be garbage-collected/automatically deleted because it’s stale/unused.

LastActivityTimestamp contains the timestamp from the last activity performed in this project.

Defaults contains a list of tolerations that are added to the shoots in this project by default.

Whitelist contains a list of tolerations that are allowed to be added to the shoots in this project. Please note that this list may only be added by users having the spec-tolerations-whitelist verb for project resources.

Type is the type of the provider. This field is immutable.

ControlPlaneConfig contains the provider-specific control plane config blob. Please look up the concrete definition in the documentation of your provider extension.

InfrastructureConfig contains the provider-specific infrastructure config blob. Please look up the concrete definition in the documentation of your provider extension.

Workers is a list of worker groups.

ClusterLifetimeDays is the lifetime of a Shoot cluster in days before it will be terminated automatically.

Metrics is a list of resources which will be put under constraints.

Scope is the scope of the Quota object, either ‘project’ or ‘secret’. This field is immutable.

Name is a region name.

Zones is a list of availability zones in this region.

Labels is an optional set of key-value pairs that contain certain administrator-controlled labels for this region. It can be used by Gardener administrators/operators to provide additional information about a region, e.g. wrt quality, reliability, access restrictions, etc.

APIGroup is the API group of the resource for which the watch cache size should be configured. An unset value is used to specify the legacy core API (e.g. for secrets).

Resource is the name of the resource for which the watch cache size should be configured (in lowercase plural form, e.g. secrets).

CacheSize specifies the watch cache size that should be configured for the specified resource.

Type is the type of the provider.

For backwards compatibility, the field can contain multiple providers separated by a comma. However the usage of single SecretBinding (hence Secret) for different cloud providers is strongly discouraged.

Provider is a provider name. This field is immutable.

ProviderConfig is the configuration passed to BackupBucket resource.

Region is a region name. This field is immutable.

SecretRef is a reference to a Secret object containing the cloud provider credentials for the object store where backups should be stored. It should have enough privileges to manipulate the objects as well as buckets.

IngressDomain is the domain of the Seed cluster pointing to the ingress controller endpoint. It will be used to construct ingress URLs for system applications running in Shoot clusters. This field is immutable. This will be removed in the next API version and replaced by spec.ingress.domain.

Provider configures a DNSProvider

Type describes the type of the dns-provider, for example aws-route53

SecretRef is a reference to a Secret object containing cloud provider credentials used for registering external domains.

Domains contains information about which domains shall be included/excluded for this provider.

Zones contains information about which hosted zones shall be included/excluded for this provider.

Nodes is the CIDR of the node network. This field is immutable.

Pods is the CIDR of the pod network. This field is immutable.

Services is the CIDR of the service network. This field is immutable.

ShootDefaults contains the default networks CIDRs for shoots.

BlockCIDRs is a list of network addresses that should be blocked for shoot control plane components running in the seed cluster.

Type is the name of the provider.

ProviderConfig is the configuration passed to Seed resource.

Region is a name of a region.

(Members of LabelSelector are embedded into this type.)

LabelSelector is optional and can be used to select seeds by their label settings

Providers is optional and can be used by restricting seeds by their provider type. ‘*’ can be used to enable seeds regardless of their provider type.

Endpoint controls the endpoint settings for the dependency-watchdog for the seed.

Probe controls the probe settings for the dependency-watchdog for the seed.

Enabled controls whether the endpoint controller of the dependency-watchdog should be enabled. This controller helps to alleviate the delay where control plane components remain unavailable by finding the respective pods in CrashLoopBackoff status and restarting them once their dependants become ready and available again.

Enabled controls whether the probe controller of the dependency-watchdog should be enabled. This controller scales down the kube-controller-manager of shoot clusters in case their respective kube-apiserver is not reachable via its external ingress in order to avoid melt-down situations.

Enabled controls whether the excess capacity reservation should be enabled.

Annotations is a map of annotations that will be injected/merged into every load balancer service object.

Enabled controls whether owner checks are enabled for shoots scheduled on this seed. It is enabled by default because it is a prerequisite for control plane migration.

Visible controls whether the gardener-scheduler shall consider this seed when scheduling shoots. Invisible seeds are not considered by the scheduler.

Enabled controls whether the DNS for shoot clusters should be enabled. When disabled then all shoots using the seed won’t get any DNS providers, DNS records, and no DNS extension controller is required to be installed here. This is useful for environments where DNS is not required.

Enabled controls whether the VPA components shall be deployed into the garden namespace in the seed cluster. It is enabled by default because Gardener heavily relies on a VPA being deployed. You should only disable this if your seed cluster already has another, manually/custom managed VPA deployment.

ExcessCapacityReservation controls the excess capacity reservation for shoot control planes in the seed.

Scheduling controls settings for scheduling decisions for the seed.

ShootDNS controls the shoot DNS settings for the seed.

LoadBalancerServices controls certain settings for services of type load balancer that are created in the seed.

VerticalPodAutoscaler controls certain settings for the vertical pod autoscaler components deployed in the seed.

SeedSettingOwnerChecks controls certain owner checks settings for shoots scheduled on this seed.

DependencyWatchdog controls certain settings for the dependency-watchdog components deployed in the seed.

Backup holds the object store configuration for the backups of shoot (currently only etcd). If it is not specified, then there won’t be any backups taken for shoots associated with this seed. If backup field is present in seed, then backups of the etcd from shoot control plane will be stored under the configured object store.

DNS contains DNS-relevant information about this seed cluster.

Networks defines the pod, service and worker network of the Seed cluster.

Provider defines the provider type and region for this Seed cluster.

SecretRef is a reference to a Secret object containing the Kubeconfig of the Kubernetes cluster to be registered as Seed.

Taints describes taints on the seed.

Volume contains settings for persistentvolumes created in the seed cluster.

Settings contains certain settings for this seed cluster.

Ingress configures Ingress specific settings of the Seed cluster. This field is immutable.

Gardener holds information about the Gardener which last acted on the Shoot.

KubernetesVersion is the Kubernetes version of the seed cluster.

Conditions represents the latest available observations of a Seed’s current state.

ObservedGeneration is the most recent generation observed for this Seed. It corresponds to the Seed’s generation, which is updated on mutation by the API Server.

ClusterIdentity is the identity of the Seed cluster. This field is immutable.

Capacity represents the total resources of a seed.

Allocatable represents the resources of a seed that are available for scheduling. Defaults to Capacity.

ClientCertificateExpirationTimestamp is the timestamp at which gardenlet’s client certificate expires.

Key is the taint key to be applied to a seed.

Value is the taint value corresponding to the taint key.

Standard object metadata.

Specification of the desired behavior of the Seed.

MinimumSize defines the minimum size that should be used for PVCs in the seed.

Providers is a list of storage class provisioner types for the seed.

Purpose is the purpose of this provider.

Name is the name of the storage class provisioner type.

Issuer is the identifier of the service account token issuer. The issuer will assert this identifier in “iss” claim of issued tokens. This value is used to generate new service account tokens. This value is a string or URI. Defaults to URI of the API server.

SigningKeySecret is a reference to a secret that contains an optional private key of the service account token issuer. The issuer will sign issued ID tokens with this private key. Only useful if service account tokens are also issued by another external system. Deprecated: This field is deprecated and will be removed in a future version of Gardener. Do not use it.

ExtendTokenExpiration turns on projected service account expiration extension during token generation, which helps safe transition from legacy token to bound service account token feature. If this flag is enabled, admission injected tokens would be extended up to 1 year to prevent unexpected failure during transition, ignoring value of service-account-max-token-expiration.

MaxTokenExpiration is the maximum validity duration of a token created by the service account token issuer. If an otherwise valid TokenRequest with a validity duration larger than this value is requested, a token will be issued with a validity duration of this value. This field must be within [30d,90d] when the ShootMaxTokenExpirationValidation feature gate is enabled. This field will be overwritten to be within [30d,90d] when the ShootMaxTokenExpirationOverwrite feature gate is enabled.

AcceptedIssuers is an additional set of issuers that are used to determine which service account tokens are accepted. These values are not used to generate new service account tokens. Only useful when service account tokens are also issued by another external system or a change of the current issuer that is used for generating tokens is being performed. This field is only available for Kubernetes v1.22 or later.

Name of the advertised address. e.g. external

The URL of the API Server. e.g. https://api.foo.bar or https://1.2.3.4

Phase describes the phase of the certificate authority credential rotation.

LastInitiationTime is the most recent time when the certificate authority credential rotation was initiated.

LastCompletionTime is the most recent time when the certificate authority credential rotation was successfully completed.

Rotation contains information about the credential rotations.

CertificateAuthorities contains information about the certificate authority credential rotation.

Kubeconfig contains information about the kubeconfig credential rotation.

SSHKeypair contains information about the ssh-keypair credential rotation.

Observability contains information about the observability credential rotation.

ServiceAccountKey contains information about the service account key credential rotation.

LastInitiationTime is the most recent time when the kubeconfig credential rotation was initiated.

LastCompletionTime is the most recent time when the kubeconfig credential rotation was successfully completed.

Name is the name of the image.

ProviderConfig is the shoot’s individual configuration passed to an extension resource.

Version is the version of the shoot’s image. If version is not provided, it will be defaulted to the latest version from the CloudProfile.

Pods is the CIDR of the pod network.

Services is the CIDR of the service network.

LastInitiationTime is the most recent time when the observability credential rotation was initiated.

LastCompletionTime is the most recent time when the observability credential rotation was successfully completed.

LastInitiationTime is the most recent time when the ssh-keypair credential rotation was initiated.

LastCompletionTime is the most recent time when the ssh-keypair credential rotation was successfully completed.

Phase describes the phase of the service account key credential rotation.

LastInitiationTime is the most recent time when the service account key credential rotation was initiated.

LastCompletionTime is the most recent time when the service account key credential rotation was successfully completed.

Addons contains information about enabled/disabled addons and their configuration.

CloudProfileName is a name of a CloudProfile object. This field is immutable.

DNS contains information about the DNS settings of the Shoot.

Extensions contain type and provider information for Shoot extensions.

Hibernation contains information whether the Shoot is suspended or not.

Kubernetes contains the version and configuration settings of the control plane components.

Networking contains information about cluster networking such as CNI Plugin type, CIDRs, …etc.

Maintenance contains information about the time window for maintenance operations and which operations should be performed.

Monitoring contains information about custom monitoring configurations for the shoot.

Provider contains all provider-specific and provider-relevant information.

Purpose is the purpose class for this cluster.

Region is a name of a region. This field is immutable.

SecretBindingName is the name of the a SecretBinding that has a reference to the provider secret. The credentials inside the provider secret will be used to create the shoot in the respective account. This field is immutable.

SeedName is the name of the seed cluster that runs the control plane of the Shoot. This field is immutable when the SeedChange feature gate is disabled.

SeedSelector is an optional selector which must match a seed’s labels for the shoot to be scheduled on that seed.

Resources holds a list of named resource references that can be referred to in extension configs by their names.

Tolerations contains the tolerations for taints on seed clusters.

ExposureClassName is the optional name of an exposure class to apply a control plane endpoint exposure strategy. This field is immutable.

SystemComponents contains the settings of system components in the control or data plane of the Shoot cluster.

Conditions represents the latest available observations of a Shoots’s current state.

Constraints represents conditions of a Shoot’s current state that constraint some operations on it.

Gardener holds information about the Gardener which last acted on the Shoot.

IsHibernated indicates whether the Shoot is currently hibernated.

LastOperation holds information about the last operation on the Shoot.

LastErrors holds information about the last occurred error(s) during an operation.

ObservedGeneration is the most recent generation observed for this Shoot. It corresponds to the Shoot’s generation, which is updated on mutation by the API Server.

RetryCycleStartTime is the start time of the last retry cycle (used to determine how often an operation must be retried until we give up).

SeedName is the name of the seed cluster that runs the control plane of the Shoot. This value is only written after a successful create/reconcile operation. It will be used when control planes are moved between Seeds.

TechnicalID is the name that is used for creating the Seed namespace, the infrastructure resources, and basically everything that is related to this particular Shoot. This field is immutable.

UID is a unique identifier for the Shoot cluster to avoid portability between Kubernetes clusters. It is used to compute unique hashes. This field is immutable.

ClusterIdentity is the identity of the Shoot cluster. This field is immutable.

List of addresses on which the Kube API server can be reached.

MigrationStartTime is the time when a migration to a different seed was initiated.

Credentials contains information about the shoot credentials.

LastHibernationTriggerTime indicates the last time when the hibernation controller managed to change the hibernation settings of the cluster

Standard object metadata.

Specification of the desired behavior of the Shoot.

CoreDNS contains the settings of the Core DNS components running in the data plane of the Shoot cluster.

Key is the toleration key to be applied to a project or shoot.

Value is the toleration value corresponding to the toleration key.

Enabled specifies whether the Kubernetes VPA shall be enabled for the shoot cluster.

EvictAfterOOMThreshold defines the threshold that will lead to pod eviction in case it OOMed in less than the given threshold since its start and if it has only one container (default: 10m0s).

EvictionRateBurst defines the burst of pods that can be evicted (default: 1)

EvictionRateLimit defines the number of pods that can be evicted per second. A rate limit set to 0 or -1 will disable the rate limiter (default: -1).

EvictionTolerance defines the fraction of replica count that can be evicted for update in case more than one pod can be evicted (default: 0.5).

RecommendationMarginFraction is the fraction of usage added as the safety margin to the recommended request (default: 0.15).

UpdaterInterval is the interval how often the updater should run (default: 1m0s).

RecommenderInterval is the interval how often metrics should be fetched (default: 1m0s).

Name of the volume to make it referencable.

Type is the type of the volume.

VolumeSize is the size of the volume.

Encrypted determines if the volume should be encrypted.

Class is the class of the volume type.

Name is the name of the volume type.

Usable defines if the volume type can be used for shoot clusters.

MinSize is the minimal supported storage size.

Default configures the default watch cache size of the kube-apiserver (flag --default-watch-cache-size, defaults to 100). See: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/

Resources configures the watch cache size of the kube-apiserver per resource (flag --watch-cache-sizes). See: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/

Annotations is a map of key/value pairs for annotations for all the Node objects in this worker pool.

CABundle is a certificate bundle which will be installed onto every machine of this worker pool.

CRI contains configurations of CRI support of every machine in the worker pool. Defaults to a CRI with name containerd when the Kubernetes version of the Shoot is >= 1.22.

Kubernetes contains configuration for Kubernetes components related to this worker pool.

Labels is a map of key/value pairs for labels for all the Node objects in this worker pool.

Name is the name of the worker group.

Machine contains information about the machine type and image.

Maximum is the maximum number of VMs to create.

Minimum is the minimum number of VMs to create.

MaxSurge is maximum number of VMs that are created during an update.

MaxUnavailable is the maximum number of VMs that can be unavailable during an update.

ProviderConfig is the provider-specific configuration for this worker pool.

Taints is a list of taints for all the Node objects in this worker pool.

Volume contains information about the volume type and size.

DataVolumes contains a list of additional worker volumes.

KubeletDataVolumeName contains the name of a dataVolume that should be used for storing kubelet state.

Zones is a list of availability zones that are used to evenly distribute this worker pool. Optional as not every provider may support availability zones.

SystemComponents contains configuration for system components related to this worker pool

MachineControllerManagerSettings contains configurations for different worker-pools. Eg. MachineDrainTimeout, MachineHealthTimeout.

Kubelet contains configuration settings for all kubelets of this worker pool. If set, all spec.kubernetes.kubelet settings will be overwritten for this worker pool (no merge of settings).

Version is the semantic Kubernetes version to use for the Kubelet in this Worker Group. If not specified the kubelet version is derived from the global shoot cluster kubernetes version. version must be equal or lower than the version of the shoot kubernetes version. Only one minor version difference to other worker groups and global kubernetes version is allowed.

Allow determines whether the pool should be allowed to host system components or not (defaults to true)

Specification of the BackupBucket. If the object’s deletion timestamp is set, this field is immutable.

Specification of the BackupEntry. If the object’s deletion timestamp is set, this field is immutable.

Spec is the specification of this Bastion. If the object’s deletion timestamp is set, this field is immutable.

Status is the bastion’s status.

Specification of the ContainerRuntime. If the object’s deletion timestamp is set, this field is immutable.

Specification of the ControlPlane. If the object’s deletion timestamp is set, this field is immutable.