cisco.ios.ios_l3_interface – (устаревшее, удалено после 2022-06-01) Управление интерфейсами уровня 3 на устройствах сети Cisco IOS.

Примечание

Этот плагин входит в коллекцию cisco.ios (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install cisco.ios.

Для использования в playbook, укажите: cisco.ios.ios_l3_interface.

Добавлен в версии 1.0.0: of cisco.ios

УСТАРЕВШЕ
Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

УСТАРЕВШЕ

Удалено в: главном релизе после 2022-06-01
Почему: Выпущены более новые и обновленные модули с большей функциональностью в Ansible 2.9
Альтернатива: ios_l3_interfaces

Описание

Этот модуль предоставляет декларативное управление интерфейсами уровня 3 на устройствах IOS.

Примечание

Этот модуль имеет соответствующий плагин действий.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
aggregate список / элементы=словарь			Список определений интерфейсов уровня 3. Каждый элемент в списке aggregate должен определять имя интерфейса `name` и необязательный `ipv4` или `ipv6` адрес.
	ipv4 строка		Адрес IPv4, который нужно установить для интерфейса уровня 3, указанного в параметре name. Формат адреса — <адрес IPv4>/<маска>, маска — число в диапазоне 0-32, например, 192.168.0.1/24
	ipv6 строка		Адрес IPv6, который нужно установить для интерфейса уровня 3, указанного в параметре name. Формат адреса — <адрес IPv6>/<маска>, маска — число в диапазоне 0-128, например, fd5d:12c9:2201:1::1/64
	name строка / обязательно		Имя интерфейса уровня 3, который нужно настроить, например, GigabitEthernet0/2
	state строка	Варианты: present absent	Состояние конфигурации интерфейса уровня 3. Указывает, должна ли конфигурация присутствовать или отсутствовать на удаленном устройстве.
ipv4 строка			Адрес IPv4, который нужно установить для интерфейса уровня 3, указанного в параметре name. Формат адреса — <адрес IPv4>/<маска>, маска — число в диапазоне 0-32, например, 192.168.0.1/24
ipv6 строка			Адрес IPv6, который нужно установить для интерфейса уровня 3, указанного в параметре name. Формат адреса — <адрес IPv6>/<маска>, маска — число в диапазоне 0-128, например, fd5d:12c9:2201:1::1/64
name строка			Имя интерфейса уровня 3, который нужно настроить, например, GigabitEthernet0/2
provider словарь			Устаревший Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Для получения дополнительной информации см. руководство IOS Platform Options. Объект словаря, содержащий данные подключения.
	auth_pass строка		Указывает пароль, который нужно использовать для входа в привилегированный режим на удаленном устройстве. Если authorize имеет значение false, этот аргумент ничего не делает. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
	authorize логическое значение	Варианты: нет ← да	Указывает модулю войти в привилегированный режим на удаленном устройстве перед отправкой команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTHORIZE`.
	host строка		Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному протоколу. Значение host используется в качестве адреса назначения для протокола.
	password строка		Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_PASSWORD`.
	port целое число		Указывает порт, используемый при построении соединения с удаленным устройством.
	ssh_keyfile путь		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут превышен до завершения операции, модуль сообщит об ошибке.
	username строка		Устанавливает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
state строка		Варианты: present ← absent	Состояние конфигурации интерфейса уровня 3. Указывает, должна ли конфигурация присутствовать или отсутствовать на удаленном устройстве.

Примечания

Примечание

Проверено на IOS 15.2
Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами см. Руководство по сетям Ansible
Для получения дополнительной информации об использовании Ansible для управления устройствами Cisco см. страницу интеграции Cisco.

Примеры

- name: Remove GigabitEthernet0/3 IPv4 and IPv6 address
  cisco.ios.ios_l3_interface:
    name: GigabitEthernet0/3
    state: absent
- name: Set GigabitEthernet0/3 IPv4 address
  cisco.ios.ios_l3_interface:
    name: GigabitEthernet0/3
    ipv4: 192.168.0.1/24
- name: Set GigabitEthernet0/3 IPv6 address
  cisco.ios.ios_l3_interface:
    name: GigabitEthernet0/3
    ipv6: fd5d:12c9:2201:1::1/64
- name: Set GigabitEthernet0/3 in dhcp
  cisco.ios.ios_l3_interface:
    name: GigabitEthernet0/3
    ipv4: dhcp
    ipv6: dhcp
- name: Set interface Vlan1 (SVI) IPv4 address
  cisco.ios.ios_l3_interface:
    name: Vlan1
    ipv4: 192.168.0.5/24
- name: Set IP addresses on aggregate
  cisco.ios.ios_l3_interface:
    aggregate:
    - name: GigabitEthernet0/3
      ipv4: 192.168.2.10/24
    - name: GigabitEthernet0/3
      ipv4: 192.168.3.10/24
      ipv6: fd5d:12c9:2201:1::1/64
- name: Remove IP addresses on aggregate
  cisco.ios.ios_l3_interface:
    aggregate:
    - name: GigabitEthernet0/3
      ipv4: 192.168.2.10/24
    - name: GigabitEthernet0/3
      ipv4: 192.168.3.10/24
      ipv6: fd5d:12c9:2201:1::1/64
    state: absent

Возвращаемые значения

Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
commands список / элементы=строка	всегда, за исключением платформ, использующих транспорт Netconf для управления устройством.	Список команд режима конфигурации, которые нужно отправить устройству Пример: ['interface GigabitEthernet0/2', 'ip address 192.168.0.1 255.255.255.0', 'ipv6 address fd5d:12c9:2201:1::1/64']

Статус

Этот модуль будет удален в главном релизе после 2022-06-01. [устаревший]
Для получения дополнительной информации см. УСТАРЕВШЕ.

Авторы

Ganesh Nalawade (@ganeshrn)

© 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/cisco/ios/ios_l3_interface_module.html