Document toolboxDocument toolbox

Host Record

If only one IPv4 address is specified in the host record, you can add DHCP options to the host address.


Note: IDN is supported for object types: fqdn and aliases. You can use punycode or IDNs while importing these objects.



Field Name

Data Type

Required (Yes/No)Associated GUI FieldAssociated PAPI Method

Usage and Guidelines Method

Header-HostRecord

String

Yes

Example: HostRecord

fqdn

FQDN

YesNamename
zone

This field combines the host record name and the zone name to form the FQDN. Example: h2.corp100.com

_new_fqdn

FQDN

No

Add this field to overwrite the fqdn field when you select the overwrite or merge option.

view

String

NoDNS Viewviews

If no view is specified, the Default view is used. Example: Default

network_view

String

NoNetwork View

If no network view is specified, the Default view is used. Example: Default

addresses

IP address or IP address list 

NoIP Addressesipv4addrs

You must specify a value in this field or in the ipv6_addresses field. Example: '1.2.3.4' or  "1.2.3.4, 5.6.7.8". If there are multiple addresses in the host record, use HostAddress to specify the parameters for each address. For information, see IPv4 Host Address and IPv6 Host Address.

ipv6_addresses

IP address or IP address list 

NoIP Addressesipv6addrs

You must specify a value in this field or in the addresses field. If there are multiple addresses in the host record, use HostAddress to specify the parameters for each address. For information, see IPv4 Host Address and IPv6 Host Address.

aliases

Alias list

NoAliasesaliases

Example: www.infoblox.com

configure_for_dns

Boolean

NoEnable in DNSconfigure_for_dns

Example: TRUE

_new_configure_for_dns

Boolean

NoEnable in DNS configure_for_dns

Add this field to overwrite the configure_for_dns field when you select the overwrite or merge option.

comment

String

NoComment

comment


disabled

Boolean

NoDisabledisabled

Example: FALSE

ttl

Unsigned integer

NoTTLttl

This is an inherited field. For information, see Data Specific Guidelines. Example: 28800

mac_address

MAC address

NoMAC Addressmac_address

This field applies to the host address. This is required if the IP address is configured for DHCP. Example: aA:Bb:c2:DD:E1:FF

ddns_protectedBooleanNoProtectedddns_protectedIf the record is marked as protected, DDNS updates are  restricted to only the record. This applies to both static and dynamic records.

configure_for_dhcp

Boolean

NoDHCP checkboxconfigure_for_dhcp

This field applies to the host address.  Example: TRUE

deny_bootp

Boolean

NoDeny BOOTP Requestsdeny_bootp

 This field applies to the host address. Example: FALSE

broadcast_address

String

NoBroadcast Address

This field applies to the host address.

boot_file

String

NoBoot Fileboot_file

This field applies to the host address.

boot_server

String

NoBoot Serverboot_server

 This field applies to the host address.

next_server

String

NoNext Servernext_server

This field applies to the host address.

lease_time

Unsigned integer

NoLease Timelease_time

This field applies to the host address.

pxe_lease_time_enabled

Boolean

NoEnable PXE Lease Time

This field applies to the host address.

pxe_lease_time

Unsigned integer

NoPXE Lease Timepxe_lease_time

This field applies to the host address.

domain_name

FQDN

NoDomain Namedomain_name

This field applies to the host address.

domain_name_servers

IP list

NoName Server

This field applies to the host address. Example: "5.6.7.8,1.2.3.4"

routers

IP list

NoRouter

This field applies to the host address. Example: "2.0.0.2,1.2.3.4"

match_option

String

No
match_client

This field applies to the host address. Data must be in the following format: MAC_ADDRESS/RESERVED

ignore_dhcp_param_request_list

Boolean

NoIgnore
Optionalist
ignore-dhcp_option_list_ request

 This field applies to the host address.

OPTION-1

String

NoCustom DHCP
Options
options

This field applies to the host address. Example: '255.0.0.0' name implies vendor_class='DHCP' (default)

OPTION-XXXX-200

Option Information

No

Custom DHCP
Options

options

This field applies to the host address. Example: 'dfdfdfd' name implies vendor_class='XXXX', optioncode/number 200

EA-Site

String

NoExtensible attribute
Site
extensible_attributes

EA-Site is an example of a predefined extensible attribute. You can add other predefined attributes to the data file. For information about data format and examples, see Data Specific Guidelines.

ADMGRP-JoeSmith

String

NoPermissions
Admin
Group/Role
Permissions
Admin
Group/Role

ADMGRP-JoeSmith is an example of an admin permission of a specific admin group. For information about data format and examples, see Data Specific Guidelines.

Examples

This section contains examples of how to create data files for host records. All examples use comma as the separator. You can use other supported separators, such as semicolon, space, or tab.

Adding a Host Record

This example shows how to add a new host record, host1, in zone corp100.com and DNS view Initial.

header-hostrecord,addresses,configure_for_dns*,fqdn*,view hostrecord,100.0.0.101,TRUE,host1.corp100.com,Inital

This example shows how to add a new host record, host2, in zone corp100.com with aliases = www.corp100.com, comment = USA, and TTL = 3600 seconds.

header-hostrecord,addresses,configure_for_dns*,fqdn*,aliases,comment,ttl hostrecord,100.0.0.102,TRUE,host2.corp100.com,www.corp100.com,USA,3600

Overwriting Host Record Data

This example shows how to overwrite the FQDN of an existing host record from host1.corp100.com to new_host1.corp100.com, and to change the TTL to 128 seconds.

header-hostrecord,addresses,configure_for_dns*,fqdn*,_new_fqdn,ttl hostrecord,100.0.0.101,TRUE,host1.corp100.com,new_host1.corp100.com,1280

This example shows how to overwrite the aliases of a host record from www.corp100.com to www.corp200.com and comment from USA to Japan.

header-hostrecord,addresses*,configure_for_dns*,fqdn*,aliases,comment hostrecord,100.0.0.102,TRUE,host2.corp100.com,www.corp200.com,Japan

Note that overwriting the host record data is not supported for non-DNS hosts.

Merging Host Record Data

This example shows how to disable an existing host record.

header-hostrecord,configure_for_dns*,addresses*,fqdn*,disabled hostrecord,100.0.0.101,TRUE,new_host1.corp100.com,TRUE

This example shows how to add additional aliases to a host record.

header-hostrecord,configure_for_dns*,addresses*,fqdn*,aliases hostrecord,100.0.0.102,TRUE,host2.corp100.com,"www.corp200.com,http.corp200.com"