Cluster Creation Fails ,"Validate Cluster Spec, Distributed Virtual Portgroup with ID dvportgroup-#### not found"

Products

• VMware SDDC Manager / VCF Installer

Issue/Introduction

• During new cluster creation in VMware Cloud Foundation (VCF), validating a cluster specification fails with the message "Failed to validate cluster spec, Distributed Virtual Portgroup with ID dvportgroup-#### not found".
  
  
• /var/log/vmware/vcf/domainmanager/domainmanager.log on the SDDC Manager records the following error : 
  [PUBLIC_CLUSTERSPEC_VALIDATIONS_FAILED] Failed to validate cluster spec
...
Caused by: java.lang.IllegalArgumentException: Distributed Virtual Portgroup with ID <REDACTED_SECRETS> not found.
...
Entity DistributedVirtualPortgroup:<REDACTED_SECRETS> not found:
com.vmware.vim.binding.vmodl.fault.ManagedObjectNotFound: The object 'vim.dvs.DistributedVirtualPortgroup:####' has already been deleted or has not been completely created

Environment

VCF 9.0.1

Cause

The SDDC Manager database contains a stale Managed Object Reference (MoRef) ID for the Distributed Virtual Portgroup. This creates an inventory mismatch with the vCenter Server, typically occurring if a portgroup is modified, deleted, or recreated directly in vCenter outside of standard SDDC Manager workflows.

Resolution

Execute the following procedure to synchronize Workload Domain vCenter metadata to the SDDC Manager inventory:

1. Log in to VCF Operations using the administrator credentials.
2. Navigate to the Inventory menu via the left-hand navigation pane.
3. Expand the inventory hierarchy and select the target Workload Domain where manual modifications (e.g., cluster additions) were executed.
4. Click Actions to invoke the context menu.
5. Select Sync Inventory from the available tasks.
6. Confirm the execution prompt to initiate the background synchronization process. This polls the vCenter Server for the current configuration state and updates the SDDC Manager database.