#VSphereMachineConfigPool [infrastructure.cluster.x-k8s.io/v1beta1]

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

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

VSphereMachineConfigPoolSpec defines the desired state of VSphereMachineConfigPool.

VSphereMachineConfigPoolStatus defines the observed state of VSphereMachineConfigPool.

ClusterRef references the CAPI Cluster (in the same namespace) whose VSphereCluster provides vCenter server, thumbprint, and credential chain (IdentityRef) for this pool's vCenter operations (e.g. disk reclaim). Required. Can only be changed when consumerRef is nil. The pool will not reconcile until the referenced Cluster and its VSphereCluster infrastructure are available.

Configs is the list of pre-defined machine configuration slots.

Datacenter is the default vSphere datacenter for slots in this pool. It is used when a slot does not define its own Datacenter.

ReleaseDelayHours is the time to wait before marking a released slot as "Available" for any machine. During this period, the slot can only be reused if specifically requested or via priority reuse. Default is 24.

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.

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

Datacenter is the vSphere datacenter for this slot. If set, it takes precedence over VSphereMachineConfigPool.spec.datacenter. If unset, the pool-level Datacenter acts as the default.

Hostname is the unique identifier for this slot and will be assigned to the VM. It must also be a valid Kubernetes node name because CAPV uses it for kubeadm nodeRegistration.name and the kubelet serving certificate DNS SAN.

Network describes the primary and additional network configurations for this slot.

PersistentDisks that survive VM deletion.

Additional are the remaining network configurations attached after the primary device.

Primary is the network configuration used for kubelet node IP registration.

DeviceName explicitly assigns a guest OS interface name to the network device.

DNS nameservers

IPv4 configuration

IPv6 configuration

NetworkName is the name of the vSphere network (PortGroup or DVPortGroup).

DeviceName explicitly assigns a guest OS interface name to the network device.

DNS nameservers

IPv4 configuration

IPv6 configuration

NetworkName is the name of the vSphere network (PortGroup or DVPortGroup).

Datastore is the vSphere datastore name.

DiskUUID is backfilled by the controller.

FSFormat is the filesystem format (default "ext4").

MountOptions for the filesystem mount.

MountPath is the mount path inside the VM guest OS (e.g., "/var/lib/etcd").

Name is the disk name.

SizeGiB is the disk size.

StoragePolicy is the vSphere storage policy name.

UnitNumber is the SCSI unit number for the disk (0-15, excluding 7). This ensures consistent disk ordering across VM recreations.

VolumePath is backfilled by the controller after the disk is created. For vSphere, this is usually the datastore path to the .vmdk file.

WipeFilesystem controls whether to wipe the filesystem content when the slot is reused by a new VM. When true, the disk content is cleared on the first boot of a new VM (reboots and manual service restarts are not affected). Defaults to false (data is preserved across VM recreations).

Conditions defines current state of the machine config pool.

ConfigStatuses tracks the state of each slot.

ConsumerRef is the workload controller (KubeadmControlPlane or MachineDeployment) currently bound to this pool. Set automatically by the controller when a machine allocates a slot. Cleared when the pool becomes fully reusable.

lastTransitionTime is the 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.

message is a human readable message indicating details about the transition. This field may be empty.

reason is 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 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.

Hostname matches the Hostname in the Spec.

LastReleasedTime is the timestamp when the slot transitioned to Released.

MachineRef is the reference to the Machine currently using this slot.

ReclaimStatus tracks asynchronous reclaim progress for this slot.

State is the allocation state of the slot.

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.

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

LastError stores the latest reclaim task failure.

RetryAfter prevents tight retry loops after reclaim task failures.

State tracks the lifecycle of the reclaim task.

TaskRef tracks the in-flight vCenter reclaim task for this slot.

VolumePath tracks the persistent disk currently being reclaimed.

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.

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