community.network.ftd_configuration 模块 – 通过 REST API 管理 Cisco FTD 设备上的配置

注意

此模块是 community.network 集合（版本 5.1.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.network。

要在 playbook 中使用它，请指定：community.network.ftd_configuration。

注意

community.network 集合已被弃用，并将从 Ansible 12 中删除。有关更多信息，请参阅讨论主题。

已弃用

删除版本:

6.0.0 版本

原因:

此集合及其中的所有内容均未维护且已弃用。

替代方案:

未知。

概要

  • 管理 Cisco FTD 设备上的配置，包括创建、更新、删除配置对象、调度和启动作业、部署待处理的更改等。所有操作均通过 REST API 执行。

别名：network.ftd.ftd_configuration

参数

参数

注释

data

字典

应作为 REST API 调用中的正文参数发送的键值对

filters

字典

表示相等性过滤器的键值字典。每个键都是属性名称，值是其期望值。如果存在多个过滤器，则它们与逻辑运算符 AND 组合在一起。

operation

字符串 / 必填

要执行的操作的名称。通常，操作以 “add”、“edit”、“get”、“upsert” 或 “delete” 动词开头，但也可能具有任意名称。

path_params

字典

应作为 REST API 调用中的路径参数发送的键值对。

query_params

字典

应作为 REST API 调用中的查询参数发送的键值对。

register_as

字符串

指定用于注册从 FTD 设备接收的响应的 Ansible 事实名称。

示例

- 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

字典

从 API 调用返回的 HTTP 响应。

返回: 成功

状态

  • 此模块将在 6.0.0 版本中删除。[已弃用]

  • 有关更多信息，请参阅 已弃用。

作者

  • Cisco Systems, Inc. (@annikulin)