Модуль cisco.nxos.nxos_udld_interface — управление параметрами конфигурации интерфейса UDLD.

Примечание

Этот модуль входит в коллекцию cisco.nxos (версия 11.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

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

Чтобы использовать модуль в плейбуке, укажите: cisco.nxos.nxos_udld_interface.

Добавлено в cisco.nxos 1.0.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Управление параметрами конфигурации интерфейса UDLD.

Примечание

Для этого модуля имеется соответствующий плагин действий.

Псевдонимы: udld_interface

Параметры

Параметр	Комментарии
interface строка / обязательный	Полное имя интерфейса, например Ethernet1/1-
mode строка / обязательный	Управление режимом UDLD для интерфейса. Варианты: `"enabled"` `"disabled"` `"aggressive"`
state строка	Управление состоянием ресурса. Варианты: `"present"` ← (по умолчанию) `"absent"`

Примечания

Примечание

Протестировано на NXOSv 7.3.(0)D1(1) в VIRL
Не поддерживается на Cisco MDS
Для использования этого модуля на устройстве должна быть включена функция UDLD.
Информацию об использовании CLI и NX-API см. в :ref:`руководстве по параметрам платформы NXOS <nxos_platform_options>`
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в :ref:`руководстве по сетям Ansible <network_guide>`
Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на `странице интеграции Cisco <https://www.ansible.com/integrations/networks/cisco>`_.

Примеры

# ensure Ethernet1/1 is configured to be in aggressive mode
- cisco.nxos.nxos_udld_interface:
    interface: Ethernet1/1
    mode: aggressive
    state: present
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

# Remove the aggressive config only if it's currently in aggressive mode and then disable udld (switch default)
- cisco.nxos.nxos_udld_interface:
    interface: Ethernet1/1
    mode: aggressive
    state: absent
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

# ensure Ethernet1/1 has aggressive mode enabled
- cisco.nxos.nxos_udld_interface:
    interface: Ethernet1/1
    mode: enabled
    host: '{{ inventory_hostname }}'
    username: '{{ un }}'
    password: '{{ pwd }}'

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

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

Ключ	Описание
changed логическое значение	проверка того, было ли внесено изменение на устройстве Возвращается: всегда Пример: `true`
end_state словарь	пары ключ/значение конфигурации после выполнения модуля Возвращается: всегда Пример: `{"mode": "enabled"}`
existing словарь	пары ключ/значение существующей конфигурации Возвращается: всегда Пример: `{"mode": "aggressive"}`
proposed словарь	пары ключ/значение параметров, переданных модулю Возвращается: всегда Пример: `{"mode": "enabled"}`
updates список / элементы=строка	команда, отправленная устройству Возвращается: всегда Пример: `["interface ethernet1/33", "no udld aggressive ; no udld disable"]`

Авторы

Jason Edelman (@jedelman8)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/nxos/nxos_udld_interface_module.html