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

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

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

УСТЕРЕЛО

Удалено в Ansible:
	версия: 2.5
Почему:	Заменено на общие модули сети `*_system`.
Альтернатива:	Используйте опцию `system_mtu` модуля nxos_system. Для задания MTU интерфейса используйте модуль nxos_interface.

Синопсис

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

Параметры

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

Примечания

Примечание

Проверено на NXOSv 7.3.(0)D1(1) на VIRL
Требуется параметр sysmtu или (interface И mtu).
state=absent отменяет заданный MTU, если это значение присутствует в настоящее время.
Дополнительную информацию об использовании CLI и NX-API см. в руководстве NXOS Platform Options.
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide.
Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco.

Примеры

# 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 dict	всегда	k/v пары значений mtu/sysmtu после выполнения модуля Пример: {'mtu': '1700', 'sysmtu"': '9216'}
existing dict	всегда	k/v пары существующих значений mtu/sysmtu на интерфейсе/системе Пример: {'mtu': '1600', 'sysmtu': '9216'}
proposed dict	всегда	k/v пары параметров, переданных в модуль Пример: {'mtu': '1700'}
updates list	всегда	команда, отправленная на устройство Пример: ['interface vlan10', 'mtu 1700']

Статус

Этот модуль помечен как устаревший и будет удален в версии 2.5. Для получения дополнительной информации см. УСТАРЕВШИЙ.

Автор

Jason Edelman (@jedelman8)

Подсказка

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

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