Specifications

Chapter 7: Search
Not all properties have a sub-property, therefore many named field searches use
the following syntax:
CI_TYPE.PROPERTY:VALUE.
Example search queries
The following section contains examples of the search syntax.
vm.cpuCount:2 AND vm.memory:1024
This query searches for all virtual machines with two CPUs and 1024 MBs of
memory as configured. The usage of MBs as the unit of measure for the memory
field is specific to the named field implementation.
You can also use more complex named field structures. They are based on dot
notation hierarchies as in the following example:
vm.environmentFor.networkAdapters.defaultGateway.ipV4Address:192.0.2.1
This query searches for virtual machines whose network adapter’s default
gateway is set to 192.0.2.1.
Named fields can also be composed of query sub-clauses and any other
additional search language features as in the following example:
vm.cpuCount:2 AND vm.memory:(1024 OR 2048)
In this example, the query searches for all virtual machines with two (2) CPUs and
1024 or 2048 MBs of memory as configured.
If a named field value contains special characters, it must be enclosed in quotes.
For example, the following query returns disk drives that are labeled "Hard", and
not "Hard Disk 1":
vm.environmentFor.diskVolume.label:Hard Disk 1
The correct version of the previous query is the following:
vm.environmentFor.diskVolume.label:"Hard Disk 1"
The following table contains an abbreviated list of fields and their description,
including the associated unit of measure.
Named field (without “vm.” qualifier) Description
cpuCount Number of
149