record:ptr : DNS PTR record object.

In a forward-mapping zone, a PTR (pointer) record maps a domain name to another domain name. In a reverse-mapping zone, a PTR (pointer) record maps an address to a domain name. To define a specific address-to-name mapping, add a PTR record to a previously defined authoritative reverse-mapping zone.

Object Reference

References to record:ptr are object references. The name part of a DNS PTR object reference has the following components:

  • Name of the record
  • Name of the view

Example: record:ptr/ZG5zLmJpsaG9zdA:1.0.0.127.in-addr.arpa/default.external

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): ptrdname, view.

The following fields are required to create this object:

Field Notes
ipv4addr The field is required only for an IPv4 PTR object.
ipv6addr The field is required only for an IPv6 PTR object.
name See the field description for more information
ptrdname  

aws_rte53_record_info

aws_rte53_record_info

Aws Route 53 record information.

Type

A/An ‘Aws Rte53 Record Info struct.

Search

The field is not available for search.

Notes

The aws_rte53_record_info cannot be updated.

aws_rte53_record_info cannot be written.

cloud_info

cloud_info

Structure containing all cloud API related information for this object.

Type

A/An Cloud Information struct.

Search

The field is not available for search.

Notes

The cloud_info cannot be updated.

cloud_info cannot be written.

comment

comment

Comment for the record; maximum 256 characters.

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

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

creation_time

creation_time

The time of the record creation in Epoch seconds format.

Type

Timestamp.

Search

The field is not available for search.

Notes

The creation_time cannot be updated.

creation_time cannot be written.

creator

creator

The record creator.

Note that changing creator from or to ‘SYSTEM’ value is not allowed.

Type

String.

Valid values are:
  • DYNAMIC
  • STATIC
  • SYSTEM

Create

The default value is STATIC.

Search

The field is available for search via

  • ‘=’ (exact equality)

ddns_principal

ddns_principal

The GSS-TSIG principal that owns this record.

Type

String.

Create

The default value is empty.

Search

The field is available for search via

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

ddns_protected

ddns_protected

Determines if the DDNS updates for this record are allowed or not.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

disable

disable

Determines if the record is disabled or not. False means that the record is enabled.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

discovered_data

discovered_data

The discovered data for this PTR record.

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.

dns_name

dns_name

The name for a DNS PTR record in punycode format.

Type

String.

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

Search

The field is not available for search.

Notes

The dns_name cannot be updated.

dns_name cannot be written.

dns_ptrdname

dns_ptrdname

The domain name of the DNS PTR record in punycode format.

Type

String.

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

Search

The field is not available for search.

Notes

The dns_ptrdname cannot be updated.

dns_ptrdname cannot be written.

extattrs

extattrs

Extensible attributes associated with the object.

For valid values for extensible attributes, see the following information.

Type

Extensible attributes.

This field allows +/- to be specified as part of the field name when updating the object, see the following information.

Create

The default value is empty.

Search

For how to search extensible attributes, see the following information.

forbid_reclamation

forbid_reclamation

Determines if the reclamation is allowed for the record or not.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

ipv4addr

ipv4addr

The IPv4 Address of the record.

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 only for an IPv4 PTR object.

Search

The field is available for search via

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

ipv6addr

ipv6addr

The IPv6 Address of the record.

Type

String.

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

Using an IPv6 network or range WAPI reference:

  • func:nextavailableip:<reference>

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

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

Using an IPv6 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:abcd%3A%3A/64/default
  • func:nextavailableip:abcd::/64
  • func:nextavailableip:abcd::/64,external
  • func:nextavailableip:abcd::20-abcd::30

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 only for an IPv6 PTR object.

Search

The field is available for search via

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

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.

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.

name

name

The name of the DNS PTR record in FQDN format.

Type

String.

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

Create

The field is required only for an PTR object in Forward Mapping Zone.

Search

The field is available for search via

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

ptrdname

ptrdname

The domain name of the DNS PTR record in FQDN format.

Type

String.

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

Create

The field is required on creation.

Search

The field is available for search via

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

Notes

The ptrdname is part of the base object.

reclaimable

reclaimable

Determines if the record is reclaimable or not.

Type

Bool.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

The reclaimable cannot be updated.

reclaimable cannot be written.

shared_record_group

shared_record_group

The name of the shared record group in which the record resides. This field exists only on db_objects if this record is a shared record.

Type

String.

Search

The field is not available for search.

Notes

The shared_record_group cannot be updated.

shared_record_group cannot be written.

ttl

ttl

Time To Live (TTL) value for the record. A 32-bit unsigned integer that represents the duration, in seconds, that the record is valid (cached). Zero indicates that the record should not be cached.

Type

Unsigned integer.

Create

The default value is empty.

Search

The field is not available for search.

Notes

ttl is associated with the field use_ttl (see use flag).

use_ttl

use_ttl

Use flag for: ttl

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

view

view

Name of the DNS View in which the record resides, for example “external”.

Type

String.

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

Create

The default value is The default DNS view.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

The view is part of the base object.

The view cannot be updated.

zone

zone

The name of the zone in which the record resides. For example: “zone.com”.

If a view is not specified when searching by zone, the default view is used.

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 zone cannot be updated.

zone cannot be written.

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
aws_rte53_record_info struct N Y N N/A
cloud_info struct N Y N N/A
comment String N N N : = ~
creation_time Timestamp N Y N N/A
creator String N N N =
ddns_principal String N N N : = ~
ddns_protected Bool N N N N/A
disable Bool N N N N/A
discovered_data struct N Y N N/A
dns_name String N Y N N/A
dns_ptrdname String N Y N N/A
extattrs Extattr N N N ext
forbid_reclamation Bool N N N N/A
ipv4addr String Y* N N = ~
ipv6addr String Y* N N = ~
last_queried Timestamp N Y N N/A
ms_ad_user_data struct N Y N N/A
name String Y* N N : = ~
ptrdname String Y N Y : = ~
reclaimable Bool N Y N =
shared_record_group String N Y N N/A
ttl Unsigned int N N N N/A
use_ttl Bool N N N N/A
view String N N Y =
zone String N Y N =

* Required in some cases, see detailed field description above.

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:nsec3param : DNS NSEC3 record object.

Next topic

record:rpz:a : Response Policy Zone Substitute A Record Rule object.