Get Datastore Info for a Specific ESXi Host

Product version: 10.11

Last modified: 31 July 2024

Collects the data for all datastores within a specific ESXi host in Inventory. The returned identifier parameter for the necessary datastore is required to deploy a transporter as a VMware vSphere appliance.

Endpoint

https://<Director_IP_address>:4443/c/router

Tenant Endpoint

For tenants of the multi-tenant product the endpoint must be:

https://<Director_IP_address>:4443/t/<tenant_UUID>/c/router

Request Example

curl

Copy

curl --request POST \
    --url https://<Director_IP_address>:4443/c/router \
    --header "content-type: application/json" \
    --cookie @cookies.txt \
    --data '{         
        "action": "InventoryManagement",
        "method": "list",
        "data": [{ 
            "nodeType": "VMWARE_ESX",
            "nodeId": 1,
            "includeTypes": ["VMWARE_DATASTORE"]
            }], 
        "type": "rpc",
        "tid": 3}'

Request Fields

Field	Type	Value(s)
`action`	string	`InventoryManagement`
`method`	string	`list`
`data`	array	See parameters below
`type`	string	`rpc`
`tid`	integer	`3`

data

Field	Type	Value(s)
`nodeType`	string	Type of inventory item; in this case, `“VMWARE_ESX”`
`nodeId`	string	The ID of the chosen node type; in this case, the ESXi host identifier value obtained previously
`includeTypes`	string	Specifies the type of objects to list; for datastores, `["VMWARE_DATASTORE"]`

Response Sample

curl

Copy

 {
   "action": "InventoryManagement",
   "method": "list",
   "tid": "3",
   "type": "rpc",
   "message": null,
   "where": null,
   "cause": null,
   "data": {
       "children": [
           {
               "readOnlyHostMorIds": [
                   "host-23"               ],
               "free": 79967166464,
               "size": 1314256842752,
               "online": true,
               "parentStorageVid": null,
               "identifier": 8,
               "vid": "VMWARE_DATASTORE-8",
               "type": "VMWARE_DATASTORE",
               "subType": "NFS",
               "name": "VMTemplates02",
               "description": null,
               "accessible": false,
               "isDisabled": false,
               "replicable": false,
               "hvType": "VMWARE",
               "flags": 0,
               "subName": null,
               "children": null
           },
           {
               "readOnlyHostMorIds": [],
               "free": 64730693632,
               "size": 2000112582656,
               "online": true,
               "parentStorageVid": null,
               "identifier": 2,
               "vid": "VMWARE_DATASTORE-2",
               "type": "VMWARE_DATASTORE",
               "subType": "VMFS",
               "name": "Local-noRAID-MK",
               "description": null,
               "accessible": false,
               "isDisabled": false,
               "replicable": false,
               "hvType": "VMWARE",
               "flags": 0,
               "subName": null,
               "children": null
           }
       ],
       "totalCount": 2
   }
}

Response Fields

Field	Value	Description
`message`	string	Message if the request failed
`where`	string	Reference to the method where a problem occurred
`cause`	string	Cause of failure
`data.children`	array	See parameters below
`data.totalCount`	integer	Total number of located datastores in ESXi host

data.children

Field	Value	Description
`readOnlyHostMorIds`	array	Datastore, read-only host reference IDs
`free`	`long`	Free space
`size`	`long`	Size of the datastore
`online`	boolean	true if the datastore is online
`parentStorageVid`	string	Virtual identifier (VID) of the parent datastore, if applicable
`identifier`	int	Datastore ID
`vid`	string	Virtual identifier (VID) of the datastore
`type`	string	Datastore type
`subType`	string	Datastore subtype
`name`	string	Datastore name
`description`	string	Datastore description
`accessible`	boolean	`true` if the datastore is accessible
`isDisabled`	boolean	`true` if the datastore is disabled
`replicable`	boolean	`true` if the datastore is replicable
`hvType`	string	Hypervisor type
`flags`	int	0^th-bit checks if the host is free 1^st-bit checks if the host is managed by a vCenter
`subName`	string	Sub-name, if applicable
`children`	array	Datastore’s child objects, if applicable