ip host

Use ip host to create a host name-to-IPv4 address mapping.

Use undo ip host to remove a mapping.

Syntax

ip host host-name ip-address [ vpn-instance vpn-instance-name ]

undo ip host host-name ip-address [ vpn-instance vpn-instance-name ]

Default

No mappings are created.

Views

System view

Predefined user roles

network-admin

Parameters

host-name: Specifies a host name, a case-insensitive string of 1 to 253 characters. It can include letters, digits, hyphens (-), underscores (_), and dots (.).

ip-address: Specifies the IPv4 address of the host.

vpn-instance vpn-instance-name: Specifies the name of an MPLS L3VPN instance, a case-sensitive string of 1 to 31 characters. To specify a host name-to-IP address mapping on the public network, do not specify this option.

Usage guidelines

You can configure the following:

• Host name-to-IPv4 address mappings for the public network and up to 1024 VPNs.

• A maximum of 1024 host name-to-IPv4 address mappings for the public network or each VPN.

On the public network or a VPN, each host name maps only to one IPv4 address. If you use the command multiple times, the most recent configuration takes effect.

Do not use the ping command parameter ip, -a, -c, -f, -h, -i, -m, -n, -p, -q, -r, -s, -t, -tos, -v, or -vpn-instance as the host name. For more information about the ping command parameters, see Network Management and Monitoring Command Reference.

Examples

# Map IPv4 address 10.110.0.1 to host name aaa on the public network.

<Sysname> system-view
[Sysname] ip host aaa 10.110.0.1

Related commands

display dns host