HostFilterSpec

The Host.FilterSpec structure contains fields used to filter the results when listing hosts (see Host.list). If multiple fields are specified, only hosts matching all of the fields match the filter.


Properties

array of string
clusters Optional

Clusters that must contain the hosts for the hosts to match the filter. If unset or empty, hosts in any cluster and hosts that are not in a cluster match the filter. If this field is not empty and Host.FilterSpec.standalone is true, no hosts will match the filter. When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: ClusterComputeResource. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: ClusterComputeResource.


connection_states Optional

The Host.ConnectionState enumerated type defines the connection status of a host.
CONNECTED : Host is connected to the vCenter Server
DISCONNECTED : Host is disconnected from the vCenter Server
NOT_RESPONDING : VirtualCenter is not receiving heartbeats from the server. The state automatically changes to connected once heartbeats are received again.

Possible values are: CONNECTEDDISCONNECTEDNOT_RESPONDING


array of string
datacenters Optional

Datacenters that must contain the hosts for the hosts to match the filter. If unset or empty, hosts in any datacenter match the filter. When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: Datacenter. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: Datacenter.


array of string
folders Optional

Folders that must contain the hosts for the hosts to match the filter. If unset or empty, hosts in any folder match the filter. When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: Folder. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: Folder.


array of string
hosts Optional

Identifiers of hosts that can match the filter. If unset or empty, hosts with any identifier match the filter. When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: HostSystem. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: HostSystem.


array of string
names Optional

Names that hosts must have to match the filter (see Host.Summary.name). If unset or empty, hosts with any name match the filter.


boolean
standalone Optional

If true, only hosts that are not part of a cluster can match the filter, and if false, only hosts that are are part of a cluster can match the filter. If unset Hosts can match filter independent of whether they are part of a cluster or not. If this field is true and Host.FilterSpec.clusters os not empty, no hosts will match the filter.

JSON Example

{
	"clusters": [
		"string"
	],
	"connection_states": "CONNECTED",
	"datacenters": [
		"string"
	],
	"folders": [
		"string"
	],
	"hosts": [
		"string"
	],
	"names": [
		"string"
	],
	"standalone": false
}

Feedback

Was this page helpful?