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

  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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)
  • ‘=’ (exact equality)
  • ‘<=’ (less than search)
  • ‘>=’ (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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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)
  • ‘=’ (exact equality)
  • ‘<=’ (less than search)
  • ‘>=’ (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

  • ‘!=’ (negative search)
  • ‘=’ (exact equality)
  • ‘<=’ (less than search)
  • ‘>=’ (greater than 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)
  • ‘=’ (exact equality)
  • ‘<=’ (less than search)
  • ‘>=’ (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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘!=’ (negative search)
  • ‘=’ (exact equality)
  • ‘<=’ (less than search)
  • ‘>=’ (greater than 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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘!=’ (negative search)
  • ‘=’ (exact equality)
  • ‘<=’ (less than search)
  • ‘>=’ (greater than 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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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)
  • ‘=’ (exact equality)
  • ‘<=’ (less than search)
  • ‘>=’ (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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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)
  • ‘=’ (exact equality)
  • ‘<=’ (less than search)
  • ‘>=’ (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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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)
  • ‘=’ (exact equality)
  • ‘<=’ (less than search)
  • ‘>=’ (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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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)
  • ‘=’ (exact equality)
  • ‘<=’ (less than search)
  • ‘>=’ (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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

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 =

Table Of Contents

Previous topic

record:host : DNS Host record object.

Next topic

record:host_ipv6addr : IPv6 Host address object.