record:host_ipv4addr : IPv4 Host address object.

A Host Address is an object used to specify addresses in the record.host object.

Fields other than ipv4addr, host and configure_for_dhcp are returned only when configure_for_dhcp is true.

Object Reference

References to record:host_ipv4addr are object references. The name part of an IPv4 Host Address object reference has the following components:

  • Address of the record

  • Name of the host to which the IPv4 address belongs

  • Name of the view

Example: record:host_ipv4addr/ZG5zvc3RjkuMC4xLg:9.9.0.1/some.name.com/default

Restrictions

The object does not support the following operations:

  • Create (insert)

  • Delete

  • Permissions

  • Scheduling

  • CSV export

Fields

These fields are actual members of the object; thus, they can be requested by using _return_fields, if the fields are readable.

The basic version of the object contains the field(s): configure_for_dhcp, host, ipv4addr, mac.

The following fields are required to create this object:

Field

Notes

ipv4addr

bootfile

bootfile

The name of the boot file the client must download.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The default value is empty.

Search

The field is not available for search.

Notes

bootfile is associated with the field use_bootfile (see use flag).

bootserver

bootserver

The IP address or hostname of the boot file server where the boot file is stored.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The default value is empty.

Search

The field is not available for search.

Notes

bootserver is associated with the field use_bootserver (see use flag).

configure_for_dhcp

configure_for_dhcp

Set this to True to enable the DHCP configuration for this host address.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

Notes

The configure_for_dhcp is part of the base object.

deny_bootp

deny_bootp

Set this to True to disable the BOOTP settings and deny BOOTP boot requests.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

Notes

deny_bootp is associated with the field use_deny_bootp (see use flag).

discover_now_status

discover_now_status

The discovery status of this Host Address.

Type

String.

Valid values are:
  • COMPLETE

  • FAILED

  • NONE

  • PENDING

  • RUNNING

Search

The field is not available for search.

Notes

The discover_now_status cannot be updated.

discover_now_status cannot be written.

discovered_data

discovered_data

The discovered data for this Host Address.

Type

A/An Discovered data struct.

Search

The field is not available for search.

Notes

The discovered_data cannot be updated.

discovered_data cannot be written.

enable_pxe_lease_time

enable_pxe_lease_time

Set this to True if you want the DHCP server to use a different lease time for PXE clients. You can specify the duration of time it takes a host to connect to a boot server, such as a TFTP server, and download the file it needs to boot. For example, set a longer lease time if the client downloads an OS (operating system) or configuration file, or set a shorter lease time if the client downloads only configuration changes. Enter the lease time for the preboot execution environment for hosts to boot remotely from a server.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

host

host

The host to which the host address belongs, in FQDN format. It is only present when the host address object is not returned as part of a host.

Type

String.

Search

The field is not available for search.

Notes

The host is part of the base object.

The host cannot be updated.

host cannot be written.

ignore_client_requested_options

ignore_client_requested_options

If this field is set to false, the appliance returns all DHCP options the client is eligible to receive, rather than only the list of options the client has requested.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

Notes

ignore_client_requested_options is associated with the field use_ignore_client_requested_options (see use flag).

ipv4addr

ipv4addr

The IPv4 Address of the host.

Type

String.

The field also supports automatic selection of the next available address in the specified network or range. You can specify the network or range in the following ways:

Using a network or range WAPI reference:

  • func:nextavailableip:<reference>

Using a network lookup (if the view is not specified, the default view will be used):

  • func:nextavailableip:<network>[,<network view>]

Using a range lookup (if the view is not specified, the default view will be used):

  • func:nextavailableip:<start_addr-end_addr>[,<network view>]

Scheduled and approval operations are not supported when using the automatic IP selection.

If you specify a network view for automatic IP selection, you should also add a network_view field in the object to be inserted with the same network view because the network view for automatic IP selection is not used for the actual object insertion.

NOTE: Automatic selection is supported only for JSON and XML requests.

Examples:

  • func:nextavailableip:network/ZG54dfgsrDFEFfsfsLzA:10.0.0.0/8/default

  • func:nextavailableip:10.0.0.0/8

  • func:nextavailableip:10.0.0.0/8,external

  • func:nextavailableip:10.0.0.3-10.0.0.10

This field can also be retrieved from a function call as part of an object insertion. The supported function calls for this field are:

To find out if the function can be called when _object_parameters matches multiple objects, see the function documentation.

