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

Returned by
  VsanQuerySpaceUsage
Extends
  DynamicData
See also
  VimVsanDataEfficiencyCapacityState, VsanObjectSpaceSummary, VsanSpaceUsageDetailResult
Since
  vSphere API 5.5

## Data Object Description

Describes the vSAN space usage. There are multiple ways to present the space usage. One way is presenting the overall vSAN cluster system space usage like total used space in which how much data is physically written into disk and how much is the over-reserved space size. A second is listing the space usage breakdown per vSAN object type defined in VsanObjectTypeEnum.

Properties

Name | Type | Description
--- | --- | ---
efficientCapacity* | VimVsanDataEfficiencyCapacityState | The vSAN efficient capacity breakdown details when the vSAN cluster enables data efficiency. Since vSAN API 6.7
freeCapacityB* | xsd:long | The free vSAN capacity in byte. It's the total of free vSAN physical space which can be used for writing data including any of user data, metadata and the overhead data.
spaceDetail* | VsanSpaceUsageDetailResult | The vSAN space usage detail by breakdown the usage into different vSAN object type.
spaceOverview* | VsanObjectSpaceSummary | The vSAN space usage overview including the vSAN physically written capacity, the reserved and over-reserved capacity and the total used capacity. It shares the same data structure as the per vSAN object type space usage summary VsanObjectSpaceSummary without setting the object type.
totalCapacityB | xsd:long | The total vSAN 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="VsanSpaceUsage"> <complexContent> <extension base="vsan:DynamicData"> <sequence> <element name="totalCapacityB" type="xsd:long"/> <element name="freeCapacityB" type="xsd:long" minOccurs="0"/> <element name="spaceOverview" type="vsan:VsanObjectSpaceSummary" minOccurs="0"/> <element name="spaceDetail" type="vsan:VsanSpaceUsageDetailResult" minOccurs="0"/> <element name="efficientCapacity" type="vsan:VimVsanDataEfficiencyCapacityState" minOccurs="0"/> </sequence> </extension> </complexContent> </complexType>