ftd_configuration – Управление конфигурацией устройств Cisco FTD через REST API
Новая версия с 2.7.
Описание
- Управление конфигурацией устройств 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
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
ftd_configuration:
operation: "deleteNetworkObject"
path_params:
objId: "{{ hostNetwork['id'] }}"
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| response словарь | успех | HTTP-ответ, возвращенный вызовом API. |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Cisco Systems, Inc. (@annikulin)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/ftd_configuration_module.html