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

Примечание

Этот модуль является частью коллекции cisco.nxos (версия 8.1.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 список / элементы=строка	При указании этого аргумента будут собираться конфигурационные факты только для заданного подмножества. Можно указать список значений для включения большего подмножества. Значения также могут быть использованы с начальным `!` для указания того, что определенное подмножество не должно собираться. Допустимые подмножества: `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 список / элементы=строка	При указании этого аргумента будут собираться операционные факты только для заданного подмножества. Возможные значения для этого аргумента включают `all`, `hardware`, `config`, `legacy`, `interfaces`, и `min`. Можно указать список значений для включения большего подмножества. Значения также могут быть использованы с начальным `!` для указания того, что определенное подмножество не должно собираться. По умолчанию: `["min"]`

Примечания

Примечание

Проверено на NXOSv 7.3.(0)D1(1) на VIRL
Не поддерживается для Cisco MDS
Для получения информации об использовании CLI и NX-API см. руководство :ref:`NXOS Platform Options <nxos_platform_options>`
Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами см. руководство :ref:`Ansible Network Guide <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	Текущая активная конфигурация устройства Возвращается: когда конфигурация настроена
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	Идентификатор хоста лицензии устройства Возвращается: всегда
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 строка	Версия программного обеспечения, используемая для загрузки системы Возвращаемое значение: при конфигурировании устаревшего режима
module словарь	Хеш-таблица фактов о модулях в удалённом устройстве Возвращаемое значение: при конфигурировании устаревшего режима
platform строка	Аппаратная платформа, сообщённая удалённым устройством Возвращаемое значение: при конфигурировании устаревшего режима
power_supply_info строка	Хеш-таблица фактов об источниках питания в удалённом устройстве Возвращаемое значение: при конфигурировании устаревшего режима
vlan_list список / элементы=строка	Список идентификаторов VLAN, настроенных на удалённом устройстве Возвращаемое значение: при конфигурировании устаревшего режима

Авторы

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

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

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