The default parameters are passed to the specified function call and can be overridden by passing different values for the same parameter in _parameters.

To execute the function call, a dictionary must be set in this field with the following parameters:

Mandatory

Name

Comment

Y

_object_function

The name of the function.

Y

_result_field

The field in which the function returns its result.

See comment

_object

The WAPI object type on which the function calls. Either _object or _object_ref must be set.

See comment

_object_ref

A WAPI object reference on which the function calls. Either _object or _object_ref must be set.

N

_parameters

The parameters to be passed to the function.

See comment

_object_parameters

The parameters used for the object search, mandatory if _object is set.

As part of the insertion, the object identified by _object and _object_parameters will be fetched, and the function identified by _object_function will be called with the parameters specified in _parameters. The result of this function will be retrieved and the field of this function specified in _result_field will be extracted and used as the value for this field.

Note that if the function call returns a list, and the field requires a single value, the first value on the list will be used.

The following example uses a value for the ‘next_available_ip’ field in the 9.0.0.0/8 network, excluding IP addresses 9.0.0.1 and 9.0.0.2:

{
    '_object_function': 'next_available_ip',
    '_parameters': {
        'exclude': ['9.0.0.1', '9.0.0.2'],
    },
    '_result_field': 'ips',
    '_object': 'network',
    '_object_parameters': {
        'network': '9.0.0.0/8',
        'network_view': 'newdefaultnv',
    }
}

Note this function call might not be valid for this particular field, this is just an example.

Create

The field is required on creation.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

Notes

The ipv4addr is part of the base object.

is_invalid_mac

is_invalid_mac

This flag reflects whether the MAC address for this host address is invalid.

Type

Bool.

Search

The field is not available for search.

Notes

The is_invalid_mac cannot be updated.

is_invalid_mac cannot be written.

last_queried

last_queried

The time of the last DNS query in Epoch seconds format.

Type

Timestamp.

Search

The field is not available for search.

Notes

The last_queried cannot be updated.

last_queried cannot be written.

logic_filter_rules

logic_filter_rules

This field contains the logic filters to be applied on the this host address.

This list corresponds to the match rules that are written to the dhcpd configuration file.

Type

A/An Logic Filter rule struct array.

Create

The default value is:

empty

Search

The field is not available for search.

Notes

logic_filter_rules is associated with the field use_logic_filter_rules (see use flag).

mac

mac

The MAC address for this host address.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The default value is empty.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

Notes

The mac is part of the base object.

match_client

match_client

Set this to ‘MAC_ADDRESS’ to assign the IP address to the selected host, provided that the MAC address of the requesting host matches the MAC address that you specify in the field.

Set this to ‘RESERVED’ to reserve this particular IP address for future use, or if the IP address is statically configured on a system (the Infoblox server does not assign the address from a DHCP request).

Type

String.

Create

The default value is MAC_ADDRESS.

Search

The field is not available for search.

ms_ad_user_data

ms_ad_user_data

The Microsoft Active Directory user related information.

Type

A/An Active Directory User Data struct.

Search

The field is not available for search.

Notes

The ms_ad_user_data cannot be updated.

ms_ad_user_data cannot be written.

network

network

The network of the host address, in FQDN/CIDR format.

Type

String.

Search

The field is not available for search.

Notes

The network cannot be updated.

network cannot be written.

network_view

network_view

The name of the network view in which the host address resides.

Type

String.

Values with leading or trailing white space are not valid for this field.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

The network_view cannot be updated.

network_view cannot be written.

nextserver

nextserver

The name in FQDN format and/or IPv4 Address of the next server that the host needs to boot.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The default value is empty.

Search

The field is not available for search.

Notes

nextserver is associated with the field use_nextserver (see use flag).

options

options

An array of DHCP option structs that lists the DHCP options associated with the object.

Type

A/An DHCP option struct array.

Create

The default value is:

[ { 'name': 'dhcp-lease-time',
'num': 51,
'use_option': False,
'value': '43200',
'vendor_class': 'DHCP'}]

Search

The field is not available for search.

Notes

options is associated with the field use_options (see use flag).

pxe_lease_time

pxe_lease_time

The lease time for PXE clients, see enable_pxe_lease_time for more information.

Type

Unsigned integer.

Create

The default value is empty.

Search

The field is not available for search.

Notes

pxe_lease_time is associated with the field use_pxe_lease_time (see use flag).

