:source: fortios_router_route_map.py
:orphan:
.. fortios_router_route_map:
fortios_router_route_map -- Configure route maps in Fortinet's FortiOS and FortiGate.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
.. versionadded:: 2.0.0
.. contents::
:local:
:depth: 1
Synopsis
--------
- This module is able to configure a FortiGate or FortiOS (FOS) device by allowing the user to set and modify router feature and route_map category. Examples include all parameters and values need to be adjusted to datasources before usage. Tested with FOS v6.0.0
Requirements
------------
The below requirements are needed on the host that executes this module.
- ansible>=2.15
Tips
----
Using member operation to add an element to an existing object.
FortiOS Version Compatibility
-----------------------------
Supported Version Ranges: v6.0.0 -> v7.6.6
Parameters
----------
.. raw:: html
- access_token - Token-based authentication. Generated from GUI of Fortigate. type: str required: false
- enable_log - Enable/Disable logging for task. type: bool required: false default: False
- vdom - Virtual domain, among those defined previously. A vdom is a virtual instance of the FortiGate that can be configured and used as a different unit. type: str default: root
- member_path - Member attribute path to operate on. type: str
- member_state - Add or delete a member under specified attribute path. type: str choices: present, absent
- state - Indicates whether to create or remove the object. type: str required: true choices: present, absent
- router_route_map - Configure route maps. type: dict
more...
| Supported Version Ranges |
| router_route_map |
v6.0.0 -> 7.6.6 |
- comments - Optional comments. type: str
more...
|
Supported Version Ranges |
| comments |
v6.0.0 -> 7.6.6 |
- name - Name. type: str required: true
more...
|
Supported Version Ranges |
| name |
v6.0.0 -> 7.6.6 |
- rule - Rule. type: list member_path: rule:id
more...
| Supported Version Ranges |
| rule |
v6.0.0 -> 7.6.6 |
- action - Action. type: str choices: permit, deny
more...
|
Supported Version Ranges |
| action |
v6.0.0 -> 7.6.6 |
| [permit] |
v6.0.0 -> 7.6.6 |
| [deny] |
v6.0.0 -> 7.6.6 |
- id - Rule ID. see Notes. type: int required: true
more...
|
Supported Version Ranges |
| id |
v6.0.0 -> 7.6.6 |
- match_as_path - Match BGP AS path list. Source router.aspath-list.name. type: str
more...
|
Supported Version Ranges |
| match_as_path |
v6.0.0 -> 7.6.6 |
- match_community - Match BGP community list. Source router.community-list.name. type: str
more...
|
Supported Version Ranges |
| match_community |
v6.0.0 -> 7.6.6 |
- match_community_exact - Enable/disable exact matching of communities. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| match_community_exact |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
- match_extcommunity - Match BGP extended community list. Source router.extcommunity-list.name. type: str
more...
|
Supported Version Ranges |
| match_extcommunity |
v7.2.4 -> 7.6.6 |
- match_extcommunity_exact - Enable/disable exact matching of extended communities. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| match_extcommunity_exact |
v7.2.4 -> 7.6.6 |
| [enable] |
v7.2.4 -> 7.6.6 |
| [disable] |
v7.2.4 -> 7.6.6 |
- match_flags - BGP flag value to match (0 - 65535) type: int
more...
|
Supported Version Ranges |
| match_flags |
v6.0.0 -> v6.4.4 |
- match_interface - Match interface configuration. Source system.interface.name. type: str
more...
|
Supported Version Ranges |
| match_interface |
v6.0.0 -> 7.6.6 |
- match_ip_address - Match IP address permitted by access-list or prefix-list. Source router.access-list.name router.prefix-list.name. type: str
more...
|
Supported Version Ranges |
| match_ip_address |
v6.0.0 -> 7.6.6 |
- match_ip_nexthop - Match next hop IP address passed by access-list or prefix-list. Source router.access-list.name router.prefix-list.name. type: str
more...
|
Supported Version Ranges |
| match_ip_nexthop |
v6.0.0 -> 7.6.6 |
- match_ip6_address - Match IPv6 address permitted by access-list6 or prefix-list6. Source router.access-list6.name router.prefix-list6.name. type: str
more...
|
Supported Version Ranges |
| match_ip6_address |
v6.0.0 -> 7.6.6 |
- match_ip6_nexthop - Match next hop IPv6 address passed by access-list6 or prefix-list6. Source router.access-list6.name router.prefix-list6.name. type: str
more...
|
Supported Version Ranges |
| match_ip6_nexthop |
v6.0.0 -> 7.6.6 |
- match_metric - Match metric for redistribute routes. type: int
more...
|
Supported Version Ranges |
| match_metric |
v6.0.0 -> 7.6.6 |
- match_origin - Match BGP origin code. type: str choices: none, egp, igp, incomplete
more...
|
Supported Version Ranges |
| match_origin |
v6.0.0 -> 7.6.6 |
| [none] |
v6.0.0 -> 7.6.6 |
| [egp] |
v6.0.0 -> 7.6.6 |
| [igp] |
v6.0.0 -> 7.6.6 |
| [incomplete] |
v6.0.0 -> 7.6.6 |
- match_route_type - Match route type. type: str choices: external-type1, external-type2, none, 1, 2
more...
|
Supported Version Ranges |
| match_route_type |
v6.0.0 -> 7.6.6 |
| [external-type1] |
v7.0.0 -> 7.6.6 |
| [external-type2] |
v7.0.0 -> 7.6.6 |
| [none] |
v6.0.0 -> 7.6.6 |
| [1] |
v6.0.0 -> v6.4.4 |
| [2] |
v6.0.0 -> v6.4.4 |
- match_suppress - Enable/disable matching of suppressed original neighbor. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| match_suppress |
v7.6.5 -> 7.6.6 |
| [enable] |
v7.6.5 -> 7.6.6 |
| [disable] |
v7.6.5 -> 7.6.6 |
- match_tag - Match tag. type: int
more...
|
Supported Version Ranges |
| match_tag |
v6.0.0 -> 7.6.6 |
- match_vrf - Match VRF ID. type: int
more...
|
Supported Version Ranges |
| match_vrf |
v6.4.0 -> 7.6.6 |
- set_aggregator_as - BGP aggregator AS. type: int
more...
|
Supported Version Ranges |
| set_aggregator_as |
v6.0.0 -> 7.6.6 |
- set_aggregator_ip - BGP aggregator IP. type: str
more...
|
Supported Version Ranges |
| set_aggregator_ip |
v6.0.0 -> 7.6.6 |
- set_aspath - Prepend BGP AS path attribute. type: list member_path: rule:id/set_aspath:as
more...
| Supported Version Ranges |
| set_aspath |
v6.0.0 -> 7.6.6 |
- as - AS number (0 - 4294967295). Use quotes for repeating numbers, For example, "1 1 2". type: str required: true
more...
|
Supported Version Ranges |
| as |
v6.0.0 -> 7.6.6 |
- set_aspath_action - Specify preferred action of set-aspath. type: str choices: prepend, replace
more...
|
Supported Version Ranges |
| set_aspath_action |
v6.0.0 -> 7.6.6 |
| [prepend] |
v6.0.0 -> 7.6.6 |
| [replace] |
v6.0.0 -> 7.6.6 |
- set_atomic_aggregate - Enable/disable BGP atomic aggregate attribute. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| set_atomic_aggregate |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
- set_community - BGP community attribute. type: list member_path: rule:id/set_community:community
more...
| Supported Version Ranges |
| set_community |
v6.0.0 -> 7.6.6 |
- community - Attribute: AA|AA:NN|internet|local-AS|no-advertise|no-export (exact match required for well known communities). type: str required: true
more...
|
Supported Version Ranges |
| community |
v6.0.0 -> 7.6.6 |
- set_community_additive - Enable/disable adding set-community to existing community. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| set_community_additive |
v6.0.0 -> 7.6.6 |
| [enable] |
v6.0.0 -> 7.6.6 |
| [disable] |
v6.0.0 -> 7.6.6 |
- set_community_delete - Delete communities matching community list. Source router.community-list.name. type: str
more...
|
Supported Version Ranges |
| set_community_delete |
v6.0.0 -> 7.6.6 |
- set_dampening_max_suppress - Maximum duration to suppress a route (1 - 255 min, 0 = unset). type: int
more...
|
Supported Version Ranges |
| set_dampening_max_suppress |
v6.0.0 -> 7.6.6 |
- set_dampening_reachability_half_life - Reachability half-life time for the penalty (1 - 45 min, 0 = unset). type: int
more...
|
Supported Version Ranges |
| set_dampening_reachability_half_life |
v6.0.0 -> 7.6.6 |
- set_dampening_reuse - Value to start reusing a route (1 - 20000, 0 = unset). type: int
more...
|
Supported Version Ranges |
| set_dampening_reuse |
v6.0.0 -> 7.6.6 |
- set_dampening_suppress - Value to start suppressing a route (1 - 20000, 0 = unset). type: int
more...
|
Supported Version Ranges |
| set_dampening_suppress |
v6.0.0 -> 7.6.6 |
- set_dampening_unreachability_half_life - Unreachability Half-life time for the penalty (1 - 45 min, 0 = unset). type: int
more...
|
Supported Version Ranges |
| set_dampening_unreachability_half_life |
v6.0.0 -> 7.6.6 |
- set_extcommunity_rt - Route Target extended community. type: list member_path: rule:id/set_extcommunity_rt:community
more...
| Supported Version Ranges |
| set_extcommunity_rt |
v6.0.0 -> 7.6.6 |
- community - AA:NN. type: str required: true
more...
|
Supported Version Ranges |
| community |
v6.0.0 -> 7.6.6 |
- set_extcommunity_soo - Site-of-Origin extended community. type: list member_path: rule:id/set_extcommunity_soo:community
more...
| Supported Version Ranges |
| set_extcommunity_soo |
v6.0.0 -> 7.6.6 |
- community - Community (format = AA:NN). type: str required: true
more...
|
Supported Version Ranges |
| community |
v6.0.0 -> 7.6.6 |
- set_flags - BGP flags value (0 - 65535) type: int
more...
|
Supported Version Ranges |
| set_flags |
v6.0.0 -> v6.4.4 |
- set_ip_nexthop - IP address of next hop. type: str
more...
|
Supported Version Ranges |
| set_ip_nexthop |
v6.0.0 -> 7.6.6 |
- set_ip_prefsrc - IP address of preferred source. type: str
more...
|
Supported Version Ranges |
| set_ip_prefsrc |
v7.4.0 -> 7.6.6 |
- set_ip6_nexthop - IPv6 global address of next hop. type: str
more...
|
Supported Version Ranges |
| set_ip6_nexthop |
v6.0.0 -> 7.6.6 |
- set_ip6_nexthop_local - IPv6 local address of next hop. type: str
more...
|
Supported Version Ranges |
| set_ip6_nexthop_local |
v6.0.0 -> 7.6.6 |
- set_local_preference - BGP local preference path attribute. type: int
more...
|
Supported Version Ranges |
| set_local_preference |
v6.0.0 -> 7.6.6 |
- set_metric - Metric value. type: int
more...
|
Supported Version Ranges |
| set_metric |
v6.0.0 -> 7.6.6 |
- set_metric_type - Metric type. type: str choices: external-type1, external-type2, none, 1, 2
more...
|
Supported Version Ranges |
| set_metric_type |
v6.0.0 -> 7.6.6 |
| [external-type1] |
v7.0.0 -> 7.6.6 |
| [external-type2] |
v7.0.0 -> 7.6.6 |
| [none] |
v6.0.0 -> 7.6.6 |
| [1] |
v6.0.0 -> v6.4.4 |
| [2] |
v6.0.0 -> v6.4.4 |
- set_origin - BGP origin code. type: str choices: none, egp, igp, incomplete
more...
|
Supported Version Ranges |
| set_origin |
v6.0.0 -> 7.6.6 |
| [none] |
v6.0.0 -> 7.6.6 |
| [egp] |
v6.0.0 -> 7.6.6 |
| [igp] |
v6.0.0 -> 7.6.6 |
| [incomplete] |
v6.0.0 -> 7.6.6 |
- set_originator_id - BGP originator ID attribute. type: str
more...
|
Supported Version Ranges |
| set_originator_id |
v6.0.0 -> 7.6.6 |
- set_priority - Priority for routing table. type: int
more...
|
Supported Version Ranges |
| set_priority |
v7.2.0 -> 7.6.6 |
- set_route_tag - Route tag for routing table. type: int
more...
|
Supported Version Ranges |
| set_route_tag |
v6.0.0 -> 7.6.6 |
- set_tag - Tag value. type: int
more...
|
Supported Version Ranges |
| set_tag |
v6.0.0 -> 7.6.6 |
- set_vpnv4_nexthop - IP address of VPNv4 next-hop. type: str
more...
|
Supported Version Ranges |
| set_vpnv4_nexthop |
v7.4.1 -> 7.6.6 |
- set_vpnv6_nexthop - IPv6 global address of VPNv6 next-hop. type: str
more...
|
Supported Version Ranges |
| set_vpnv6_nexthop |
v7.4.2 -> 7.6.6 |
- set_vpnv6_nexthop_local - IPv6 link-local address of VPNv6 next-hop. type: str
more...
|
Supported Version Ranges |
| set_vpnv6_nexthop_local |
v7.4.2 -> 7.6.6 |
- set_weight - BGP weight for routing table. type: int
more...
|
Supported Version Ranges |
| set_weight |
v6.0.0 -> 7.6.6 |
Notes
-----
.. note::
- Legacy fortiosapi has been deprecated, httpapi is the preferred way to run playbooks
- The module supports check_mode.
Examples
--------
.. code-block:: yaml+jinja
- name: Configure route maps.
fortinet.fortios.fortios_router_route_map:
vdom: "{{ vdom }}"
state: "present"
access_token: ""
router_route_map:
comments: ""
name: "default_name_4"
rule:
-
action: "permit"
id: "7"
match_as_path: " (source router.aspath-list.name)"
match_community: " (source router.community-list.name)"
match_community_exact: "enable"
match_extcommunity: " (source router.extcommunity-list.name)"
match_extcommunity_exact: "enable"
match_flags: "32767"
match_interface: " (source system.interface.name)"
match_ip_address: " (source router.access-list.name router.prefix-list.name)"
match_ip_nexthop: " (source router.access-list.name router.prefix-list.name)"
match_ip6_address: " (source router.access-list6.name router.prefix-list6.name)"
match_ip6_nexthop: " (source router.access-list6.name router.prefix-list6.name)"
match_metric: ""
match_origin: "none"
match_route_type: "external-type1"
match_suppress: "enable"
match_tag: ""
match_vrf: ""
set_aggregator_as: "0"
set_aggregator_ip: ""
set_aspath:
-
as: ""
set_aspath_action: "prepend"
set_atomic_aggregate: "enable"
set_community:
-
community: ""
set_community_additive: "enable"
set_community_delete: " (source router.community-list.name)"
set_dampening_max_suppress: "0"
set_dampening_reachability_half_life: "0"
set_dampening_reuse: "0"
set_dampening_suppress: "0"
set_dampening_unreachability_half_life: "0"
set_extcommunity_rt:
-
community: ""
set_extcommunity_soo:
-
community: ""
set_flags: "32767"
set_ip_nexthop: ""
set_ip_prefsrc: ""
set_ip6_nexthop: ""
set_ip6_nexthop_local: ""
set_local_preference: ""
set_metric: ""
set_metric_type: "external-type1"
set_origin: "none"
set_originator_id: ""
set_priority: ""
set_route_tag: ""
set_tag: ""
set_vpnv4_nexthop: ""
set_vpnv6_nexthop: ""
set_vpnv6_nexthop_local: ""
set_weight: ""
Return Values
-------------
Common return values are documented: https://docs.ansible.com/ansible/latest/reference_appendices/common_return_values.html#common-return-values, the following are the fields unique to this module:
.. raw:: html
- build - Build number of the fortigate image returned: always type: str sample: 1547
- http_method - Last method used to provision the content into FortiGate returned: always type: str sample: PUT
- http_status - Last result given by FortiGate on last operation applied returned: always type: str sample: 200
- mkey - Master key (id) used in the last call to FortiGate returned: success type: str sample: id
- name - Name of the table used to fulfill the request returned: always type: str sample: urlfilter
- path - Path of the table used to fulfill the request returned: always type: str sample: webfilter
- revision - Internal revision number returned: always type: str sample: 17.0.2.10658
- serial - Serial number of the unit returned: always type: str sample: FGVMEVYYQT3AB5352
- status - Indication of the operation's result returned: always type: str sample: success
- vdom - Virtual domain used returned: always type: str sample: root
- version - Version of the FortiGate returned: always type: str sample: v5.6.3
Status
------
- This module is not guaranteed to have a backwards compatible interface.
Authors
-------
- Link Zheng (@chillancezen)
- Jie Xue (@JieX19)
- Hongbin Lu (@fgtdev-hblu)
- Frank Shen (@frankshen01)
- Miguel Angel Munoz (@mamunozgonzalez)
- Nicolas Thomas (@thomnico)
.. hint::
If you notice any issues in this documentation, you can create a pull request to improve it.