vim_first_class_disk

First-Class Disks (FCD / Improved Virtual Disks) via VStorageObjectManager.

FCDs are vSphere objects that wrap a VMDK and live independently of any VM — used as persistent volumes for Tanzu / k8s, and as standalone disks for multi-attach or migration workflows.

Reference: https://developer.broadcom.com/xapis/vsphere-automation-api/latest/vim/com.vmware.vim.cluster.vstorageobjectmgr/

saltext.vcf.clients.vim_first_class_disk.list_(opts, datastore, profile=None)

Return every FCD on datastore as a list of dicts.

saltext.vcf.clients.vim_first_class_disk.get(opts, vstorage_object_id, datastore, profile=None)

Return one FCD by id.

saltext.vcf.clients.vim_first_class_disk.create(opts, name, datastore, capacity_gb, *, provisioning='thin', profile_id=None, keep_after_delete_vm=False, profile=None)

Create an FCD on datastore. Returns the vim.Task moId.

provisioning — thin, eagerZeroedThick, or lazyZeroedThick. profile_id — optional SPBM policy ID list.

saltext.vcf.clients.vim_first_class_disk.delete(opts, vstorage_object_id, datastore, profile=None)

Delete an FCD. Returns the vim.Task moId.

saltext.vcf.clients.vim_first_class_disk.rename(opts, vstorage_object_id, datastore, new_name, profile=None)

Rename an FCD.

saltext.vcf.clients.vim_first_class_disk.extend(opts, vstorage_object_id, datastore, new_capacity_gb, profile=None)

Grow an FCD to new_capacity_gb. Returns the vim.Task moId.

saltext.vcf.clients.vim_first_class_disk.register(opts, datastore, path, name, profile=None)

Register an existing VMDK as an FCD.

datastore is accepted for API symmetry but RegisterDisk derives the datastore from the VMDK path itself.

saltext.vcf.clients.vim_first_class_disk.set_keep_after_delete_vm(opts, vstorage_object_id, datastore, keep, profile=None)

Set whether the FCD survives the deletion of any VM it’s attached to.

saltext.vcf.clients.vim_first_class_disk.attach_to_vm(opts, vm, vstorage_object_id, datastore, *, controller_key=None, unit_number=None, profile=None)

Attach an FCD to a VM as an additional virtual disk.

Returns the vim.Task moId. controller_key and unit_number may be left None and vSphere will pick.

saltext.vcf.clients.vim_first_class_disk.detach_from_vm(opts, vm, vstorage_object_id, profile=None)

Detach an FCD from a VM (the disk remains, just unhooked).