reserved_interface

reserved_interface

The reference to the reserved interface to which the device belongs.

Type

String.

This field supports nested return fields as described here.

Create

The default value is empty.

Search

The field is not available for search.

use_bootfile

use_bootfile

Use flag for: bootfile

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

use_bootserver

use_bootserver

Use flag for: bootserver

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

use_deny_bootp

use_deny_bootp

Use flag for: deny_bootp

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

use_for_ea_inheritance

use_for_ea_inheritance

Set this to True when using this host address for EA inheritance.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

use_ignore_client_requested_options

use_ignore_client_requested_options

Use flag for: ignore_client_requested_options

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

use_logic_filter_rules

use_logic_filter_rules

Use flag for: logic_filter_rules

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

use_nextserver

use_nextserver

Use flag for: nextserver

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

use_options

use_options

Use flag for: options

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

use_pxe_lease_time

use_pxe_lease_time

Use flag for: pxe_lease_time

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

Search-only Fields

These fields are used only for searching. They are not actual members of the object and therefore the server does not return these fields with this name unless they are nested return fields.

discovered_data.ap_ip_address

discovered_data.ap_ip_address

Discovered IP address of Wireless Access Point.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.ap_ip_address is a search-only field.

discovered_data.ap_name

discovered_data.ap_name

Discovered name of Wireless Access Point.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.ap_name is a search-only field.

discovered_data.ap_ssid

discovered_data.ap_ssid

Service set identifier (SSID) associated with Wireless Access Point.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.ap_ssid is a search-only field.

discovered_data.bgp_as

discovered_data.bgp_as

The BGP autonomous system number.

Type

Unsigned integer.

Search

The field is available for search via

  • ‘!=’ (negative search)

  • ‘<=’ (less than search)

  • ‘=’ (exact equality)

  • ‘>=’ (greater than search)

Notes

discovered_data.bgp_as is a search-only field.

discovered_data.bridge_domain

discovered_data.bridge_domain

Discovered bridge domain.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.bridge_domain is a search-only field.

discovered_data.cisco_ise_endpoint_profile

discovered_data.cisco_ise_endpoint_profile

The Cisco ISE Endpoint Profile.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.cisco_ise_endpoint_profile is a search-only field.

discovered_data.cisco_ise_security_group

discovered_data.cisco_ise_security_group

The Cisco ISE security group name.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.cisco_ise_security_group is a search-only field.

discovered_data.cisco_ise_session_state

discovered_data.cisco_ise_session_state

The Cisco ISE session state.

Type

String.

Valid values are:
  • AUTHENTICATED

  • AUTHENTICATING

  • DISCONNECTED

  • POSTURED

  • STARTED

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.cisco_ise_session_state is a search-only field.

discovered_data.cisco_ise_ssid

discovered_data.cisco_ise_ssid

The Cisco ISE SSID.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.cisco_ise_ssid is a search-only field.

discovered_data.cmp_type

discovered_data.cmp_type
If the IP is coming from a Cloud environment, the Cloud Management

Platform type.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.cmp_type is a search-only field.

discovered_data.device_contact

discovered_data.device_contact

Contact information from device on which the IP address was discovered.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.device_contact is a search-only field.

discovered_data.device_location

discovered_data.device_location

Location of device on which the IP address was discovered.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.device_location is a search-only field.

discovered_data.device_model

discovered_data.device_model

The model name of the end device in the vendor terminology.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.device_model is a search-only field.

discovered_data.device_port_name

discovered_data.device_port_name

The system name of the interface associated with the discovered IP address.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.device_port_name is a search-only field.

discovered_data.device_port_type

discovered_data.device_port_type

The hardware type of the interface associated with the discovered IP address.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.device_port_type is a search-only field.

discovered_data.device_type

discovered_data.device_type

The type of end host in vendor terminology.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.device_type is a search-only field.

discovered_data.device_vendor

discovered_data.device_vendor

The vendor name of the end host.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.device_vendor is a search-only field.

discovered_data.discovered_name

discovered_data.discovered_name

The name of the network device associated with the discovered IP address.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.discovered_name is a search-only field.

discovered_data.discoverer

discovered_data.discoverer

Specifies whether the IP address was discovered by a NetMRI or NIOS discovery process.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.discoverer is a search-only field.

discovered_data.endpoint_groups

discovered_data.endpoint_groups

