ipadm_addr - Manage IP addresses on an interface on Solaris/illumos systems

New in version 2.3.

Synopsis

  • Create/delete static/dynamic IP addresses on network interfaces on Solaris/illumos systems.
  • Up/down static/dynamic IP addresses on network interfaces on Solaris/illumos systems.
  • Manage IPv6 link-local addresses on network interfaces on Solaris/illumos systems.

Options

parameter required default choices comments
address
no
Specifiies an IP address to configure in CIDR notation.
aliases: addr
addrobj
yes
Specifies an unique IP address on the system.
addrtype
no static
  • static
  • dhcp
  • addrconf
Specifiies a type of IP address to configure.
state
no present
  • absent
  • present
  • up
  • down
  • enabled
  • disabled
  • refreshed
Create/delete/enable/disable an IP address on the network interface.
temporary
no
Specifies that the configured IP address is temporary. Temporary IP addresses do not persist across reboots.
wait
no 60
Specifies the time in seconds we wait for obtaining address via DHCP.

Examples

name: Configure IP address 10.0.0.1 on e1000g0
ipadm_addr: addr=10.0.0.1/32 addrobj=e1000g0/v4 state=present

name: Delete addrobj
ipadm_addr: addrobj=e1000g0/v4 state=absent

name: Configure link-local IPv6 address
ipadm_addr: addtype=addrconf addrobj=vnic0/v6

name: Configure address via DHCP and wait 180 seconds for address obtaining
ipadm_addr: addrobj=vnic0/dhcp addrtype=dhcp wait=180

Return Values

Common return values are documented here Return Values, the following are the fields unique to this module:

name description returned type sample
address
IP address
only if addrtype is 'static' string 1.3.3.7/32
addrobj
address object name
always string bge0/v4
addrtype
address type
always string static
state
state of the target
always string present
temporary
specifies if operation will persist across reboots
always boolean True
wait
time we wait for DHCP
only if addrtype is 'dhcp' string 10

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/ipadm_addr_module.html