fortinet.fortimanager.fmgr_router_routemap 模块 – 配置路由映射。

注意

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

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

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

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

fortinet.fortimanager 2.1.0 中的新增功能

概要

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

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

参数

参数

注释

access_token

字符串

无需用户名和密码即可访问 FortiManager 的令牌。

adom

字符串 / 必需

请求 URL 中的参数 (adom)。

bypass_validation

布尔值

仅当模块模式与 FortiManager API 结构不同时设置为 True，模块将继续执行而无需验证参数。

选项

  • false ← (默认)

  • true

enable_log

布尔值

启用/禁用任务日志记录。

选项

  • false ← (默认)

  • true

forticloud_access_token

字符串

使用 FortiCloud API 访问令牌验证 Ansible 客户端。

proposed_method

字符串

底层 Json RPC 请求的覆盖方法。

选项

  • "update"

  • "set"

  • "add"

rc_failed

列表 / 元素=整数

将覆盖失败条件的 rc 代码列表。

rc_succeeded

列表 / 元素=整数

将覆盖成功条件的 rc 代码列表。

router_routemap

字典

设置的顶级参数。

comments

字符串

可选注释。

name

字符串 / 必需

名称。

rule

列表 / 元素=字典

规则。

action

字符串

动作。

选项

  • "permit"

  • "deny"

id

整数

规则 ID。

match_as_path

别名：match-as-path

字符串

匹配 BGP AS 路径列表。

match_community

别名：match-community

字符串

匹配 BGP 社区列表。

match_community_exact

别名：match-community-exact

字符串

启用/禁用社区的精确匹配。

选项

  • "disable"

  • "enable"

match_extcommunity

别名：match-extcommunity

字符串

匹配 BGP 扩展社区列表。

match_extcommunity_exact

别名：match-extcommunity-exact

字符串

启用/禁用扩展社区的精确匹配。

选项

  • "disable"

  • "enable"

match_flags

别名：match-flags

整数

匹配标志。

match_interface

别名：match-interface

字符串

匹配接口配置。

match_ip6_address

别名：match-ip6-address

字符串

匹配 access-list6 或 prefix-list6 允许的 IPv6 地址。

match_ip6_nexthop

别名：match-ip6-nexthop

字符串

匹配 access-list6 或 prefix-list6 传递的下一跳 IPv6 地址。

match_ip_address

别名：match-ip-address

字符串

匹配 access-list 或 prefix-list 允许的 IP 地址。

match_ip_nexthop

别名：match-ip-nexthop

字符串

匹配 access-list 或 prefix-list 传递的下一跳 IP 地址。

match_metric

别名：match-metric

字符串

匹配重新分配路由的度量。

match_origin

别名：match-origin

字符串

匹配 BGP 源代码。

选项

  • "none"

  • "egp"

  • "igp"

  • "incomplete"

match_route_type

别名：match-route-type

字符串

匹配路由类型。

选项

  • "1"

  • "2"

  • "none"

  • "external-type1"

  • "external-type2"

match_tag

别名：match-tag

字符串

匹配标签。

match_vrf

别名：match-vrf

整数

匹配 VRF ID。

set_aggregator_as

别名：set-aggregator-as

整数

BGP 聚合器 AS。

set_aggregator_ip

别名：set-aggregator-ip

字符串

BGP 聚合器 IP。

set_aspath

别名：set-aspath

任意

(列表) 预置 BGP AS 路径属性。

set_aspath_action

别名：set-aspath-action

字符串

指定 set-aspath 的首选操作。

选项

  • "prepend"

  • "replace"

set_atomic_aggregate

别名：set-atomic-aggregate

字符串

启用/禁用 BGP 原子聚合属性。

选项

  • "disable"

  • "enable"

set_community

别名：set-community

任意

(列表) BGP 社区属性。

set_community_additive

别名：set-community-additive

字符串

启用/禁用将 set-community 添加到现有社区。

选项

  • "disable"

  • "enable"

set_community_delete

别名：set-community-delete

字符串

删除与社区列表匹配的社区。

set_dampening_max_suppress

别名：set-dampening-max-suppress

整数

抑制路由的最大持续时间

set_dampening_reachability_half_life

别名: set-dampening-reachability-half-life

整数

惩罚的可达性半衰期时间

set_dampening_reuse

别名: set-dampening-reuse

整数

开始重用路由的值

set_dampening_suppress

别名: set-dampening-suppress

整数

开始抑制路由的值

set_dampening_unreachability_half_life

别名: set-dampening-unreachability-half-life

整数

惩罚的不可达性半衰期时间

set_extcommunity_rt

别名: set-extcommunity-rt

任意

(列表) 路由目标扩展社区。

set_extcommunity_soo

