vSAN cluster properties missing in vSAN API Orchestrator Library

Products

• VCF Operations/Automation (formerly VMware Aria Suite)

Issue/Introduction

When using the vSAN plugin for VMware Aria Orchestrator to retrieve attributes of a vSAN cluster, the operation fails.

You may observe that the Orchestrator library is unable to process specific cluster properties, resulting in a failure to collect data.

The following error message is triggered during the Orchestrator Action or Workflow run:

UnmarshallException: Type 'VsanSpaceUsage' contains unrecognized property 'spaceEfficiencyRatio'

Environment

Aria Orchestrator 8.18.x

Cause

The root cause is a version mismatch where version 2.1 of the vSAN plugin is not compatible with newer vSphere/vSAN properties. Specifically, the plugin does not recognize the spaceEfficiencyRatio property within the VsanSpaceUsage type.

Resolution

To resolve this issue, you must update the plugin to a version that supports the newer property types.

1. Download the vSAN plugin for Orchestrator version 2.2 or higher [Link].

2. Install the updated plugin in your Orchestrator environment.

3. Verify that version 2.2 is active (In Orchestrator -> System Settings -> Plug-ins). This version is confirmed to be aware of the spaceEfficiencyRatio property.