fortinet.fortimanager.fmgr_firewall_address6_dynamicmapping 模块 – 配置 IPv6 防火墙地址。

注意

此模块是 fortinet.fortimanager 集合 (版本 2.8.2) 的一部分。

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

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

要在 playbook 中使用它，请指定： fortinet.fortimanager.fmgr_firewall_address6_dynamicmapping。

fortinet.fortimanager 2.0.0 中的新增功能

概要

• 此模块能够配置 FortiManager 设备。

• 示例包含所有参数和值，在使用前需要根据数据源进行调整。

参数

参数	注释
access_token 字符串	无需使用用户名和密码即可访问 FortiManager 的令牌。
address6 字符串 / 必需	请求 URL 中的参数 (address6)。
adom 字符串 / 必需	请求 URL 中的参数 (adom)。
bypass_validation 布尔值	仅当模块模式与 FortiManager API 结构不同时设置为 True，模块将继续执行而无需验证参数。 选项 false ← (默认) true
enable_log 布尔值	启用/禁用任务日志记录。 选项 false ← (默认) true
firewall_address6_dynamicmapping 字典	设置的顶级参数。
_image_base64 别名：_image-base64 字符串	图像 base64。
_scope 列表 / 元素=字典	范围。
name 字符串	名称。
vdom 字符串	Vdom。
cache_ttl 别名：cache-ttl 整数	缓存 ttl。
color 整数	颜色。
comment 字符串	注释。
country 字符串	国家。
end_ip 别名：end-ip 字符串	结束 IP。
end_mac 别名：end-mac 字符串	结束 MAC。
epg_name 别名：epg-name 字符串	端点组名称。
fabric_object 别名：fabric-object 字符串	安全结构全局对象设置。 选项 "disable" "enable"
filter 字符串	匹配条件过滤器。
fqdn 字符串	FQDN。
global_object 别名：global-object 整数	全局对象。
host 字符串	主机。
host_type 别名：host-type 字符串	主机类型。 选项 "any" "specific"
ip6 字符串	Ip6。
macaddr any	(列表) 多个 MAC 地址范围。
obj_id 别名：obj-id 字符串	Obj ID。
route_tag 别名：route-tag 整数	路由标签地址。
sdn 字符串	SDN。 选项 "nsx"
sdn_addr_type 别名：sdn-addr-type 字符串	要收集的地址类型。 选项 "all" "private" "public"
sdn_tag 别名：sdn-tag 字符串	SDN 标签。
start_ip 别名：start-ip 字符串	起始 IP。
start_mac 别名：start-mac 字符串	起始 MAC。
subnet_segment 别名：subnet-segment 列表 / 元素=字典	子网段。
name 字符串	名称。
type 字符串	类型。 选项 "any" "specific"
value 字符串	值。
tags any	(列表或字符串) 标签。
template 字符串	模板。
tenant 字符串	租户。
type 字符串	类型。 选项 "ipprefix" "iprange" "nsx" "dynamic" "fqdn" "template" "mac" "geography" "route-tag"
uuid 字符串	Uuid。
visibility 字符串	可见性。 选项 "disable" "enable"
forticloud_access_token 字符串	使用 forticloud API 访问令牌对 Ansible 客户端进行身份验证。
proposed_method 字符串	对底层 Json RPC 请求的覆盖方法。 选项 "update" "set" "add"
rc_failed 列表 / 元素=整数	将被覆盖的失败条件的 rc 代码列表。
rc_succeeded 列表 / 元素=整数	将被覆盖的成功条件的 rc 代码列表。
state 字符串 / 必需	创建、更新或删除对象的指令。 选项 "present" "absent"
workspace_locking_adom 字符串	在工作区模式下运行 FortiManager 时要锁定的 adom，该值可以是全局的和其他值，包括 root。
workspace_locking_timeout 整数	等待其他用户释放工作区锁定的最大时间（秒）。 默认值： 300

备注

注意

• 从 2.4.0 版本开始，所有输入参数都使用下划线命名约定（snake_case）。请将诸如“var-name”之类的参数更改为“var_name”。旧的参数名称仍然可用，但您会收到弃用警告。您可以通过在 ansible.cfg 中设置 deprecation_warnings=False 来忽略此警告。

• 此 FortiManager 模块支持在工作区锁定模式下运行，顶级参数 workspace_locking_adom 和 workspace_locking_timeout 用于执行此操作。

• 要创建或更新对象，请使用 state present 指令。

• 要删除对象，请使用 state absent 指令。

• 通常情况下，当返回非零 rc 时，运行一个模块可能会失败。您还可以使用参数 rc_failed 和 rc_succeeded 覆盖失败或成功的条件。

示例

- name: Example playbook
  hosts: fortimanagers
  connection: httpapi
  vars:
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_httpapi_port: 443
  tasks:
    - name: Configure dynamic mappings of IPv6 address
      fortinet.fortimanager.fmgr_firewall_address6_dynamicmapping:
        bypass_validation: false
        adom: ansible
        address6: "ansible-test" # name
        state: present
        firewall_address6_dynamicmapping:
          _scope:
            - name: FGT_AWS # need a valid device name
              vdom: root # need a valid vdom name under the device
          cache-ttl: 0
          color: 22
          comment: "ansible-test-comment"
          end-ip: "::100"
          host: "::"
          host-type: any # <value in [any, specific]>
          ip6: "::/128"
          start-ip: "::"
          type: iprange # <value in [ipprefix, iprange, nsx, ...]>
          visibility: enable

- name: Gathering fortimanager facts
  hosts: fortimanagers
  gather_facts: false
  connection: httpapi
  vars:
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_httpapi_port: 443
  tasks:
    - name: Retrieve all the dynamic mappings of IPv6 address
      fortinet.fortimanager.fmgr_fact:
        facts:
          selector: "firewall_address6_dynamicmapping"
          params:
            adom: "ansible"
            address6: "ansible-test" # name
            dynamic_mapping: "your_value"

返回值

常见的返回值已在 此处 记录，以下是此模块特有的字段

键	描述
meta 字典	请求的结果。 返回：始终
request_url 字符串	请求的完整 URL。 返回：始终 示例： "/sys/login/user"
response_code 整数	API 请求的状态。 返回：始终 示例： 0
response_data 列表 / 元素=字符串	API 响应。 返回：始终
response_message 字符串	API 响应的描述性消息。 返回：始终 示例： "OK."
system_information 字典	目标系统的信息。 返回：始终
rc 整数	请求的状态。 返回：始终 示例： 0
version_check_warning 列表 / 元素=字符串	如果剧本中使用的参数不受当前 FortiManager 版本支持，则会发出警告。 返回：复杂类型

作者

• 杜欣伟 (@dux-fortinet)

• 李兴 (@lix-fortinet)

• 薛杰 (@JieX19)

• 郑凌 (@chillancezen)

• 沈锋 (@fshen01)

• 卢洪滨 (@fgtdev-hblu)

收藏链接

• 问题追踪器
• 主页
• 代码库 (源代码)