VM Disk Attachment Fails with Invalid Configuration Error in vCenter Server.

Products

• VMware vCenter Server

Issue/Introduction

When attempting to attach an existing Virtual Machine Disk (VMDK) to a Virtual Machine (VM), the operation fails immediately. The vSphere client returns a generic but critical error message that prevents the hardware reconfiguration from completing.

• The Edit Settings task for the VM fails at 0% or shortly after clicking OK.

• Error Message: Invalid Configuration

Environment

VMware vCenter server Appliance 7.0.x

VMware vCenter server Appliance 8.0.x

Cause

The primary cause of this error in this specific scenario is a lack of sufficient permissions  for the user to  manage the VMs.

Resolution

Initial Validation 

To confirm the issue is permission-related, attempt the operation using the SSO Administrator account:

1. Log in to the vSphere Client using [email protected] (or your environment's equivalent SSO admin).
2. Attempt to attach the VMDK.
3. If the attachment succeeds, follow Method 1 to remediate user permissions.

Method 1: Update vCenter Permissions (Recommended)

Ensure the user account has the appropriate role assigned at the Datacenter or Cluster level.

1. Navigate to vCenter Server > Administration > Roles.
2. Verify the active role has the following privileges enabled:

• • Virtual Machine > Configuration > Add existing disk
  • Virtual Machine > Configuration > Change Settings
  • Datastore > Allocate space

    3. Re-attempt the disk attachment after refreshing the session.

Method 2: Direct ESXi Host Attachment (Workaround)

If vCenter permissions cannot be modified immediately, bypass vCenter by connecting directly to the host managing the VM.

1. Identify which ESXi host the VM is currently residing on.
2. Log in to the VMware Host Client (https://<ESXi_IP_or_FQDN>/ui) using root credentials.
3. Right-click the VM in the inventory and select Edit Settings.
4. Select Add Hard Disk > Existing Hard Disk.
5. Browse to the datastore and select the relevant .vmdk file.
6. Click Save.
7. Return to vCenter; the new configuration will be synchronized automatically.

Additional Information

Reference : VMware Documentation: Requirements for Adding Existing Disks