A comma-separated list of discovered endpoint groups.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.endpoint_groups is a search-only field.

discovered_data.first_discovered

discovered_data.first_discovered

The date and time the IP address was first discovered in Epoch seconds format.

Type

Timestamp.

Search

The field is available for search via

  • ‘!=’ (negative search)

  • ‘<=’ (less than search)

  • ‘=’ (exact equality)

  • ‘>=’ (greater than search)

Notes

discovered_data.first_discovered is a search-only field.

discovered_data.iprg_no

discovered_data.iprg_no

The port redundant group number.

Type

Unsigned integer.

Search

The field is available for search via

  • ‘<=’ (less than search)

  • ‘>=’ (greater than search)

  • ‘=’ (exact equality)

  • ‘!=’ (negative search)

Notes

discovered_data.iprg_no is a search-only field.

discovered_data.iprg_state

discovered_data.iprg_state

The status for the IP address within port redundant group.

Type

String.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.iprg_state is a search-only field.

discovered_data.iprg_type

discovered_data.iprg_type

The port redundant group type.

Type

String.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.iprg_type is a search-only field.

discovered_data.last_discovered

discovered_data.last_discovered

The date and time the IP address was last discovered in Epoch seconds format.

Type

Timestamp.

Search

The field is available for search via

  • ‘!=’ (negative search)

  • ‘<=’ (less than search)

  • ‘=’ (exact equality)

  • ‘>=’ (greater than search)

Notes

discovered_data.last_discovered is a search-only field.

discovered_data.mac_address

discovered_data.mac_address

The discovered MAC address for the host. This is the unique identifier of a network device. The discovery acquires the MAC address for hosts that are located on the same network as the Grid member that is running the discovery. This can also be the MAC address of a virtual entity on a specified vSphere server.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.mac_address is a search-only field.

discovered_data.mgmt_ip_address

discovered_data.mgmt_ip_address

The management IP address of the end host that has more than one IP.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.mgmt_ip_address is a search-only field.

discovered_data.netbios_name

discovered_data.netbios_name

The name returned in the NetBIOS reply or the name you manually register for the discovered host.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.netbios_name is a search-only field.

discovered_data.network_component_contact

discovered_data.network_component_contact

Contact information from network component on which the IP address was discovered.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.network_component_contact is a search-only field.

discovered_data.network_component_description

discovered_data.network_component_description

A textual description of the switch that is connected to the end device.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.network_component_description is a search-only field.

discovered_data.network_component_ip

discovered_data.network_component_ip

The IPv4 Address or IPv6 Address of the switch that is connected to the end device.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

Notes

discovered_data.network_component_ip is a search-only field.

discovered_data.network_component_location

discovered_data.network_component_location

Location of network component on which the IP address was discovered.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.network_component_location is a search-only field.

discovered_data.network_component_model

discovered_data.network_component_model

Model name of the switch port connected to the end device in the vendor terminology.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.network_component_model is a search-only field.

discovered_data.network_component_name

discovered_data.network_component_name

If a reverse lookup was successful for the IP address associated with this switch, the host name is displayed here.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.network_component_name is a search-only field.

discovered_data.network_component_port_description

discovered_data.network_component_port_description

A textual description of the switch port that is connected to the end device.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.network_component_port_description is a search-only field.

discovered_data.network_component_port_name

discovered_data.network_component_port_name

The name of the switch port connected to the end device.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.network_component_port_name is a search-only field.

discovered_data.network_component_port_number

discovered_data.network_component_port_number

The number of the switch port connected to the end device.

Type

Unsigned integer.

Search

The field is available for search via

  • ‘<=’ (less than search)

  • ‘>=’ (greater than search)

  • ‘=’ (exact equality)

  • ‘!=’ (negative search)

Notes

discovered_data.network_component_port_number is a search-only field.

discovered_data.network_component_type

discovered_data.network_component_type

Identifies the switch that is connected to the end device.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.network_component_type is a search-only field.

discovered_data.network_component_vendor

discovered_data.network_component_vendor

The vendor name of the switch port connected to the end host.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.network_component_vendor is a search-only field.

discovered_data.open_ports

discovered_data.open_ports

The list of opened ports on the IP address, represented as: “TCP: 21,22,23 UDP: 137,139”. Limited to max total 1000 ports.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.open_ports is a search-only field.

discovered_data.os

discovered_data.os

