community.network.ftd_configuration – Manages configuration on Cisco FTD devices over REST API

Note

This plugin is part of the community.network collection (version 2.1.1).

To install it use: ansible-galaxy collection install community.network.

To use it in a playbook, specify: community.network.ftd_configuration.

Synopsis

  • Manages configuration on Cisco FTD devices including creating, updating, removing configuration objects, scheduling and staring jobs, deploying pending changes, etc. All operations are performed over REST API.

Parameters

Parameter Choices/Defaults Comments
data
dictionary
Key-value pairs that should be sent as body parameters in a REST API call
filters
dictionary
Key-value dict that represents equality filters. Every key is a property name and value is its desired value. If multiple filters are present, they are combined with logical operator AND.
operation
string / required
The name of the operation to execute. Commonly, the operation starts with 'add', 'edit', 'get', 'upsert' or 'delete' verbs, but can have an arbitrary name too.
path_params
dictionary
Key-value pairs that should be sent as path parameters in a REST API call.
query_params
dictionary
Key-value pairs that should be sent as query parameters in a REST API call.
register_as
string
Specifies Ansible fact name that is used to register received response from the FTD device.

Examples

- 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'] }}"

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
response
dictionary
success
HTTP response returned from the API call.



Authors

  • Cisco Systems, Inc. (@annikulin)