New in version 2.3.
Parameter | Choices/Defaults | Comments |
---|---|---|
address | Specifiies an IP address to configure in CIDR notation. aliases: addr | |
addrobj required | Specifies an unique IP address on the system. | |
addrtype |
| Specifiies a type of IP address to configure. |
state |
| Create/delete/enable/disable an IP address on the network interface. |
temporary | Default: no | Specifies that the configured IP address is temporary. Temporary IP addresses do not persist across reboots. |
wait | Default: 60 | Specifies the time in seconds we wait for obtaining address via DHCP. |
- 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
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
address string | only if addrtype is 'static' | IP address Sample: 1.3.3.7/32 |
addrobj string | always | address object name Sample: bge0/v4 |
addrtype string | always | address type Sample: static |
state string | always | state of the target Sample: present |
temporary boolean | always | specifies if operation will persist across reboots Sample: True |
wait string | only if addrtype is 'dhcp' | time we wait for DHCP Sample: 10 |
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/ipadm_addr_module.html