DNS

DNS configuration manages domain name lookup, the default domain name, the domain search list, name servers and static host entries for hostname resolution on NX-OS devices. Domain names, domain lists and name servers can also be configured per VRF (ip domain-name|domain-list|name-server ... use-vrf <vrf>).

DNS configuration manages domain name lookup and the default domain name for hostname resolution on NX-OS devices.

Diagram

Diagram

Classes

nxos

Name	Type	Constraint	Mandatory	Default Value
devices	List	devices	No
device_groups	List	device_groups	No
global	Class	global	No
templates	List	templates	No

devices (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

device_groups (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

global (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

templates (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

configuration (nxos.devices)

Name	Type	Constraint	Mandatory	Default Value
dns	Class	dns	No

dns (nxos.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
domain_lookup	Boolean	true, false	No
domain_name	String		No
domain_lists	List	String	No
name_servers	List	name_servers	No
hosts	List	hosts	No
vrfs	List	vrfs	No

dns (nxos.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
domain_lookup	Boolean	true, false	No
domain_name	String		No

name_servers (nxos.devices.configuration.dns)

Name	Type	Constraint	Mandatory	Default Value
ip	IP		Yes
source_interface_type	Choice	ethernet, loopback, mgmt, port-channel, vlan, vni	No
source_interface_id	Any	String or Integer[min: 0]	No

hosts (nxos.devices.configuration.dns)

Name	Type	Constraint	Mandatory	Default Value
name	String		Yes
ip_address	IP		No
ipv6_address	IP		No

vrfs (nxos.devices.configuration.dns)

Name	Type	Constraint	Mandatory	Default Value
vrf	String		Yes
domain_name	String		No
domain_lists	List	String	No
name_servers	List	name_servers	No

Examples

Example 1: DNS domain lookup with default domain

nxos:
  devices:
    - name: LEAF1
      configuration:
        dns:
          domain_lookup: true
          domain_name: example.com

Example 2: DNS with name servers, domain list, static hosts and per-VRF settings

nxos:
  devices:
    - name: LEAF1
      configuration:
        dns:
          domain_lookup: true
          domain_name: example.com
          domain_lists:
            - example.net
            - example.org
          name_servers:
            - ip: 10.1.1.1
              source_interface_type: mgmt
              source_interface_id: 0
            - ip: 2001:db8::53
          hosts:
            - name: server1
              ip_address: 10.2.2.2
              ipv6_address: 2001:db8::2
          vrfs:
            - vrf: management
              domain_name: mgmt.example.com
              domain_lists:
                - mgmt.example.net
              name_servers:
                - ip: 10.3.3.3

Examples

Example 1: DNS domain lookup with default domain

nxos:
  devices:
    - name: LEAF1
      configuration:
        dns:
          domain_lookup: true
          domain_name: example.com