community.network.ftd_configuration – Управление конфигурацией устройств Cisco FTD через REST API
Примечание
Этот плагин входит в коллекцию community.network (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.network
Для использования в книге задач укажите: community.network.ftd_configuration
Описание
- Управляет конфигурацией устройств Cisco FTD, включая создание, обновление, удаление объектов конфигурации, планирование и запуск задач, развертывание ожидающих изменений и т. д. Все операции выполняются через REST API.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| data словарь | Ключевые пары, которые должны быть отправлены как параметры тела в вызове REST API | |
| filters словарь | Словарь с парами «ключ-значение», представляющий фильтры равенства. Каждый ключ — это имя свойства, а значение — его желаемое значение. Если присутствует несколько фильтров, они комбинируются с логическим оператором И. | |
| operation строка / обязательно | Имя операции для выполнения. Обычно операция начинается с глаголов «add», «edit», «get», «upsert» или «delete», но может иметь и произвольное имя. | |
| path_params словарь | Ключевые пары, которые должны быть отправлены как параметры пути в вызове REST API. | |
| query_params словарь | Ключевые пары, которые должны быть отправлены как параметры запроса в вызове REST API. | |
| register_as строка | Указывает имя факта Ansible, используемое для регистрации полученного ответа от устройства FTD. |
Примеры
- name: Create a network object
community.network.ftd_configuration:
operation: "addNetworkObject"
data:
name: "Ansible-network-host"
description: "From Ansible with love"
subType: "HOST"
value: "192.168.2.0"
dnsResolution: "IPV4_AND_IPV6"
type: "networkobject"
isSystemDefined: false
register_as: "hostNetwork"
- name: Delete the network object
community.network.ftd_configuration:
operation: "deleteNetworkObject"
path_params:
objId: "{{ hostNetwork['id'] }}"
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| response словарь | успех | HTTP ответ, возвращенный вызовом API. |
Авторы
- Cisco Systems, Inc. (@annikulin)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/ftd_configuration_module.html