# Data Object - VsanEntitySpaceUsage(vim.cluster.VsanEntitySpaceUsage)

Returned by
  VsanQueryEntitySpaceUsage
Extends
  DynamicData
See also
  VimVsanDataEfficiencyCapacityState, VsanObjectSpaceSummary
Since
  vSAN API 7.0

## Data Object Description

This is base class describing the vSAN space usage for the general vSAN entity like virtual machine.

Properties

Name | Type | Description
--- | --- | ---
efficientCapacity* | VimVsanDataEfficiencyCapacityState | The efficient capacity breakdown details when the vSAN cluster enables data efficiency.
entityId* | xsd:string | The vSAN object entity ID. For the entity like virtual machine, it's the managed object ID like 'vm-1'.
freeCapacityB* | xsd:long | The free capacity in byte. It's the total of free physical space which can be used for writing data including any of user data, metadata and the overhead data.
spaceUsageByObjectType* | VsanObjectSpaceSummary[] | The vSAN space usage breakdown by object type for all of vSAN objects belonging to the entity.
totalCapacityB* | xsd:long | The total capacity in byte, which is the total used and free capacity combined. It's the total of physical space which can be use for writing data including any of user data, metadata and the overhead data.
Properties inherited from DynamicData
None

*Need not be set
Show WSDL type definition
<complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanEntitySpaceUsage"> <complexContent> <extension base="vsan:DynamicData"> <sequence> <element name="entityId" type="xsd:string" minOccurs="0"/> <element name="spaceUsageByObjectType" type="vsan:VsanObjectSpaceSummary" minOccurs="0" maxOccurs="unbounded"/> <element name="totalCapacityB" type="xsd:long" minOccurs="0"/> <element name="freeCapacityB" type="xsd:long" minOccurs="0"/> <element name="efficientCapacity" type="vsan:VimVsanDataEfficiencyCapacityState" minOccurs="0"/> </sequence> </extension> </complexContent> </complexType>