Vsan Space Report System Vsan Query Space Usage

Vsan Space Report System Vsan Query Space Usage

Query the vSAN space usage including the space usage overview and the space usage breakdown according to vSAN object type.

This API will take less than one or tens seconds to return according to the number of node and object in the vSAN cluster. The API can also be used to query vSAN datastore physical capacity and what-if capacity under specified storage policies.

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/vsan/VsanSpaceReportSystem/{moId}/VsanQuerySpaceUsage
COPY
Path Parameters
string
moId
Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case VsanSpaceReportSystem/{moId}.

string
release
Required

The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.


Request Body
VsanQuerySpaceUsageRequestType of type(s) application/json
Required
"VsanQuerySpaceUsageRequestType Object"
cluster
Required

vSAN cluster

Required privileges: System.Read

array of object
storagePolicies
Optional

Storage policies specified to calculate what-if capacity of the cluster vSAN datastore. Default value is None

boolean
whatifCapacityOnly
Optional

Flag indicates if the API is called only for getting vSAN datastore physical capacity and what-if capacity. Default value is False, which returns the vSAN space usage including the space usage overview and the space usage breakdown according to vSAN object type. When it is True, the API only returns the vSAN datastore physical capacity and what-if capacity under given storage policies.

Authentication
This operation uses the following authentication methods.
Responses
200

the vSAN space usage and vSAN datastore capacities.

Returns VsanSpaceUsage of type(s) application/json
"VsanSpaceUsage Object"
integer As int64 As int64
totalCapacityB
Required

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.

integer As int64 As int64
freeCapacityB
Optional

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.

spaceOverview
Optional

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.

spaceDetail
Optional

The vSAN space usage detail by breakdown the usage into different vSAN object type.

efficientCapacity
Optional

The vSAN efficient capacity breakdown details when the vSAN cluster enables data efficiency.

array of object
whatifCapacities
Optional

The vSAN capacity details if all objects are stored with the specified storage policy.

integer As int64 As int64
uncommittedB
Optional

Total additional storage space, in bytes, potentially used by all vSAN objects except for the virtual machine swap objects and namespace objects on this vSAN datastore.

It can be retrieved through VsanSpaceReportSystem.VsanQuerySpaceUsage by specifying whatifCapacityOnly as False.

capacityHealthThreshold
Optional

Indicates the yellow or red threshold, in bytes, for capacity usage based on current cluster capacityReservationInfo.

spaceEfficiencyRatio
Optional

Indicates the vSAN space efficiency ratio, it exists only when vSAN efficiency feature is enabled, including dedup and compression.

Since: 8.0.0.4


500

Failure

Returns RuntimeFault of type(s) application/json
This response body class contains all of the following: InlineRuntimeFault0
"RuntimeFault Object"

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/vsan/VsanSpaceReportSystem/{moId}/VsanQuerySpaceUsage