Модуль cisco.nxos.nxos_system — управление системными атрибутами на устройствах Cisco NXOS

Примечание

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

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

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

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

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

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

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

Этот модуль обеспечивает декларативное управление системными атрибутами узла на устройствах Cisco NXOS. Он позволяет настраивать параметры хост-системы или удалять эти параметры из активной конфигурации устройства.

Примечание

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

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

Параметры

Параметр	Комментарии
domain_lookup логический	Включает или отключает функцию поиска DNS в Cisco NXOS. Этот аргумент принимает логические значения. Если функция включена, система пытается разрешать имена узлов с помощью DNS; если отключена, имена узлов разрешаться не будут. Варианты: `false` `true`
domain_name список / элементы=любые	Настраивает суффикс доменного имени по умолчанию, используемый при обращении к этому узлу по его полному доменному имени (FQDN). Этот аргумент принимает список доменных имён или список словарей, задающих доменное имя и имя VRF либо ключевое слово ‘default’. См. примеры.
domain_search список / элементы=любые	Настраивает список суффиксов доменных имён, используемых при поиске во время разрешения DNS-имён. Этот аргумент принимает список доменных имён или список словарей, задающих доменное имя и имя VRF либо ключевое слово ‘default’. См. примеры.
hostname строка	Настраивает параметр имени узла устройства. Этот параметр принимает строковое значение ASCII или ключевое слово ‘default’
name_servers список / элементы=любые	Список DNS-серверов имён с IP-адресами, используемых для разрешения имён. Этот аргумент принимает список DNS-серверов или список хешей, задающих сервер имён и имя VRF либо ключевое слово ‘default’. См. примеры.
state строка	Состояние значений конфигурации в текущей активной конфигурации устройства. Если задано значение present, значения должны быть настроены в активной конфигурации устройства; если задано значение absent, значения не должны присутствовать в активной конфигурации устройства. Варианты: `"present"` ← (по умолчанию) `"absent"`
system_mtu строка	Задаёт MTU; значение должно быть целым числом или ключевым словом ‘default’.

Примечания

Примечание

Не поддерживается на Cisco MDS
Сведения об использовании CLI и NX-API см. в руководстве :ref:`Параметры платформы NXOS <nxos_platform_options>`
Дополнительные сведения об использовании Ansible для управления сетевыми устройствами см. в :ref:`руководстве по сетевым устройствам Ansible <network_guide>`
Дополнительные сведения об использовании Ansible для управления устройствами Cisco см. на `странице интеграции Cisco <https://www.ansible.com/integrations/networks/cisco>`_.

Примеры

- name: configure hostname and domain-name
  cisco.nxos.nxos_system:
    hostname: nxos01
    domain_name: test.example.com

- name: remove configuration
  cisco.nxos.nxos_system:
    state: absent

- name: configure name servers
  cisco.nxos.nxos_system:
    name_servers:
      - 8.8.8.8
      - 8.8.4.4

- name: configure name servers with VRF support
  cisco.nxos.nxos_system:
    name_servers:
      - {server: 8.8.8.8, vrf: mgmt}
      - {server: 8.8.4.4, vrf: mgmt}

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

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

Ключ	Описание
commands список / элементы=строка	Список команд режима конфигурации, отправляемых устройству Возвращается: всегда Пример: `["hostname nxos01", "ip domain-name test.example.com"]`

Авторы

Peter Sprygada (@privateip)

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

© 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_system_module.html