New in version 2.3.
Parameter | Choices/Defaults | Comments |
---|---|---|
interface required | Specifies the IP interface we want to manage. aliases: nic | |
property required | Specifies the name of the property we want to manage. aliases: name | |
protocol required | Specifies the procotol for which we want to manage properties. | |
state |
| Set or reset the property value. |
temporary | Default: no | Specifies that the property value is temporary. Temporary property values do not persist across reboots. |
value | Specifies the value we want to set for the property. |
- name: Allow forwarding of IPv4 packets on network interface e1000g0 ipadm_ifprop: protocol=ipv4 property=forwarding value=on interface=e1000g0 - name: Temporarily reset IPv4 forwarding property on network interface e1000g0 ipadm_ifprop: protocol=ipv4 interface=e1000g0 temporary=true property=forwarding state=reset - name: Configure IPv6 metric on network interface e1000g0 ipadm_ifprop: protocol=ipv6 nic=e1000g0 name=metric value=100 - name: Set IPv6 MTU on network interface bge0 ipadm_ifprop: interface=bge0 name=mtu value=1280 protocol=ipv6
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
interface str | always | interface name we want to set property on Sample: e1000g0 |
property str | always | property's name Sample: mtu |
protocol str | always | property's protocol Sample: ipv4 |
state string | always | state of the target Sample: present |
value str | when value is provided | property's value Sample: 1280 |
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_ifprop_module.html