The operating system of the detected host or virtual entity. The OS can be one of the following:

  • Microsoft for all discovered hosts that have a non-null value in the MAC addresses using the NetBIOS discovery method.

  • A value that a TCP discovery returns.

  • The OS of a virtual entity on a vSphere server.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.os is a search-only field.

discovered_data.port_duplex

discovered_data.port_duplex

The negotiated or operational duplex setting of the switch port connected to the end device.

Type

String.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.port_duplex is a search-only field.

discovered_data.port_speed

discovered_data.port_speed

The interface speed, in Mbps, of the switch port.

Type

String.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.port_speed is a search-only field.

discovered_data.port_status

discovered_data.port_status

The operational status of the switch port. Indicates whether the port is up or down.

Type

String.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.port_status is a search-only field.

discovered_data.port_type

discovered_data.port_type

The type of switch port.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.port_type is a search-only field.

discovered_data.port_vlan_description

discovered_data.port_vlan_description

The description of the VLAN of the switch port that is connected to the end device.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.port_vlan_description is a search-only field.

discovered_data.port_vlan_name

discovered_data.port_vlan_name

The name of the VLAN of the switch port.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.port_vlan_name is a search-only field.

discovered_data.port_vlan_number

discovered_data.port_vlan_number

The ID of the VLAN of the switch port.

Type

Unsigned integer.

Search

The field is available for search via

  • ‘<=’ (less than search)

  • ‘>=’ (greater than search)

  • ‘=’ (exact equality)

  • ‘!=’ (negative search)

Notes

discovered_data.port_vlan_number is a search-only field.

discovered_data.task_name

discovered_data.task_name

The name of the discovery task.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.task_name is a search-only field.

discovered_data.tenant

discovered_data.tenant

Discovered tenant.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.tenant is a search-only field.

discovered_data.v_adapter

discovered_data.v_adapter

The name of the physical network adapter through which the virtual entity is connected to the appliance.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.v_adapter is a search-only field.

discovered_data.v_cluster

discovered_data.v_cluster

The name of the VMware cluster to which the virtual entity belongs.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.v_cluster is a search-only field.

discovered_data.v_datacenter

discovered_data.v_datacenter

The name of the vSphere datacenter or container to which the virtual entity belongs.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.v_datacenter is a search-only field.

discovered_data.v_entity_name

discovered_data.v_entity_name

The name of the virtual entity.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.v_entity_name is a search-only field.

discovered_data.v_entity_type

discovered_data.v_entity_type

The virtual entity type. This can be blank or one of the following: Virtual Machine, Virtual Host, or Virtual Center. Virtual Center represents a VMware vCenter server.

Type

String.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.v_entity_type is a search-only field.

discovered_data.v_host

discovered_data.v_host

The name of the VMware server on which the virtual entity was discovered.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.v_host is a search-only field.

discovered_data.v_switch

discovered_data.v_switch

The name of the switch to which the virtual entity is connected.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.v_switch is a search-only field.

discovered_data.vlan_port_group

discovered_data.vlan_port_group

Port group which the virtual machine belongs to.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vlan_port_group is a search-only field.

discovered_data.vmhost_ip_address

discovered_data.vmhost_ip_address
IP address of the physical node on which the virtual machine is

hosted.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vmhost_ip_address is a search-only field.

discovered_data.vmhost_mac_address

discovered_data.vmhost_mac_address
MAC address of the physical node on which the virtual machine is

hosted.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vmhost_mac_address is a search-only field.

discovered_data.vmhost_name

discovered_data.vmhost_name
Name of the physical node on which the virtual machine is

hosted.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vmhost_name is a search-only field.

discovered_data.vmhost_nic_names

discovered_data.vmhost_nic_names
List of all physical port names used by the virtual switch on the

physical node on which the virtual machine is hosted. Represented as: “eth1,eth2,eth3”.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vmhost_nic_names is a search-only field.

discovered_data.vmhost_subnet_cidr

discovered_data.vmhost_subnet_cidr
CIDR subnet of the physical node on which the virtual machine

is hosted.

Type

Unsigned integer.

Search

The field is available for search via

  • ‘!=’ (negative search)

  • ‘<=’ (less than search)

  • ‘=’ (exact equality)

  • ‘>=’ (greater than search)

Notes

discovered_data.vmhost_subnet_cidr is a search-only field.

discovered_data.vmi_id

discovered_data.vmi_id

ID of the virtual machine.

