nxos_mtu - Управление настройками MTU на коммутаторе Nexus.

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

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

УСТАРЕВШИЙ

Устарел в версии 2.3. Используйте nxos_system‘s mtu параметр.

Описание

Управление настройками MTU на коммутаторе Nexus.

Параметры

параметр	обязательно	значение по умолчанию	допустимые значения	комментарии
auth_pass (добавлено в 2.4.4)	нет	нет		Указывает пароль для входа в привилегированный режим на удалённом устройстве, если это необходимо. Если authorize ложно, этот аргумент игнорируется. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTH_PASS`.
authorize (добавлено в 2.4.4)	нет		да нет	Указывает модулю войти в привилегированный режим на удалённом устройстве перед отправкой команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_AUTHORIZE`.
host	да			Указывает имя или адрес хоста DNS для подключения к удалённому устройству по указанному транспорту. Значение host используется в качестве адреса назначения для транспорта.
interface	нет			Полное имя интерфейса, например Ethernet1/1.
mtu	нет			MTU для конкретного интерфейса. Должно быть чётным числом от 576 до 9216.
password	нет			Указывает пароль для аутентификации подключения к удалённому устройству. Этот аргумент обычно используется для транспортов cli или nxapi. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_PASSWORD`.
port	нет	0 (использовать стандартный порт)		Указывает порт для подключения к удалённому устройству. Это значение относится к транспорту cli или nxapi. Значение порта по умолчанию соответствует обычному порту для транспорта, если не указано иное в задаче (cli=22, http=80, https=443).
provider	нет			Удобный метод, позволяющий передать все аргументы nxos в виде объекта dict. Все ограничения (обязательность, допустимые значения и т.д.) должны быть соблюдены либо отдельными аргументами, либо значениями в этом dict.
ssh_keyfile	нет			Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
state	нет	present	present absent	Указывает желаемое состояние ресурса.
sysmtu	нет			MTU для системного джамбо. Должно быть чётным числом от 576 до 9216.
timeout (добавлено в 2.3)	нет	10		Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль выдаст ошибку. NX-API может медленно возвращать данные для длительных команд (sh mac, sh bgp и т.д.).
transport	да	cli		Настраивает транспортное подключение для подключения к удалённому устройству. Аргумент transport поддерживает подключение к устройству через cli (ssh) или nxapi.
use_ssl	нет		да нет	Настраивает транспорт transport на использование SSL, если значение равно true, только когда `transport=nxapi`, в противном случае это значение игнорируется.
username	нет			Указывает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
validate_certs	нет		да нет	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых локально сайтах, использующих самозаверяющие сертификаты. Если аргумент transport не nxapi, это значение игнорируется.

Примеры

# Ensure system mtu is 9126
- nxos_mtu:
    sysmtu: 9216
    host: "{{ inventory_hostname }}"
    username: "{{ un }}"
    password: "{{ pwd }}"

# Config mtu on Eth1/1 (routed interface)
- nxos_mtu:
    interface: Ethernet1/1
    mtu: 1600
    host: "{{ inventory_hostname }}"
    username: "{{ un }}"
    password: "{{ pwd }}"

# Config mtu on Eth1/3 (switched interface)
- nxos_mtu:
    interface: Ethernet1/3
    mtu: 9216
    host: "{{ inventory_hostname }}"
    username: "{{ un }}"
    password: "{{ pwd }}"

# Unconfigure mtu on a given interface
- nxos_mtu:
    interface: Ethernet1/3
    mtu: 9216
    host: "{{ inventory_hostname }}"
    username: "{{ un }}"
    password: "{{ pwd }}"
    state: absent

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

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

имя	описание	возвращается	тип	пример
changed	проверка, было ли внесено изменение на устройстве	всегда	boolean	True
end_state	параметры mtu/sysmtu после выполнения модуля	всегда	dict	{'sysmtu"': '9216', 'mtu': '1700'}
existing	параметры existing mtu/sysmtu на интерфейсе/системе	всегда	dict	{'sysmtu': '9216', 'mtu': '1600'}
proposed	параметры, переданные в модуль	всегда	dict	{'mtu': '1700'}
updates	команды, отправленные на устройство	всегда	list	['interface vlan10', 'mtu 1700']

Примечания

Примечание

Тестировано на NXOSv 7.3.(0)D1(1) на VIRL
Требуется параметр sysmtu или (interface И mtu) параметры.
state=absent отключает заданный MTU, если это значение присутствует в настоящий момент.

Для помощи в разработке модулей, если у вас есть желание, пожалуйста, ознакомьтесь с Информация по сообществу и участие в разработке, Тестирование Ansible и Разработка модулей.

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