ansible.netcommon.net_l3_interface – (устаревшее, удалено после 2022-06-01) Управление L3 интерфейсами на сетевых устройствах
Примечание
Этот плагин входит в коллекцию ansible.netcommon (версия 1.5.0).
Для его установки используйте: ansible-galaxy collection install ansible.netcommon.
Для использования в плейбуке укажите: ansible.netcommon.net_l3_interface.
Новое в версии 1.0.0: ansible.netcommon
УСТАРЕВШЕ
- Удалено в
-
главной версии после 2022-06-01
- Почему
-
Выпущены обновлённые модули с большей функциональностью
- Альтернатива
-
Используйте модуль “[netos]_l3_interfaces” для конкретной платформы
Описание
- Этот модуль предоставляет декларативное управление L3 интерфейсами на сетевых устройствах.
Примечание
У данного модуля есть соответствующий плагин действий.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aggregate строка | Список определений L3 интерфейсов | |
| ipv4 строка | IPv4 L3 интерфейса. | |
| ipv6 строка | IPv6 L3 интерфейса. | |
| name строка | Имя L3 интерфейса. | |
| purge строка | По умолчанию: "нет" | Удаляет L3 интерфейсы, не определённые в параметре aggregate. |
| state строка |
| Состояние конфигурации L3 интерфейса. |
Примечания
Примечание
- Этот модуль поддерживается на сетевых платформах
ansible_network_os. Подробности см. в Раздел по параметрам сетевых платформ.
Примеры
- name: Set eth0 IPv4 address
ansible.netcommon.net_l3_interface:
name: eth0
ipv4: 192.168.0.1/24
- name: Remove eth0 IPv4 address
ansible.netcommon.net_l3_interface:
name: eth0
state: absent
- name: Set IP addresses on aggregate
ansible.netcommon.net_l3_interface:
aggregate:
- {name: eth1, ipv4: 192.168.2.10/24}
- {name: eth2, ipv4: 192.168.3.10/24, ipv6: fd5d:12c9:2201:1::1/64}
- name: Remove IP addresses on aggregate
ansible.netcommon.net_l3_interface:
aggregate:
- {name: eth1, ipv4: 192.168.2.10/24}
- {name: eth2, ipv4: 192.168.3.10/24, ipv6: fd5d:12c9:2201:1::1/64}
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| commands список / элементы=строка | всегда, за исключением платформ, которые используют Netconf транспорт для управления устройством. | Список команд конфигурации для отправки устройству Пример: ["set interfaces ethernet eth0 address '192.168.0.1/24'"] |
Статус
- Этот модуль будет удалён в следующей основной версии после 2022-06-01. [устарел]
- Дополнительная информация в УСТАРЕВШЕ.
Авторы
- Ricardo Carrillo Cruz (@rcarrillocruz)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/netcommon/net_l3_interface_module.html
