cnos_l3_interface – Управление интерфейсами уровня 3 на сетевых устройствах Lenovo CNOS

Новое в версии 2.8.

Обзор
Параметры
Примечания
Примеры
Значения возврата
Статус

Обзор

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

Параметры

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

Примечания

Примечание

Проверено на CNOS 10.8.1

Примеры

- name: Remove Ethernet1/33 IPv4 and IPv6 address
  cnos_l3_interface:
    name: Ethernet1/33
    state: absent

- name: Set Ethernet1/33 IPv4 address
  cnos_l3_interface:
    name: Ethernet1/33
    ipv4: 10.241.107.1/24

- name: Set Ethernet1/33 IPv6 address
  cnos_l3_interface:
    name: Ethernet1/33
    ipv6: "fd5d:12c9:2201:1::1/64"

- name: Set Ethernet1/33 in dhcp
  cnos_l3_interface:
    name: Ethernet1/33
    ipv4: dhcp
    ipv6: dhcp

- name: Set interface Vlan1 (SVI) IPv4 address
  cnos_l3_interface:
    name: Vlan1
    ipv4: 192.168.0.5/24

- name: Set IP addresses on aggregate
  cnos_l3_interface:
    aggregate:
      - { name: Ethernet1/33, ipv4: 10.241.107.1/24 }
      - { name: Ethernet1/44, ipv4: 10.240.106.1/24,
          ipv6: "fd5d:12c9:2201:1::1/64" }

- name: Remove IP addresses on aggregate
  cnos_l3_interface:
    aggregate:
      - { name: Ethernet1/33, ipv4: 10.241.107.1/24 }
      - { name: Ethernet1/44, ipv4: 10.240.106.1/24,
          ipv6: "fd5d:12c9:2201:1::1/64" }
    state: absent

Значения возврата

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

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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Anil Kumar Muraleedharan (@amuraleedhar)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/cnos_l3_interface_module.html