dellos9_facts - Сбор фактов с удалённых устройств, работающих под управлением Dell EMC Networking OS9
Новое в версии 2.2.
Описание
- Сбор базового набора фактов устройства с удалённого устройства, работающего под управлением OS9. Этот модуль добавляет к ключам всех базовых сетевых фактов префикс
ansible_net_<fact>. Модуль фактов всегда собирает базовый набор фактов с устройства и может включать или отключать сбор дополнительных фактов.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| gather_subset | Значение по умолчанию: ["!config"] | При указании этого аргумента, сбор фактов будет ограничен заданным подмножеством. Возможные значения для этого аргумента включают all, hardware, config и interfaces. Можно указать список значений для включения большего подмножества. Значения также можно использовать с начальным ! для указания того, что определённое подмножество не должно собираться. | |
| provider | Объект dict, содержащий данные подключения. | ||
| host обязательно | Указывает имя хоста DNS или адрес для подключения к удалённому устройству по указанному транспорту. Значение host используется в качестве адреса назначения для транспорта. | ||
| port | Значение по умолчанию: 22 | Указывает порт для подключения к удалённому устройству. | |
| username | Пользователь для аутентификации SSH-сессии на удалённом устройстве. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_USERNAME. | ||
| password | Пароль для аутентификации SSH-сессии на удалённом устройстве. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_PASSWORD. | ||
| ssh_keyfile | Путь к SSH-ключу, используемому для аутентификации SSH-сессии на удалённом устройстве. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout | Значение по умолчанию: 10 | Указывает таймаут бездействия (в секундах) для подключения. Полезно, если консоль зависает перед продолжением. Например, при сохранении конфигураций. | |
Примечания
Примечание
- Данный модуль требует ОС9 версии 9.10.0.1P13 или выше.
- Данному модулю требуется увеличить лимит скорости подключений SSH. Используйте следующую команду ip ssh connection-rate-limit 60 для конфигурации. Это также можно сделать с помощью модуля dellos9_config.
- Дополнительную информацию о использовании Ansible для управления устройствами Dell EMC Network см. на странице https://www.ansible.com/ansible-dell-networking.
Примеры
# Collect all facts from the device
- dellos9_facts:
gather_subset: all
# Collect only the config and default facts
- dellos9_facts:
gather_subset:
- config
# Do not collect hardware facts
- dellos9_facts:
gather_subset:
- "!hardware"
Возвращаемые значения
Общие возвращаемые значения описаны в здесь. Ниже перечислены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| ansible_net_all_ipv4_addresses список | при конфигурации interfaces | Все IP-адреса IPv4, настроенные на устройстве |
| ansible_net_all_ipv6_addresses список | при конфигурации interfaces | Все IP-адреса IPv6, настроенные на устройстве |
| ansible_net_config строка | при конфигурации config | Текущая активная конфигурация с устройства |
| ansible_net_filesystems список | при конфигурации hardware | Все имена файловых систем, доступные на устройстве |
| ansible_net_gather_subset список | всегда | Список подмножеств фактов, собранных с устройства |
| ansible_net_hostname строка | всегда | Настроенное имя хоста устройства |
| ansible_net_image строка | всегда | Файл образа, используемый устройством |
| ansible_net_interfaces словарь | при конфигурации interfaces | Хеш-таблица всех интерфейсов на системе |
| ansible_net_memfree_mb целое число | при конфигурации hardware | Доступная свободная память на удалённом устройстве в Мб |
| ansible_net_memtotal_mb целое число | при конфигурации hardware | Общий объём памяти на удалённом устройстве в Мб |
| ansible_net_model строка | всегда | Имя модели, возвращённое устройством |
| ansible_net_neighbors словарь | при конфигурации interfaces | Список соседей LLDP с удалённого устройства |
| ansible_net_serialnum строка | всегда | Серийный номер удалённого устройства |
| ansible_net_version строка | всегда | Версия операционной системы, работающей на удалённом устройстве |
Статус
Данный модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Техническое обслуживание
Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в поддержке и обслуживании модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Dhivya P (@dhivyap)
Подсказка
Если вы обнаружите какие-либо проблемы в данном документе, вы можете изменить его, чтобы улучшить его.
© 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/dellos9_facts_module.html