Type

String.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.vmi_id is a search-only field.

discovered_data.vmi_ip_type

discovered_data.vmi_ip_type

Discovered IP address type.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vmi_ip_type is a search-only field.

discovered_data.vmi_is_public_address

discovered_data.vmi_is_public_address

Indicates whether the IP address is a public address.

Type

Bool.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.vmi_is_public_address is a search-only field.

discovered_data.vmi_name

discovered_data.vmi_name

Name of the virtual machine.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vmi_name is a search-only field.

discovered_data.vmi_private_address

discovered_data.vmi_private_address

Private IP address of the virtual machine.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vmi_private_address is a search-only field.

discovered_data.vmi_tenant_id

discovered_data.vmi_tenant_id

ID of the tenant which virtual machine belongs to.

Type

String.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.vmi_tenant_id is a search-only field.

discovered_data.vport_conf_mode

discovered_data.vport_conf_mode
Configured mode of the network adapter on the virtual switch

where the virtual machine connected to.

Type

String.

Valid values are:
  • Full-duplex

  • Half-duplex

  • Unknown

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.vport_conf_mode is a search-only field.

discovered_data.vport_conf_speed

discovered_data.vport_conf_speed
Configured speed of the network adapter on the virtual switch

where the virtual machine connected to. Unit is kb.

Type

Unsigned integer.

Search

The field is available for search via

  • ‘!=’ (negative search)

  • ‘<=’ (less than search)

  • ‘=’ (exact equality)

  • ‘>=’ (greater than search)

Notes

discovered_data.vport_conf_speed is a search-only field.

discovered_data.vport_mac_address

discovered_data.vport_mac_address
MAC address of the network adapter on the virtual switch where the

virtual machine connected to.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vport_mac_address is a search-only field.

discovered_data.vport_mode

discovered_data.vport_mode
Actual mode of the network adapter on the virtual switch where

the virtual machine connected to.

Type

String.

Valid values are:
  • Full-duplex

  • Half-duplex

  • Unknown

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.vport_mode is a search-only field.

discovered_data.vport_name

discovered_data.vport_name
Name of the network adapter on the virtual switch connected with

the virtual machine.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vport_name is a search-only field.

discovered_data.vport_speed

discovered_data.vport_speed
Actual speed of the network adapter on the virtual switch where

the virtual machine connected to. Unit is kb.

Type

Unsigned integer.

Search

The field is available for search via

  • ‘!=’ (negative search)

  • ‘<=’ (less than search)

  • ‘=’ (exact equality)

  • ‘>=’ (greater than search)

Notes

discovered_data.vport_speed is a search-only field.

discovered_data.vrf_description

discovered_data.vrf_description

Description of the VRF.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vrf_description is a search-only field.

discovered_data.vrf_name

discovered_data.vrf_name

The name of the VRF.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vrf_name is a search-only field.

discovered_data.vrf_rd

discovered_data.vrf_rd

Route distinguisher of the VRF.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

Notes

discovered_data.vrf_rd is a search-only field.

discovered_data.vswitch_available_ports_count

discovered_data.vswitch_available_ports_count
Numer of available ports reported by the virtual switch on

which the virtual machine/vport connected to.

Type

Unsigned integer.

Search

The field is available for search via

  • ‘!=’ (negative search)

  • ‘<=’ (less than search)

  • ‘=’ (exact equality)

  • ‘>=’ (greater than search)

Notes

discovered_data.vswitch_available_ports_count is a search-only field.

discovered_data.vswitch_id

discovered_data.vswitch_id

ID of the virtual switch.

Type

String.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.vswitch_id is a search-only field.

discovered_data.vswitch_ipv6_enabled

discovered_data.vswitch_ipv6_enabled

Indicates the virtual switch has IPV6 enabled.

Type

Bool.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.vswitch_ipv6_enabled is a search-only field.

discovered_data.vswitch_name

discovered_data.vswitch_name

Name of the virtual switch.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vswitch_name is a search-only field.

discovered_data.vswitch_segment_id

discovered_data.vswitch_segment_id
ID of the network segment on which the current virtual

machine/vport connected to.

Type

String.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.vswitch_segment_id is a search-only field.

discovered_data.vswitch_segment_name

discovered_data.vswitch_segment_name
Name of the network segment on which the current virtual

machine/vport connected to.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vswitch_segment_name is a search-only field.

discovered_data.vswitch_segment_port_group

