fortios_config - Управление конфигурацией на устройствах межсетевого экрана Fortinet FortiOS
Новая версия с 2.3.
Обзор
- Этот модуль предоставляет управление конфигурацией устройств FortiOS.
Параметры
| параметр | обязательно | по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| backup | нет |
| Этот аргумент заставит модуль создать резервную копию текущей running-config удаленного устройства перед внесением каких-либо изменений. Файл резервной копии записывается в папку i(backup). | |
| backup_filename | нет | Указывает имя файла резервной копии. Если опущено, имя файла будет отформатировано как HOST_config.ГГГГ-ММ-ДД@ЧЧ:ММ:СС | ||
| backup_path | нет | Указывает, где хранить резервные файлы. Требуется, если backup=да. | ||
| config_file (добавлено в 2.4)
| нет | Путь к файлу конфигурации. Требуется, когда file_mode равен True. | ||
| file_mode (добавлено в 2.4)
| нет |
| Не подключаться к устройству, использовать только config_file в качестве входных и выходных данных. | |
| filter | нет | Только для частичной резервной копии, вы можете ограничить ее, указав ожидаемый путь к конфигурации (например, адрес брандмауэра). | ||
| host | нет | Указывает имя хоста DNS или IP-адрес для подключения к удаленному устройству fortios. Требуется, когда file_mode равен False. | ||
| password | нет | Указывает пароль, используемый для аутентификации на удаленном устройстве. Требуется, когда file_mode равен True. | ||
| src | нет | Аргумент src предоставляет путь к шаблону конфигурации для загрузки на удаленное устройство. | ||
| timeout | нет | 60 | Таймаут в секундах для подключения к удаленному устройству. | |
| username | нет | Настраивает имя пользователя, используемое для аутентификации на удаленном устройстве. Требуется, когда file_mode равен True. | ||
| vdom | нет | Указывает, на каком vdom применить конфигурацию |
Примеры
- name: Backup current config
fortios_config:
host: 192.168.0.254
username: admin
password: password
backup: yes
- name: Backup only address objects
fortios_config:
host: 192.168.0.254
username: admin
password: password
backup: yes
backup_path: /tmp/forti_backup/
filter: "firewall address"
- name: Update configuration from file
fortios_config:
host: 192.168.0.254
username: admin
password: password
src: new_configuration.conf.j2
Возвращаемые значения
Общие возвращаемые значения документированы здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| название | описание | возвращается | тип | пример |
|---|---|---|---|---|
| change_string | Команды, фактически выполненные модулем | только если конфигурация изменена | строка | |
| running_config | полная строка конфигурации | всегда | строка |
Примечания
Примечание
- Этот модуль требует библиотеку pyFG python
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вы заинтересованы, прочитайте Информация о сообществе и сотрудничестве, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/fortios_config_module.html
