ansible / ansible.builtin / v2.8.13 / module / ios_interface Manage Interface on Cisco IOS network devices | "added in version" 2.4 of ansible.builtin" Authors: Ganesh Nalawade (@ganeshrn) preview | supported by networkansible.builtin.ios_interface (v2.8.13) — module
pip
Install with pip install ansible==2.8.13
This module provides declarative management of Interfaces on Cisco IOS network devices.
- name: configure interface ios_interface: name: GigabitEthernet0/2 description: test-interface speed: 100 duplex: half mtu: 512
- name: remove interface ios_interface: name: Loopback9 state: absent
- name: make interface up ios_interface: name: GigabitEthernet0/2 enabled: True
- name: make interface down ios_interface: name: GigabitEthernet0/2 enabled: False
- name: Check intent arguments ios_interface: name: GigabitEthernet0/2 state: up tx_rate: ge(0) rx_rate: le(0)
- name: Check neighbors intent arguments ios_interface: name: Gi0/0 neighbors: - port: eth0 host: netdev
- name: Config + intent ios_interface: name: GigabitEthernet0/2 enabled: False state: down
- name: Add interface using aggregate ios_interface: aggregate: - { name: GigabitEthernet0/1, mtu: 256, description: test-interface-1 } - { name: GigabitEthernet0/2, mtu: 516, description: test-interface-2 } duplex: full speed: 100 state: present
- name: Delete interface using aggregate ios_interface: aggregate: - name: Loopback9 - name: Loopback10 state: absent
mtu: description: - Maximum size of transmit packet. name: description: - Name of the Interface. required: true delay: default: 10 description: - Time in seconds to wait before checking for the operational state on remote device. This wait is applicable for operational state argument which are I(state) with values C(up)/C(down), I(tx_rate) and I(rx_rate). speed: description: - Interface link speed. state: choices: - present - absent - up - down default: present description: - State of the Interface configuration, C(up) means present and operationally up and C(down) means present and operationally C(down) duplex: choices: - full - half - auto default: auto description: - Interface link status enabled: description: - Interface link status. type: bool rx_rate: description: - Receiver rate in bits per second (bps). - This is state check parameter only. - Supports conditionals, see L(Conditionals in Networking Modules,../network/user_guide/network_working_with_command_output.html) tx_rate: description: - Transmit rate in bits per second (bps). - This is state check parameter only. - Supports conditionals, see L(Conditionals in Networking Modules,../network/user_guide/network_working_with_command_output.html) aggregate: description: List of Interfaces definitions. neighbors: description: - Check the operational state of given interface C(name) for CDP/LLDP neighbor. - The following suboptions are available. suboptions: host: description: - CDP/LLDP neighbor host for given interface C(name). port: description: - CDP/LLDP neighbor port to which given interface C(name) is connected. description: description: - Description of Interface.
commands: description: The list of configuration mode commands to send to the device. returned: always, except for the platforms that use Netconf transport to manage the device. sample: - interface GigabitEthernet0/2 - description test-interface - duplex half - mtu 512 type: list