discovered_data.vswitch_segment_port_group
Port group of the network segment on which the current virtual

machine/vport connected to.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vswitch_segment_port_group is a search-only field.

discovered_data.vswitch_segment_type

discovered_data.vswitch_segment_type
Type of the network segment on which the current virtual

machine/vport connected to.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vswitch_segment_type is a search-only field.

discovered_data.vswitch_tep_dhcp_server

discovered_data.vswitch_tep_dhcp_server
DHCP server of the virtual tunnel endpoint (VTEP) in the virtual

switch.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vswitch_tep_dhcp_server is a search-only field.

discovered_data.vswitch_tep_ip

discovered_data.vswitch_tep_ip
IP address of the virtual tunnel endpoint (VTEP) in the virtual

switch.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vswitch_tep_ip is a search-only field.

discovered_data.vswitch_tep_multicast

discovered_data.vswitch_tep_multicast
Muticast address of the virtual tunnel endpoint (VTEP) in the

virtual swtich.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vswitch_tep_multicast is a search-only field.

discovered_data.vswitch_tep_port_group

discovered_data.vswitch_tep_port_group
Port group of the virtual tunnel endpoint (VTEP) in the virtual

switch.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vswitch_tep_port_group is a search-only field.

discovered_data.vswitch_tep_type

discovered_data.vswitch_tep_type

Type of virtual tunnel endpoint (VTEP) in the virtual switch.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vswitch_tep_type is a search-only field.

discovered_data.vswitch_tep_vlan

discovered_data.vswitch_tep_vlan
VLAN of the virtual tunnel endpoint (VTEP) in the virtual

switch.

Type

String.

Search

The field is available for search via

  • ‘~=’ (regular expression)

  • ‘=’ (exact equality)

  • ‘:=’ (case insensitive search)

Notes

discovered_data.vswitch_tep_vlan is a search-only field.

discovered_data.vswitch_type

discovered_data.vswitch_type

Type of the virtual switch: standard or distributed.

Type

String.

Valid values are:
  • Distributed

  • Standard

  • Unknown

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

discovered_data.vswitch_type is a search-only field.

Fields List

Field

Type

Req

R/O

Base

Search

bootfile

String

N

N

N

N/A

bootserver

String

N

N

N

N/A

configure_for_dhcp

Bool

N

N

Y

N/A

deny_bootp

Bool

N

N

N

N/A

discover_now_status

String

N

Y

N

N/A

discovered_data

struct

N

Y

N

N/A

enable_pxe_lease_time

Bool

N

N

N

N/A

host

String

N

Y

Y

N/A

ignore_client_requested_options

Bool

N

N

N

N/A

ipv4addr

String

Y

N

Y

= ~

is_invalid_mac

Bool

N

Y

N

N/A

last_queried

Timestamp

N

Y

N

N/A

logic_filter_rules

[struct]

N

N

N

N/A

mac

String

N

N

Y

= ~

match_client

String

N

N

N

N/A

ms_ad_user_data

struct

N

Y

N

N/A

network

String

N

Y

N

N/A

network_view

String

N

Y

N

=

nextserver

String

N

N

N

N/A

options

[struct]

N

N

N

N/A

pxe_lease_time

Unsigned int

N

N

N

N/A

reserved_interface

String

N

N

N

N/A

use_bootfile

Bool

N

N

N

N/A

use_bootserver

Bool

N

N

N

N/A

use_deny_bootp

Bool

N

N

N

N/A

use_for_ea_inheritance

Bool

N

N

N

N/A

use_ignore_client_requested_options

Bool

N

N

N

N/A

use_logic_filter_rules

Bool

N

N

N

N/A

use_nextserver

Bool

N

N

N

N/A

use_options

Bool

N

N

N

N/A

use_pxe_lease_time

Bool

N

N

N

N/A

Search-only Fields List

Field

Type

Search

discovered_data.ap_ip_address

String

: = ~

discovered_data.ap_name

String

: = ~

discovered_data.ap_ssid

String

: = ~

discovered_data.bgp_as

Unsigned int

! < = >

discovered_data.bridge_domain

String

: = ~

discovered_data.cisco_ise_endpoint_profile

String

: = ~

discovered_data.cisco_ise_security_group

String

: = ~

discovered_data.cisco_ise_session_state

String

=

discovered_data.cisco_ise_ssid

String

: = ~

