Модуль cisco.nxos.nxos_facts – получает сведения о коммутаторах NX-OS

Примечание

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

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

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

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

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

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

Описание

Собирает сведения с устройств Cisco Nexus под управлением операционной системы NX-OS. Сбор сведений поддерживается как через network_cli, так и через httpapi. Этот модуль добавляет префикс ansible_net_<fact> ко всем базовым ключам сетевых сведений. Модуль всегда собирает с устройства базовый набор сведений и позволяет включать или отключать сбор дополнительных сведений.

Примечание

Этому модулю соответствует модуль действия.

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

Параметры

Параметр	Комментарии
available_network_resources boolean	Если задано значение `true`, будет предоставлен список сетевых ресурсов, для которых доступны модули ресурсов. Варианты: `false` ← (по умолчанию) `true`
gather_network_resources list / elements=string	Если указан этот аргумент, сведения о конфигурации будут собраны только для заданного подмножества. Можно указать список значений, чтобы включить большее подмножество. Значения также можно использовать с начальным `!`, чтобы указать, что определённое подмножество собирать не следует. Допустимые подмножества: `all`, `bfd_interfaces`, `lag_interfaces`, `telemetry`, `vlans`, `lacp`, `lacp_interfaces`, `interfaces`, `l3_interfaces`, `l2_interfaces`, `lldp_global`, `acls`, `acl_interfaces`, `ospfv2`, `ospfv3`, `ospf_interfaces`, `bgp_global`, `bgp_address_family`, `route_maps`, `prefix_lists`, `logging_global`, `ntp_global`, `snmp_server`, `hostname`.
gather_subset list / elements=string	Если указан этот аргумент, будут собраны только эксплуатационные сведения для заданного подмножества. Возможные значения этого аргумента: `all`, `hardware`, `config`, `legacy`, `interfaces` и `min`. Можно указать список значений, чтобы включить большее подмножество. Значения также можно использовать с начальным `!`, чтобы указать, что определённое подмножество собирать не следует. По умолчанию: `["min"]`

Примечания

Примечание

Проверено на NXOSv 7.3.(0)D1(1) в VIRL
Не поддерживается для 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: Gather all legacy facts
  cisco.nxos.nxos_facts:
    gather_subset: all
- name: Gather only the config and default facts
  cisco.nxos.nxos_facts:
    gather_subset:
      - config
- name: Do not gather hardware facts
  cisco.nxos.nxos_facts:
    gather_subset:
      - '!hardware'
- name: Gather legacy and resource facts
  cisco.nxos.nxos_facts:
    gather_subset: all
    gather_network_resources: all
- name: Gather only the interfaces resource facts and no legacy facts
  cisco.nxos.nxos_facts:
    gather_subset:
      - '!all'
      - '!min'
    gather_network_resources:
      - interfaces
- name: Gather interfaces resource and minimal legacy facts
  cisco.nxos.nxos_facts:
    gather_subset: min
    gather_network_resources: interfaces

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

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

Ключ	Описание
ansible_net_all_ipv4_addresses list / elements=string	Все адреса IPv4, настроенные на устройстве Возвращается: если настроены интерфейсы
ansible_net_all_ipv6_addresses list / elements=string	Все адреса IPv6, настроенные на устройстве Возвращается: если настроены интерфейсы
ansible_net_api string	Название транспорта Возвращается: всегда
ansible_net_config string	Текущая активная конфигурация устройства Возвращается: если настроен config
ansible_net_filesystems list / elements=string	Названия всех файловых систем, доступных на устройстве Возвращается: если настроено оборудование
ansible_net_gather_network_resources list / elements=string	Список подмножеств сведений о сетевых ресурсах, собранных с устройства Возвращается: если ресурс настроен
ansible_net_gather_subset list / elements=string	Список подмножеств сведений, собранных с устройства Возвращается: всегда
ansible_net_hostname string	Имя узла, настроенное на устройстве Возвращается: всегда
ansible_net_image string	Файл образа, под управлением которого работает устройство Возвращается: всегда
ansible_net_interfaces dictionary	Хеш всех интерфейсов, работающих в системе Возвращается: если настроены интерфейсы
ansible_net_license_hostid string	Идентификатор License host устройства Возвращается: всегда
ansible_net_memfree_mb integer	Объём доступной свободной памяти на удалённом устройстве в МБ Возвращается: если настроено оборудование
ansible_net_memtotal_mb integer	Общий объём памяти на удалённом устройстве в МБ Возвращается: если настроено оборудование
ansible_net_model string	Название модели, полученное от устройства Возвращается: всегда
ansible_net_neighbors dictionary	Список соседних устройств LLDP и CDP, обнаруженных устройством. Если на одном порту присутствуют сведения о соседях CDP и LLDP, предпочтение отдаётся CDP. Возвращается: если настроены интерфейсы
ansible_net_python_version string	Версия Python, используемая контроллером Ansible Возвращается: всегда
ansible_net_serialnum string	Серийный номер удалённого устройства Возвращается: всегда
ansible_net_version string	Версия операционной системы, работающей на удалённом устройстве Возвращается: всегда
fan_info dictionary	Хеш сведений о вентиляторах удалённого устройства Возвращается: если настроен legacy
hostname dictionary	Имя узла, настроенное на удалённом устройстве Возвращается: если настроен legacy
interfaces_list dictionary	Список имён интерфейсов на удалённом устройстве Возвращается: если настроен legacy
kickstart string	Версия программного обеспечения, использованная для загрузки системы Возвращается: если настроен legacy
module dictionary	Хеш сведений о модулях удалённого устройства Возвращается: если настроен legacy
platform string	Аппаратная платформа, указанная удалённым устройством Возвращается: если настроен legacy
power_supply_info string	Хеш сведений об источниках питания удалённого устройства Возвращается: если настроен legacy
vlan_list list / elements=string	Список идентификаторов VLAN, настроенных на удалённом устройстве Возвращается: если настроен legacy

Авторы

Jason Edelman (@jedelman8)
Gabriele Gerbino (@GGabriele)

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

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