别名: set-extcommunity-soo

任意

(列表) 源站扩展社区。

set_flags

别名: set-flags

整数

设置标志。

set_ip6_nexthop

别名: set-ip6-nexthop

字符串

下一跳的IPv6全局地址。

set_ip6_nexthop_local

别名: set-ip6-nexthop-local

字符串

下一跳的IPv6本地地址。

set_ip_nexthop

别名: set-ip-nexthop

字符串

下一跳的IP地址。

set_ip_prefsrc

别名: set-ip-prefsrc

字符串

首选源的IP地址。

set_local_preference

别名: set-local-preference

字符串

BGP本地首选路径属性。

set_metric

别名: set-metric

字符串

度量值。

set_metric_type

别名: set-metric-type

字符串

度量类型。

选项

  • "1"

  • "2"

  • "none"

  • "external-type1"

  • "external-type2"

set_origin

别名: set-origin

字符串

BGP源代码。

选项

  • "none"

  • "egp"

  • "igp"

  • "incomplete"

set_originator_id

别名: set-originator-id

字符串

BGP发起者ID属性。

set_priority

别名: set-priority

整数

路由表的优先级。

set_route_tag

别名: set-route-tag

字符串

路由表的路由标签。

set_tag

别名: set-tag

字符串

标签值。

set_vpnv4_nexthop

别名: set-vpnv4-nexthop

字符串

VPNv4下一跳的IP地址。

set_vpnv6_nexthop

别名: set-vpnv6-nexthop

字符串

VPNv6下一跳的IPv6全局地址。

set_vpnv6_nexthop_local

别名: set-vpnv6-nexthop-local

字符串

VPNv6下一跳的IPv6本地链路地址。

set_weight

别名: set-weight

字符串

路由表的BGP权重。

状态

字符串 / 必需

创建、更新或删除对象的指令。

选项

  • "存在"

  • "不存在"

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有助于完成此工作。

  • 要创建或更新对象，请使用状态“存在”指令。

  • 要删除对象，请使用状态“不存在”指令。

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

示例

- name: Example playbook (generated based on argument schema)
  hosts: fortimanagers
  connection: httpapi
  vars:
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_httpapi_port: 443
  tasks:
    - name: Configure route maps.
      fortinet.fortimanager.fmgr_router_routemap:
        # bypass_validation: false
        workspace_locking_adom: <value in [global, custom adom including root]>
        workspace_locking_timeout: 300
        # rc_succeeded: [0, -2, -3, ...]
        # rc_failed: [-2, -3, ...]
        adom: <your own value>
        state: present # <value in [present, absent]>
        router_routemap:
          comments: <string>
          name: <string>
          rule:
            -
              action: <value in [permit, deny]>
              id: <integer>
              match_as_path: <string>
              match_community: <string>
              match_community_exact: <value in [disable, enable]>
              match_flags: <integer>
              match_interface: <string>
              match_ip_address: <string>
              match_ip_nexthop: <string>
              match_ip6_address: <string>
              match_ip6_nexthop: <string>
              match_metric: <string>
              match_origin: <value in [none, egp, igp, ...]>
              match_route_type: <value in [1, 2, none, ...]>
              match_tag: <string>
              match_vrf: <integer>
              set_aggregator_as: <integer>
              set_aggregator_ip: <string>
              set_aspath: <list or string>
              set_aspath_action: <value in [prepend, replace]>
              set_atomic_aggregate: <value in [disable, enable]>
              set_community: <list or string>
              set_community_additive: <value in [disable, enable]>
              set_community_delete: <string>
              set_dampening_max_suppress: <integer>
              set_dampening_reachability_half_life: <integer>
              set_dampening_reuse: <integer>
              set_dampening_suppress: <integer>
              set_dampening_unreachability_half_life: <integer>
              set_extcommunity_rt: <list or string>
              set_extcommunity_soo: <list or string>
              set_flags: <integer>
              set_ip_nexthop: <string>
              set_ip6_nexthop: <string>
              set_ip6_nexthop_local: <string>
              set_local_preference: <string>
              set_metric: <string>
              set_metric_type: <value in [1, 2, none, ...]>
              set_origin: <value in [none, egp, igp, ...]>
              set_originator_id: <string>
              set_priority: <integer>
              set_route_tag: <string>
              set_tag: <string>
              set_weight: <string>
              match_extcommunity: <string>
              match_extcommunity_exact: <value in [disable, enable]>
              set_ip_prefsrc: <string>
              set_vpnv4_nexthop: <string>
              set_vpnv6_nexthop: <string>
              set_vpnv6_nexthop_local: <string>

返回值

公共返回值已记录在此处，以下是此模块独有的字段

键

描述

元数据

字典

请求的结果。

返回：始终

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)