discovered_data.cmp_type

String

: = ~

discovered_data.device_contact

String

: = ~

discovered_data.device_location

String

: = ~

discovered_data.device_model

String

: = ~

discovered_data.device_port_name

String

: = ~

discovered_data.device_port_type

String

: = ~

discovered_data.device_type

String

: = ~

discovered_data.device_vendor

String

: = ~

discovered_data.discovered_name

String

: = ~

discovered_data.discoverer

String

: = ~

discovered_data.endpoint_groups

String

: = ~

discovered_data.first_discovered

Timestamp

! < = >

discovered_data.iprg_no

Unsigned int

! < = >

discovered_data.iprg_state

String

=

discovered_data.iprg_type

String

=

discovered_data.last_discovered

Timestamp

! < = >

discovered_data.mac_address

String

: = ~

discovered_data.mgmt_ip_address

String

: = ~

discovered_data.netbios_name

String

: = ~

discovered_data.network_component_contact

String

: = ~

discovered_data.network_component_description

String

: = ~

discovered_data.network_component_ip

String

= ~

discovered_data.network_component_location

String

: = ~

discovered_data.network_component_model

String

: = ~

discovered_data.network_component_name

String

: = ~

discovered_data.network_component_port_description

String

: = ~

discovered_data.network_component_port_name

String

: = ~

discovered_data.network_component_port_number

Unsigned int

! < = >

discovered_data.network_component_type

String

: = ~

discovered_data.network_component_vendor

String

: = ~

discovered_data.open_ports

String

: = ~

discovered_data.os

String

: = ~

discovered_data.port_duplex

String

=

discovered_data.port_link_status

String

=

discovered_data.port_speed

String

=

discovered_data.port_status

String

=

discovered_data.port_type

String

: = ~

discovered_data.port_vlan_description

String

: = ~

discovered_data.port_vlan_name

String

: = ~

discovered_data.port_vlan_number

Unsigned int

! < = >

discovered_data.task_name

String

: = ~

discovered_data.tenant

String

: = ~

discovered_data.v_adapter

String

: = ~

discovered_data.v_cluster

String

: = ~

discovered_data.v_datacenter

String

: = ~

discovered_data.v_entity_name

String

: = ~

discovered_data.v_entity_type

String

=

discovered_data.v_host

String

: = ~

discovered_data.v_switch

String

: = ~

discovered_data.vlan_port_group

String

: = ~

discovered_data.vmhost_ip_address

String

: = ~

discovered_data.vmhost_mac_address

String

: = ~

discovered_data.vmhost_name

String

: = ~

discovered_data.vmhost_nic_names

String

: = ~

discovered_data.vmhost_subnet_cidr

Unsigned int

! < = >

discovered_data.vmi_id

String

=

discovered_data.vmi_ip_type

String

: = ~

discovered_data.vmi_is_public_address

Bool

=

discovered_data.vmi_name

String

: = ~

discovered_data.vmi_private_address

String

: = ~

discovered_data.vmi_tenant_id

String

=

discovered_data.vport_conf_mode

String

=

discovered_data.vport_conf_speed

Unsigned int

! < = >

discovered_data.vport_link_status

String

: = ~

discovered_data.vport_mac_address

String

: = ~

discovered_data.vport_mode

String

=

discovered_data.vport_name

String

: = ~

discovered_data.vport_speed

Unsigned int

! < = >

discovered_data.vrf_description

String

: = ~

discovered_data.vrf_name

String

: = ~

discovered_data.vrf_rd

String

= ~

discovered_data.vswitch_available_ports_count

Unsigned int

! < = >

discovered_data.vswitch_id

String

=

discovered_data.vswitch_ipv6_enabled

Bool

=

discovered_data.vswitch_name

String

: = ~

discovered_data.vswitch_segment_id

String

=

discovered_data.vswitch_segment_name

String

: = ~

discovered_data.vswitch_segment_port_group

String

: = ~

discovered_data.vswitch_segment_type

String

: = ~

discovered_data.vswitch_tep_dhcp_server

String

: = ~

discovered_data.vswitch_tep_ip

String

: = ~

discovered_data.vswitch_tep_multicast

String

: = ~

discovered_data.vswitch_tep_port_group

String

: = ~

discovered_data.vswitch_tep_type

String

: = ~

discovered_data.vswitch_tep_vlan

String

: = ~

discovered_data.vswitch_type

String

=