fortinet.fortios.fortios_facts – Получение фактов о устройствах fortios (собирается устаревать).
Примечание
Этот плагин является частью коллекции fortinet.fortios (версия 1.1.8).
Для его установки используйте: ansible-galaxy collection install fortinet.fortios.
Для использования в плейбуке укажите: fortinet.fortios.fortios_facts.
Новое в версии 2.9: of fortinet.fortios
Описание
- Собирает факты с сетевых устройств, работающих под управлением операционной системы fortios. Этот модуль помещает собранные факты в древовидную структуру фактов, ключи которой соответствуют именам ресурсов. Этот модуль фактов будет собирать только те факты, которые пользователь указал в плейбуке.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- коллекция galaxy fortinet.fortios
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| gather_subset список / элементы=словарь / обязательный | При указании этот аргумент ограничит собираемые факты заданным подмножеством. Возможные значения для этого аргумента включают system_current-admins_select, system_firmware_select, system_fortimanager_status, system_ha-checksums_select, system_interface_select, system_status_select и system_time_select | ||
| fact строка / обязательный | Имя фактов для сбора | ||
| filters список / элементы=словарь | Фильтры применяются при сборе фактов | ||
| host строка | IP-адрес FortiOS или FortiGate. | ||
| https логическое |
| Указывает, должны ли запросы к FortiGate использовать протокол HTTPS. | |
| password строка | Значение по умолчанию: "" | Пароль FortiOS или FortiGate. | |
| ssl_verify логическое |
| Обеспечивает проверку сертификата FortiGate надлежащей доверенной организацией. | |
| username строка | Имя пользователя FortiOS или FortiGate. | ||
| vdom строка | Значение по умолчанию: "root" | Виртуальная область, среди ранее определённых. ВД является виртуальным экземпляром FortiGate, который может быть настроен и использован как отдельное устройство. | |
Примечания
Примечание
- режим httpapi — новый рекомендуемый способ для любых сетевых модулей
- модуль будет устаревать в следующей основной версии.
Примеры
- hosts: localhost
vars:
host: "192.168.122.40"
username: "admin"
password: ""
vdom: "root"
ssl_verify: "False"
tasks:
- name: gather basic system status facts
fortios_facts:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
vdom: "{{ vdom }}"
gather_subset:
- fact: 'system_status_select'
- name: gather all physical interfaces status facts
fortios_facts:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
vdom: "{{ vdom }}"
gather_subset:
- fact: 'system_interface_select'
- name: gather gather all physical and vlan interfaces status facts
fortios_facts:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
vdom: "{{ vdom }}"
gather_subset:
- fact: 'system_interface_select'
filters:
- include_vlan: true
- name: gather basic system info and physical interface port3 status facts
fortios_facts:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
vdom: "{{ vdom }}"
gather_subset:
- fact: 'system_status_select'
- fact: 'system_interface_select'
filters:
- interface_name: 'port3'
Значения возврата
Общие значения возврата описаны здесь, следующие — поля, уникальные для этого модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| build строка | всегда | Номер сборки образа fortigate Пример: 1547 |
| http_method строка | всегда | Последний метод, используемый для предоставления содержимого в FortiGate Пример: GET |
| name строка | всегда | Имя таблицы, используемой для выполнения запроса Пример: firmware |
| path строка | всегда | Путь к таблице, используемой для выполнения запроса Пример: system |
| revision строка | всегда | Внутренний номер ревизии Пример: 17.0.2.10658 |
| serial строка | всегда | Серийный номер устройства Пример: FGVMEVYYQT3AB5352 |
| status строка | всегда | Указание результата операции Пример: success |
| vdom строка | всегда | Использованная виртуальная область Пример: root |
| version строка | всегда | Версия FortiGate Пример: v5.6.3 |
Авторы
- Don Yao (@fortinetps)
- Miguel Angel Munoz (@mamunozgonzalez)
- Nicolas Thomas (@thomnico)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/fortinet/fortios/fortios_facts_module.html