inventory-ova

name: inventory-ova description: OVA inventory field reference and TSL query examples. Use when querying OVA provider inventory (VMs, disks, networks, storage).

OVA Inventory Reference

Field names and query examples for OVA providers. Replace <PROVIDER> and <NS> with actual values.

Key differences: OVA nested model types use PascalCase field names (untagged Go struct fields from OVF parsing), unlike vSphere/oVirt which use camelCase.

VM Fields

Identity

Field	Type	Example
`id`	string	Forklift internal ID
`name`	string	`"exported-vm"`
`variant`	string	`"ova"`
`path`	string	resource path
`ovfPath`	string	path to OVF file
`exportSource`	string	export origin
`uuid`	string	VM UUID

Compute

Field	Type	Example
`cpuCount`	number	`4`
`coresPerSocket`	number	`2`
`memoryMB`	number	`8192`
`memoryUnits`	string	`"MB"`
`cpuUnits`	string	`"cores"`

Guest and Firmware

Field	Type	Example
`osType`	string	`"rhel_8x64"`
`firmware`	string	`"efi"`, `"bios"`
`secureBoot`	bool	`false`

Features

Field	Type	Example
`cpuHotAddEnabled`	bool	`false`
`cpuHotRemoveEnabled`	bool	`false`
`memoryHotAddEnabled`	bool	`false`
`faultToleranceEnabled`	bool	`false`
`changeTrackingEnabled`	bool	`false`
`balloonedMemory`	number	`0`
`storageUsed`	number	bytes

Disks (`disks[*]`)

OVA disk fields use PascalCase:

Field	Type	Example
`disks[*].ID`	string	disk ID
`disks[*].Name`	string	`"disk-0"`
`disks[*].FilePath`	string	`"disk1.vmdk"`
`disks[*].Capacity`	number	bytes
`disks[*].CapacityAllocationUnits`	string	`"byte * 2^30"`
`disks[*].DiskId`	string	OVF disk reference
`disks[*].FileRef`	string	OVF file reference
`disks[*].Format`	string	`"http://www.vmware.com/interfaces/specifications/vmdk.html#streamOptimized"`
`disks[*].PopulatedSize`	number	bytes

NICs (`nics[*]`)

Field	Type	Example
`nics[*].Name`	string	`"ethernet0"`
`nics[*].MAC`	string	`"00:50:56:be:aa:bb"`
`nics[*].Network`	string	network name
`nics[].Config[].Key`	string	config key
`nics[].Config[].Value`	string	config value

Networks (`networks[*]`)

Field	Type	Example
`networks[*].ID`	string	network ID
`networks[*].Name`	string	`"VM Network"`
`networks[*].Description`	string	network description

Devices and Concerns

Field	Type	Example
`devices[*].Kind`	string	device type
`concerns[*].id`	string	concern ID
`concerns[*].label`	string	concern label
`concerns[*].category`	string	`"Warning"`
`concerns[*].assessment`	string	description

Disk Fields (standalone resource)

Query with get inventory disk --provider <PROVIDER>.

Field	Type	Example
`id`	string	Forklift internal ID
`name`	string	disk name
`variant`	string	`"ova"`
`path`	string	resource path
`FilePath`	string	`"disk1.vmdk"`
`Capacity`	number	bytes
`CapacityAllocationUnits`	string	`"byte * 2^30"`
`DiskId`	string	OVF disk reference
`FileRef`	string	OVF file reference
`Format`	string	VMDK format URI
`PopulatedSize`	number	bytes

Network Fields

Field	Type	Example
`id`	string	Forklift internal ID
`name`	string	`"VM Network"`
`variant`	string	`"ova"`
`Description`	string	network description

Storage Fields

Field	Type	Example
`id`	string	Forklift internal ID
`name`	string	storage name
`variant`	string	`"ova"`

VM Query Examples

mtv_read { "command": "get inventory vm", "flags": { "provider": "<PROVIDER>", "namespace": "<NS>", "query": "where cpuCount >= 4", "output": "markdown" } }

mtv_read { "command": "get inventory vm", "flags": { "provider": "<PROVIDER>", "namespace": "<NS>", "query": "where memoryMB > 8192", "output": "markdown" } }

mtv_read { "command": "get inventory vm", "flags": { "provider": "<PROVIDER>", "namespace": "<NS>", "query": "where firmware = 'efi'", "output": "markdown" } }

mtv_read { "command": "get inventory vm", "flags": { "provider": "<PROVIDER>", "namespace": "<NS>", "query": "where name ~= 'prod-.*'", "output": "markdown" } }

mtv_read { "command": "get inventory vm", "flags": { "provider": "<PROVIDER>", "namespace": "<NS>", "query": "where len(disks) > 1", "output": "markdown" } }