ClusterClass is a template which can be used to create managed topologies.
ClusterClass is a template which can be used to create managed topologies.
object
Property | Type | Description |
---|---|---|
|
|
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata |
|
|
|
ClusterClassSpec describes the desired state of the ClusterClass. |
|
|
ClusterClassStatus defines the observed state of the ClusterClass. |
ClusterClassSpec describes the desired state of the ClusterClass.
object
Property | Type | Description |
---|---|---|
|
|
ControlPlane is a reference to a local struct that holds the details for provisioning the Control Plane for the Cluster. |
|
|
Infrastructure is a reference to a provider-specific template that holds the details for provisioning infrastructure specific cluster for the underlying provider. The underlying provider is responsible for the implementation of the template to an infrastructure cluster. |
|
|
Patches defines the patches which are applied to customize referenced templates of a ClusterClass. Note: Patches will be applied in the order of the array. |
|
|
ClusterClassPatch defines a patch which is applied to customize the referenced templates. |
|
|
Variables defines the variables which can be configured in the Cluster topology and are then used in patches. |
|
|
ClusterClassVariable defines a variable which can be configured in the Cluster topology and used in patches. |
|
|
Workers describes the worker nodes for the cluster. It is a collection of node types which can be used to create the worker nodes of the cluster. |
ControlPlane is a reference to a local struct that holds the details for provisioning the Control Plane for the Cluster.
object
ref
Property | Type | Description |
---|---|---|
|
|
MachineHealthCheck defines a MachineHealthCheck for this ControlPlaneClass. This field is supported if and only if the ControlPlane provider template referenced above is Machine based and supports setting replicas. |
|
|
MachineInfrastructure defines the metadata and infrastructure information for control plane machines. This field is supported if and only if the control plane provider template referenced above is Machine based and supports setting replicas. |
|
|
Metadata is the metadata applied to the ControlPlane and the Machines of the ControlPlane if the ControlPlaneTemplate referenced is machine based. If not, it is applied only to the ControlPlane. At runtime this metadata is merged with the corresponding metadata from the topology. This field is supported if and only if the control plane provider template referenced is Machine based. |
|
|
NamingStrategy allows changing the naming pattern used when creating the control plane provider object. |
|
|
NodeDeletionTimeout defines how long the controller will attempt to delete the Node that the Machine hosts after the Machine is marked for deletion. A duration of 0 will retry deletion indefinitely. Defaults to 10 seconds. NOTE: This value can be overridden while defining a Cluster.Topology. |
|
|
NodeDrainTimeout is the total amount of time that the controller will spend on draining a node.
The default value is 0, meaning that the node can be drained without any time limitations.
NOTE: NodeDrainTimeout is different from |
|
|
NodeVolumeDetachTimeout is the total amount of time that the controller will spend on waiting for all volumes to be detached. The default value is 0, meaning that the volumes can be detached without any time limitations. NOTE: This value can be overridden while defining a Cluster.Topology. |
|
|
Ref is a required reference to a custom resource offered by a provider. |
MachineHealthCheck defines a MachineHealthCheck for this ControlPlaneClass. This field is supported if and only if the ControlPlane provider template referenced above is Machine based and supports setting replicas.
object
Property | Type | Description |
---|---|---|
|
|
Any further remediation is only allowed if at most "MaxUnhealthy" machines selected by "selector" are not healthy. |
|
|
Machines older than this duration without a node will be considered to have failed and will be remediated. If you wish to disable this feature, set the value explicitly to 0. |
|
|
RemediationTemplate is a reference to a remediation template provided by an infrastructure provider. This field is completely optional, when filled, the MachineHealthCheck controller creates a new object from the template referenced and hands off remediation of the machine to a controller that lives outside of Cluster API. |
|
|
UnhealthyConditions contains a list of the conditions that determine whether a node is considered unhealthy. The conditions are combined in a logical OR, i.e. if any of the conditions is met, the node is unhealthy. |
|
|
UnhealthyCondition represents a Node condition type and value with a timeout specified as a duration. When the named condition has been in the given status for at least the timeout value, a node is considered unhealthy. |
|
|
Any further remediation is only allowed if the number of machines selected by "selector" as not healthy is within the range of "UnhealthyRange". Takes precedence over MaxUnhealthy. Eg. "[3-5]" - This means that remediation will be allowed only when: (a) there are at least 3 unhealthy machines (and) (b) there are at most 5 unhealthy machines |
RemediationTemplate is a reference to a remediation template provided by an infrastructure provider.
This field is completely optional, when filled, the MachineHealthCheck controller creates a new object from the template referenced and hands off remediation of the machine to a controller that lives outside of Cluster API.
object
Property | Type | Description |
---|---|---|
|
|
API version of the referent. |
|
|
If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. TODO: this design is not final and this field is subject to change in the future. |
|
|
Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
|
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
UnhealthyConditions contains a list of the conditions that determine whether a node is considered unhealthy. The conditions are combined in a logical OR, i.e. if any of the conditions is met, the node is unhealthy.
array
UnhealthyCondition represents a Node condition type and value with a timeout specified as a duration. When the named condition has been in the given status for at least the timeout value, a node is considered unhealthy.
object
status
timeout
type
Property | Type | Description |
---|---|---|
|
|
|
|
|
|
|
|
MachineInfrastructure defines the metadata and infrastructure information for control plane machines.
This field is supported if and only if the control plane provider template referenced above is Machine based and supports setting replicas.
object
ref
Property | Type | Description |
---|---|---|
|
|
Ref is a required reference to a custom resource offered by a provider. |
Ref is a required reference to a custom resource offered by a provider.
object
Property | Type | Description |
---|---|---|
|
|
API version of the referent. |
|
|
If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. TODO: this design is not final and this field is subject to change in the future. |
|
|
Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
|
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
Metadata is the metadata applied to the ControlPlane and the Machines of the ControlPlane if the ControlPlaneTemplate referenced is machine based. If not, it is applied only to the ControlPlane. At runtime this metadata is merged with the corresponding metadata from the topology.
This field is supported if and only if the control plane provider template referenced is Machine based.
object
Property | Type | Description |
---|---|---|
|
|
Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations |
|
|
Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels |
NamingStrategy allows changing the naming pattern used when creating the control plane provider object.
object
Property | Type | Description |
---|---|---|
|
|
Template defines the template to use for generating the name of the ControlPlane object.
If not defined, it will fallback to |
Ref is a required reference to a custom resource offered by a provider.
object
Property | Type | Description |
---|---|---|
|
|
API version of the referent. |
|
|
If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. TODO: this design is not final and this field is subject to change in the future. |
|
|
Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
|
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
Infrastructure is a reference to a provider-specific template that holds the details for provisioning infrastructure specific cluster for the underlying provider. The underlying provider is responsible for the implementation of the template to an infrastructure cluster.
object
ref
Property | Type | Description |
---|---|---|
|
|
Ref is a required reference to a custom resource offered by a provider. |
Ref is a required reference to a custom resource offered by a provider.
object
Property | Type | Description |
---|---|---|
|
|
API version of the referent. |
|
|
If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. TODO: this design is not final and this field is subject to change in the future. |
|
|
Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
|
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
Patches defines the patches which are applied to customize referenced templates of a ClusterClass. Note: Patches will be applied in the order of the array.
array
ClusterClassPatch defines a patch which is applied to customize the referenced templates.
object
name
Property | Type | Description |
---|---|---|
|
|
Definitions define inline patches. Note: Patches will be applied in the order of the array. Note: Exactly one of Definitions or External must be set. |
|
|
PatchDefinition defines a patch which is applied to customize the referenced templates. |
|
|
Description is a human-readable description of this patch. |
|
|
EnabledIf is a Go template to be used to calculate if a patch should be enabled.
It can reference variables defined in .spec.variables and builtin variables.
The patch will be enabled if the template evaluates to |
|
|
External defines an external patch. Note: Exactly one of Definitions or External must be set. |
|
|
Name of the patch. |
Definitions define inline patches. Note: Patches will be applied in the order of the array. Note: Exactly one of Definitions or External must be set.
array
PatchDefinition defines a patch which is applied to customize the referenced templates.
object
jsonPatches
selector
Property | Type | Description |
---|---|---|
|
|
JSONPatches defines the patches which should be applied on the templates matching the selector. Note: Patches will be applied in the order of the array. |
|
|
JSONPatch defines a JSON patch. |
|
|
Selector defines on which templates the patch should be applied. |
JSONPatches defines the patches which should be applied on the templates matching the selector. Note: Patches will be applied in the order of the array.
array
JSONPatch defines a JSON patch.
object
op
path
Property | Type | Description |
---|---|---|
|
|
Op defines the operation of the patch.
Note: Only |
|
|
Path defines the path of the patch.
Note: Only the spec of a template can be patched, thus the path has to start with /spec/.
Note: For now the only allowed array modifications are |
|
`` |
Value defines the value of the patch. Note: Either Value or ValueFrom is required for add and replace operations. Only one of them is allowed to be set at the same time. Note: We have to use apiextensionsv1.JSON instead of our JSON type, because controller-tools has a hard-coded schema for apiextensionsv1.JSON which cannot be produced by another type (unset type field). Ref: https://github.com/kubernetes-sigs/controller-tools/blob/d0e03a142d0ecdd5491593e941ee1d6b5d91dba6/pkg/crd/known_types.go#L106-L111 |
|
|
ValueFrom defines the value of the patch. Note: Either Value or ValueFrom is required for add and replace operations. Only one of them is allowed to be set at the same time. |
ValueFrom defines the value of the patch. Note: Either Value or ValueFrom is required for add and replace operations. Only one of them is allowed to be set at the same time.
object
Property | Type | Description |
---|---|---|
|
|
Template is the Go template to be used to calculate the value. A template can reference variables defined in .spec.variables and builtin variables. Note: The template must evaluate to a valid YAML or JSON value. |
|
|
Variable is the variable to be used as value. Variable can be one of the variables defined in .spec.variables or a builtin variable. |
Selector defines on which templates the patch should be applied.
object
apiVersion
kind
matchResources
Property | Type | Description |
---|---|---|
|
|
APIVersion filters templates by apiVersion. |
|
|
Kind filters templates by kind. |
|
|
MatchResources selects templates based on where they are referenced. |
MatchResources selects templates based on where they are referenced.
object
Property | Type | Description |
---|---|---|
|
|
ControlPlane selects templates referenced in .spec.ControlPlane. Note: this will match the controlPlane and also the controlPlane machineInfrastructure (depending on the kind and apiVersion). |
|
|
InfrastructureCluster selects templates referenced in .spec.infrastructure. |
|
|
MachineDeploymentClass selects templates referenced in specific MachineDeploymentClasses in .spec.workers.machineDeployments. |
|
|
MachinePoolClass selects templates referenced in specific MachinePoolClasses in .spec.workers.machinePools. |
MachineDeploymentClass selects templates referenced in specific MachineDeploymentClasses in .spec.workers.machineDeployments.
object
Property | Type | Description |
---|---|---|
|
|
Names selects templates by class names. |
MachinePoolClass selects templates referenced in specific MachinePoolClasses in .spec.workers.machinePools.
object
Property | Type | Description |
---|---|---|
|
|
Names selects templates by class names. |
External defines an external patch. Note: Exactly one of Definitions or External must be set.
object
Property | Type | Description |
---|---|---|
|
|
DiscoverVariablesExtension references an extension which is called to discover variables. |
|
|
GenerateExtension references an extension which is called to generate patches. |
|
|
Settings defines key value pairs to be passed to the extensions. Values defined here take precedence over the values defined in the corresponding ExtensionConfig. |
|
|
ValidateExtension references an extension which is called to validate the topology. |
Variables defines the variables which can be configured in the Cluster topology and are then used in patches.
array
ClusterClassVariable defines a variable which can be configured in the Cluster topology and used in patches.
object
name
required
schema
Property | Type | Description |
---|---|---|
|
|
Metadata is the metadata of a variable. It can be used to add additional data for higher level tools to a ClusterClassVariable. |
|
|
Name of the variable. |
|
|
Required specifies if the variable is required. Note: this applies to the variable as a whole and thus the top-level object defined in the schema. If nested fields are required, this will be specified inside the schema. |
|
|
Schema defines the schema of the variable. |
Metadata is the metadata of a variable. It can be used to add additional data for higher level tools to a ClusterClassVariable.
object
Property | Type | Description |
---|---|---|
|
|
Annotations is an unstructured key value map that can be used to store and retrieve arbitrary metadata. They are not queryable. |
|
|
Map of string keys and values that can be used to organize and categorize (scope and select) variables. |
Schema defines the schema of the variable.
object
openAPIV3Schema
Property | Type | Description |
---|---|---|
|
|
OpenAPIV3Schema defines the schema of a variable via OpenAPI v3 schema. The schema is a subset of the schema used in Kubernetes CRDs. |
OpenAPIV3Schema defines the schema of a variable via OpenAPI v3 schema. The schema is a subset of the schema used in Kubernetes CRDs.
object
type
Property | Type | Description |
---|---|---|
|
`` |
AdditionalProperties specifies the schema of values in a map (keys are always strings). NOTE: Can only be set if type is object. NOTE: AdditionalProperties is mutually exclusive with Properties. NOTE: This field uses PreserveUnknownFields and Schemaless, because recursive validation is not possible. |
|
`` |
Default is the default value of the variable. NOTE: Can be set for all types. |
|
|
Description is a human-readable description of this variable. |
|
|
Enum is the list of valid values of the variable. NOTE: Can be set for all types. |
|
`` |
Example is an example for this variable. |
|
|
ExclusiveMaximum specifies if the Maximum is exclusive. NOTE: Can only be set if type is integer or number. |
|
|
ExclusiveMinimum specifies if the Minimum is exclusive. NOTE: Can only be set if type is integer or number. |
|
|
Format is an OpenAPI v3 format string. Unknown formats are ignored. For a list of supported formats please see: (of the k8s.io/apiextensions-apiserver version we’re currently using) https://github.com/kubernetes/apiextensions-apiserver/blob/master/pkg/apiserver/validation/formats.go NOTE: Can only be set if type is string. |
|
`` |
Items specifies fields of an array. NOTE: Can only be set if type is array. NOTE: This field uses PreserveUnknownFields and Schemaless, because recursive validation is not possible. |
|
|
MaxItems is the max length of an array variable. NOTE: Can only be set if type is array. |
|
|
MaxLength is the max length of a string variable. NOTE: Can only be set if type is string. |
|
|
Maximum is the maximum of an integer or number variable. If ExclusiveMaximum is false, the variable is valid if it is lower than, or equal to, the value of Maximum. If ExclusiveMaximum is true, the variable is valid if it is strictly lower than the value of Maximum. NOTE: Can only be set if type is integer or number. |
|
|
MinItems is the min length of an array variable. NOTE: Can only be set if type is array. |
|
|
MinLength is the min length of a string variable. NOTE: Can only be set if type is string. |
|
|
Minimum is the minimum of an integer or number variable. If ExclusiveMinimum is false, the variable is valid if it is greater than, or equal to, the value of Minimum. If ExclusiveMinimum is true, the variable is valid if it is strictly greater than the value of Minimum. NOTE: Can only be set if type is integer or number. |
|
|
Pattern is the regex which a string variable must match. NOTE: Can only be set if type is string. |
|
`` |
Properties specifies fields of an object. NOTE: Can only be set if type is object. NOTE: Properties is mutually exclusive with AdditionalProperties. NOTE: This field uses PreserveUnknownFields and Schemaless, because recursive validation is not possible. |
|
|
Required specifies which fields of an object are required. NOTE: Can only be set if type is object. |
|
|
Type is the type of the variable. Valid values are: object, array, string, integer, number or boolean. |
|
|
UniqueItems specifies if items in an array must be unique. NOTE: Can only be set if type is array. |
|
|
XPreserveUnknownFields allows setting fields in a variable object which are not defined in the variable schema. This affects fields recursively, except if nested properties or additionalProperties are specified in the schema. |
Workers describes the worker nodes for the cluster. It is a collection of node types which can be used to create the worker nodes of the cluster.
object
Property | Type | Description |
---|---|---|
|
|
MachineDeployments is a list of machine deployment classes that can be used to create a set of worker nodes. |
|
|
MachineDeploymentClass serves as a template to define a set of worker nodes of the cluster
provisioned using the |
|
|
MachinePools is a list of machine pool classes that can be used to create a set of worker nodes. |
|
|
MachinePoolClass serves as a template to define a pool of worker nodes of the cluster
provisioned using |
MachineDeployments is a list of machine deployment classes that can be used to create a set of worker nodes.
array
MachineDeploymentClass serves as a template to define a set of worker nodes of the cluster
provisioned using the ClusterClass
.
object
class
template
Property | Type | Description |
---|---|---|
|
|
Class denotes a type of worker node present in the cluster, this name MUST be unique within a ClusterClass and can be referenced in the Cluster to create a managed MachineDeployment. |
|
|
FailureDomain is the failure domain the machines will be created in. Must match a key in the FailureDomains map stored on the cluster object. NOTE: This value can be overridden while defining a Cluster.Topology using this MachineDeploymentClass. |
|
|
MachineHealthCheck defines a MachineHealthCheck for this MachineDeploymentClass. |
|
|
Minimum number of seconds for which a newly created machine should be ready. Defaults to 0 (machine will be considered available as soon as it is ready) NOTE: This value can be overridden while defining a Cluster.Topology using this MachineDeploymentClass. |
|
|
NamingStrategy allows changing the naming pattern used when creating the MachineDeployment. |
|
|
NodeDeletionTimeout defines how long the controller will attempt to delete the Node that the Machine hosts after the Machine is marked for deletion. A duration of 0 will retry deletion indefinitely. Defaults to 10 seconds. NOTE: This value can be overridden while defining a Cluster.Topology using this MachineDeploymentClass. |
|
|
NodeDrainTimeout is the total amount of time that the controller will spend on draining a node.
The default value is 0, meaning that the node can be drained without any time limitations.
NOTE: NodeDrainTimeout is different from |
|
|
NodeVolumeDetachTimeout is the total amount of time that the controller will spend on waiting for all volumes to be detached. The default value is 0, meaning that the volumes can be detached without any time limitations. NOTE: This value can be overridden while defining a Cluster.Topology using this MachineDeploymentClass. |
|
|
The deployment strategy to use to replace existing machines with new ones. NOTE: This value can be overridden while defining a Cluster.Topology using this MachineDeploymentClass. |
|
|
Template is a local struct containing a collection of templates for creation of MachineDeployment objects representing a set of worker nodes. |
MachineHealthCheck defines a MachineHealthCheck for this MachineDeploymentClass.
object
Property | Type | Description |
---|---|---|
|
|
Any further remediation is only allowed if at most "MaxUnhealthy" machines selected by "selector" are not healthy. |
|
|
Machines older than this duration without a node will be considered to have failed and will be remediated. If you wish to disable this feature, set the value explicitly to 0. |
|
|
RemediationTemplate is a reference to a remediation template provided by an infrastructure provider. This field is completely optional, when filled, the MachineHealthCheck controller creates a new object from the template referenced and hands off remediation of the machine to a controller that lives outside of Cluster API. |
|
|
UnhealthyConditions contains a list of the conditions that determine whether a node is considered unhealthy. The conditions are combined in a logical OR, i.e. if any of the conditions is met, the node is unhealthy. |
|
|
UnhealthyCondition represents a Node condition type and value with a timeout specified as a duration. When the named condition has been in the given status for at least the timeout value, a node is considered unhealthy. |
|
|
Any further remediation is only allowed if the number of machines selected by "selector" as not healthy is within the range of "UnhealthyRange". Takes precedence over MaxUnhealthy. Eg. "[3-5]" - This means that remediation will be allowed only when: (a) there are at least 3 unhealthy machines (and) (b) there are at most 5 unhealthy machines |
RemediationTemplate is a reference to a remediation template provided by an infrastructure provider.
This field is completely optional, when filled, the MachineHealthCheck controller creates a new object from the template referenced and hands off remediation of the machine to a controller that lives outside of Cluster API.
object
Property | Type | Description |
---|---|---|
|
|
API version of the referent. |
|
|
If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. TODO: this design is not final and this field is subject to change in the future. |
|
|
Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
|
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
UnhealthyConditions contains a list of the conditions that determine whether a node is considered unhealthy. The conditions are combined in a logical OR, i.e. if any of the conditions is met, the node is unhealthy.
array
UnhealthyCondition represents a Node condition type and value with a timeout specified as a duration. When the named condition has been in the given status for at least the timeout value, a node is considered unhealthy.
object
status
timeout
type
Property | Type | Description |
---|---|---|
|
|
|
|
|
|
|
|
NamingStrategy allows changing the naming pattern used when creating the MachineDeployment.
object
Property | Type | Description |
---|---|---|
|
|
Template defines the template to use for generating the name of the MachineDeployment object.
If not defined, it will fallback to |
The deployment strategy to use to replace existing machines with new ones. NOTE: This value can be overridden while defining a Cluster.Topology using this MachineDeploymentClass.
object
Property | Type | Description |
---|---|---|
|
|
Rolling update config params. Present only if MachineDeploymentStrategyType = RollingUpdate. |
|
|
Type of deployment. Allowed values are RollingUpdate and OnDelete. The default is RollingUpdate. |
Rolling update config params. Present only if MachineDeploymentStrategyType = RollingUpdate.
object
Property | Type | Description |
---|---|---|
|
|
DeletePolicy defines the policy used by the MachineDeployment to identify nodes to delete when downscaling. Valid values are "Random, "Newest", "Oldest" When no value is supplied, the default DeletePolicy of MachineSet is used |
|
|
The maximum number of machines that can be scheduled above the desired number of machines. Value can be an absolute number (ex: 5) or a percentage of desired machines (ex: 10%). This can not be 0 if MaxUnavailable is 0. Absolute number is calculated from percentage by rounding up. Defaults to 1. Example: when this is set to 30%, the new MachineSet can be scaled up immediately when the rolling update starts, such that the total number of old and new machines do not exceed 130% of desired machines. Once old machines have been killed, new MachineSet can be scaled up further, ensuring that total number of machines running at any time during the update is at most 130% of desired machines. |
|
|
The maximum number of machines that can be unavailable during the update. Value can be an absolute number (ex: 5) or a percentage of desired machines (ex: 10%). Absolute number is calculated from percentage by rounding down. This can not be 0 if MaxSurge is 0. Defaults to 0. Example: when this is set to 30%, the old MachineSet can be scaled down to 70% of desired machines immediately when the rolling update starts. Once new machines are ready, old MachineSet can be scaled down further, followed by scaling up the new MachineSet, ensuring that the total number of machines available at all times during the update is at least 70% of desired machines. |
Template is a local struct containing a collection of templates for creation of MachineDeployment objects representing a set of worker nodes.
object
bootstrap
infrastructure
Property | Type | Description |
---|---|---|
|
|
Bootstrap contains the bootstrap template reference to be used for the creation of worker Machines. |
|
|
Infrastructure contains the infrastructure template reference to be used for the creation of worker Machines. |
|
|
Metadata is the metadata applied to the MachineDeployment and the machines of the MachineDeployment. At runtime this metadata is merged with the corresponding metadata from the topology. |
Bootstrap contains the bootstrap template reference to be used for the creation of worker Machines.
object
ref
Property | Type | Description |
---|---|---|
|
|
Ref is a required reference to a custom resource offered by a provider. |
Ref is a required reference to a custom resource offered by a provider.
object
Property | Type | Description |
---|---|---|
|
|
API version of the referent. |
|
|
If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. TODO: this design is not final and this field is subject to change in the future. |
|
|
Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
|
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
Infrastructure contains the infrastructure template reference to be used for the creation of worker Machines.
object
ref
Property | Type | Description |
---|---|---|
|
|
Ref is a required reference to a custom resource offered by a provider. |
Ref is a required reference to a custom resource offered by a provider.
object
Property | Type | Description |
---|---|---|
|
|
API version of the referent. |
|
|
If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. TODO: this design is not final and this field is subject to change in the future. |
|
|
Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
|
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
Metadata is the metadata applied to the MachineDeployment and the machines of the MachineDeployment. At runtime this metadata is merged with the corresponding metadata from the topology.
object
Property | Type | Description |
---|---|---|
|
|
Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations |
|
|
Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels |
MachinePools is a list of machine pool classes that can be used to create a set of worker nodes.
array
MachinePoolClass serves as a template to define a pool of worker nodes of the cluster
provisioned using ClusterClass
.
object
class
template
Property | Type | Description |
---|---|---|
|
|
Class denotes a type of machine pool present in the cluster, this name MUST be unique within a ClusterClass and can be referenced in the Cluster to create a managed MachinePool. |
|
|
FailureDomains is the list of failure domains the MachinePool should be attached to. Must match a key in the FailureDomains map stored on the cluster object. NOTE: This value can be overridden while defining a Cluster.Topology using this MachinePoolClass. |
|
|
Minimum number of seconds for which a newly created machine pool should be ready. Defaults to 0 (machine will be considered available as soon as it is ready) NOTE: This value can be overridden while defining a Cluster.Topology using this MachinePoolClass. |
|
|
NamingStrategy allows changing the naming pattern used when creating the MachinePool. |
|
|
NodeDeletionTimeout defines how long the controller will attempt to delete the Node that the Machine hosts after the Machine Pool is marked for deletion. A duration of 0 will retry deletion indefinitely. Defaults to 10 seconds. NOTE: This value can be overridden while defining a Cluster.Topology using this MachinePoolClass. |
|
|
NodeDrainTimeout is the total amount of time that the controller will spend on draining a node.
The default value is 0, meaning that the node can be drained without any time limitations.
NOTE: NodeDrainTimeout is different from |
|
|
NodeVolumeDetachTimeout is the total amount of time that the controller will spend on waiting for all volumes to be detached. The default value is 0, meaning that the volumes can be detached without any time limitations. NOTE: This value can be overridden while defining a Cluster.Topology using this MachinePoolClass. |
|
|
Template is a local struct containing a collection of templates for creation of MachinePools objects representing a pool of worker nodes. |
NamingStrategy allows changing the naming pattern used when creating the MachinePool.
object
Property | Type | Description |
---|---|---|
|
|
Template defines the template to use for generating the name of the MachinePool object.
If not defined, it will fallback to |
Template is a local struct containing a collection of templates for creation of MachinePools objects representing a pool of worker nodes.
object
bootstrap
infrastructure
Property | Type | Description |
---|---|---|
|
|
Bootstrap contains the bootstrap template reference to be used for the creation of the Machines in the MachinePool. |
|
|
Infrastructure contains the infrastructure template reference to be used for the creation of the MachinePool. |
|
|
Metadata is the metadata applied to the MachinePool. At runtime this metadata is merged with the corresponding metadata from the topology. |
Bootstrap contains the bootstrap template reference to be used for the creation of the Machines in the MachinePool.
object
ref
Property | Type | Description |
---|---|---|
|
|
Ref is a required reference to a custom resource offered by a provider. |
Ref is a required reference to a custom resource offered by a provider.
object
Property | Type | Description |
---|---|---|
|
|
API version of the referent. |
|
|
If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. TODO: this design is not final and this field is subject to change in the future. |
|
|
Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
|
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
Infrastructure contains the infrastructure template reference to be used for the creation of the MachinePool.
object
ref
Property | Type | Description |
---|---|---|
|
|
Ref is a required reference to a custom resource offered by a provider. |
Ref is a required reference to a custom resource offered by a provider.
object
Property | Type | Description |
---|---|---|
|
|
API version of the referent. |
|
|
If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: "spec.containers{name}" (where "name" refers to the name of the container that triggered the event) or if no container name is specified "spec.containers[2]" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. TODO: this design is not final and this field is subject to change in the future. |
|
|
Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
|
Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
|
Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
|
Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
Metadata is the metadata applied to the MachinePool. At runtime this metadata is merged with the corresponding metadata from the topology.
object
Property | Type | Description |
---|---|---|
|
|
Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations |
|
|
Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels |
ClusterClassStatus defines the observed state of the ClusterClass.
object
Property | Type | Description |
---|---|---|
|
|
Conditions defines current observed state of the ClusterClass. |
|
|
Condition defines an observation of a Cluster API resource operational state. |
|
|
ObservedGeneration is the latest generation observed by the controller. |
|
|
Variables is a list of ClusterClassStatusVariable that are defined for the ClusterClass. |
|
|
ClusterClassStatusVariable defines a variable which appears in the status of a ClusterClass. |
Conditions defines current observed state of the ClusterClass.
array
Condition defines an observation of a Cluster API resource operational state.
object
lastTransitionTime
status
type
Property | Type | Description |
---|---|---|
|
|
Last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. |
|
|
A human readable message indicating details about the transition. This field may be empty. |
|
|
The reason for the condition’s last transition in CamelCase. The specific API may choose whether or not this field is considered a guaranteed API. This field may not be empty. |
|
|
Severity provides an explicit classification of Reason code, so the users or machines can immediately understand the current situation and act accordingly. The Severity field MUST be set only when Status=False. |
|
|
Status of the condition, one of True, False, Unknown. |
|
|
Type of condition in CamelCase or in foo.example.com/CamelCase. Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important. |
Variables is a list of ClusterClassStatusVariable that are defined for the ClusterClass.
array
ClusterClassStatusVariable defines a variable which appears in the status of a ClusterClass.
object
definitions
name
Property | Type | Description |
---|---|---|
|
|
Definitions is a list of definitions for a variable. |
|
|
ClusterClassStatusVariableDefinition defines a variable which appears in the status of a ClusterClass. |
|
|
DefinitionsConflict specifies whether or not there are conflicting definitions for a single variable name. |
|
|
Name is the name of the variable. |
Definitions is a list of definitions for a variable.
array
ClusterClassStatusVariableDefinition defines a variable which appears in the status of a ClusterClass.
object
from
required
schema
Property | Type | Description |
---|---|---|
|
|
From specifies the origin of the variable definition.
This will be |
|
|
Metadata is the metadata of a variable. It can be used to add additional data for higher level tools to a ClusterClassVariable. |
|
|
Required specifies if the variable is required. Note: this applies to the variable as a whole and thus the top-level object defined in the schema. If nested fields are required, this will be specified inside the schema. |
|
|
Schema defines the schema of the variable. |
Metadata is the metadata of a variable. It can be used to add additional data for higher level tools to a ClusterClassVariable.
object
Property | Type | Description |
---|---|---|
|
|
Annotations is an unstructured key value map that can be used to store and retrieve arbitrary metadata. They are not queryable. |
|
|
Map of string keys and values that can be used to organize and categorize (scope and select) variables. |
Schema defines the schema of the variable.
object
openAPIV3Schema
Property | Type | Description |
---|---|---|
|
|
OpenAPIV3Schema defines the schema of a variable via OpenAPI v3 schema. The schema is a subset of the schema used in Kubernetes CRDs. |
OpenAPIV3Schema defines the schema of a variable via OpenAPI v3 schema. The schema is a subset of the schema used in Kubernetes CRDs.
object
type
Property | Type | Description |
---|---|---|
|
`` |
AdditionalProperties specifies the schema of values in a map (keys are always strings). NOTE: Can only be set if type is object. NOTE: AdditionalProperties is mutually exclusive with Properties. NOTE: This field uses PreserveUnknownFields and Schemaless, because recursive validation is not possible. |
|
`` |
Default is the default value of the variable. NOTE: Can be set for all types. |
|
|
Description is a human-readable description of this variable. |
|
|
Enum is the list of valid values of the variable. NOTE: Can be set for all types. |
|
`` |
Example is an example for this variable. |
|
|
ExclusiveMaximum specifies if the Maximum is exclusive. NOTE: Can only be set if type is integer or number. |
|
|
ExclusiveMinimum specifies if the Minimum is exclusive. NOTE: Can only be set if type is integer or number. |
|
|
Format is an OpenAPI v3 format string. Unknown formats are ignored. For a list of supported formats please see: (of the k8s.io/apiextensions-apiserver version we’re currently using) https://github.com/kubernetes/apiextensions-apiserver/blob/master/pkg/apiserver/validation/formats.go NOTE: Can only be set if type is string. |
|
`` |
Items specifies fields of an array. NOTE: Can only be set if type is array. NOTE: This field uses PreserveUnknownFields and Schemaless, because recursive validation is not possible. |
|
|
MaxItems is the max length of an array variable. NOTE: Can only be set if type is array. |
|
|
MaxLength is the max length of a string variable. NOTE: Can only be set if type is string. |
|
|
Maximum is the maximum of an integer or number variable. If ExclusiveMaximum is false, the variable is valid if it is lower than, or equal to, the value of Maximum. If ExclusiveMaximum is true, the variable is valid if it is strictly lower than the value of Maximum. NOTE: Can only be set if type is integer or number. |
|
|
MinItems is the min length of an array variable. NOTE: Can only be set if type is array. |
|
|
MinLength is the min length of a string variable. NOTE: Can only be set if type is string. |
|
|
Minimum is the minimum of an integer or number variable. If ExclusiveMinimum is false, the variable is valid if it is greater than, or equal to, the value of Minimum. If ExclusiveMinimum is true, the variable is valid if it is strictly greater than the value of Minimum. NOTE: Can only be set if type is integer or number. |
|
|
Pattern is the regex which a string variable must match. NOTE: Can only be set if type is string. |
|
`` |
Properties specifies fields of an object. NOTE: Can only be set if type is object. NOTE: Properties is mutually exclusive with AdditionalProperties. NOTE: This field uses PreserveUnknownFields and Schemaless, because recursive validation is not possible. |
|
|
Required specifies which fields of an object are required. NOTE: Can only be set if type is object. |
|
|
Type is the type of the variable. Valid values are: object, array, string, integer, number or boolean. |
|
|
UniqueItems specifies if items in an array must be unique. NOTE: Can only be set if type is array. |
|
|
XPreserveUnknownFields allows setting fields in a variable object which are not defined in the variable schema. This affects fields recursively, except if nested properties or additionalProperties are specified in the schema. |
The following API endpoints are available:
/apis/cluster.x-k8s.io/v1beta1/clusterclasses
GET
: list objects of kind ClusterClass
/apis/cluster.x-k8s.io/v1beta1/namespaces/{namespace}/clusterclasses
DELETE
: delete collection of ClusterClass
GET
: list objects of kind ClusterClass
POST
: create a ClusterClass
/apis/cluster.x-k8s.io/v1beta1/namespaces/{namespace}/clusterclasses/{name}
DELETE
: delete a ClusterClass
GET
: read the specified ClusterClass
PATCH
: partially update the specified ClusterClass
PUT
: replace the specified ClusterClass
/apis/cluster.x-k8s.io/v1beta1/namespaces/{namespace}/clusterclasses/{name}/status
GET
: read status of the specified ClusterClass
PATCH
: partially update status of the specified ClusterClass
PUT
: replace status of the specified ClusterClass
GET
list objects of kind ClusterClass
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
DELETE
delete collection of ClusterClass
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
GET
list objects of kind ClusterClass
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
POST
create a ClusterClass
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
|
|
fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized |
Empty |
Parameter | Type | Description |
---|---|---|
|
|
name of the ClusterClass |
DELETE
delete a ClusterClass
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
HTTP code | Reponse body |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized |
Empty |
GET
read the specified ClusterClass
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
PATCH
partially update the specified ClusterClass
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
|
|
fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
PUT
replace the specified ClusterClass
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
|
|
fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized |
Empty |
Parameter | Type | Description |
---|---|---|
|
|
name of the ClusterClass |
GET
read status of the specified ClusterClass
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
PATCH
partially update status of the specified ClusterClass
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
|
|
fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized |
Empty |
PUT
replace status of the specified ClusterClass
Parameter | Type | Description |
---|---|---|
|
|
When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed |
|
|
fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized |
Empty |