модуль fortinet.fortimanager.fmgr_wanprof_system_virtualwanlink — настройка резервных интернет-подключений с помощью SD-WAN
Примечание
Этот модуль входит в коллекцию fortinet.fortimanager (версия 2.14.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install fortinet.fortimanager.
Чтобы использовать коллекцию в плейбуке, укажите: fortinet.fortimanager.fmgr_wanprof_system_virtualwanlink.
Добавлено в fortinet.fortimanager 2.0.0
Обзор
- Этот модуль позволяет настраивать устройство FortiManager.
- Примеры содержат все параметры и значения, которые необходимо скорректировать с учетом источников данных перед использованием.
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Токен для доступа к FortiManager без использования имени пользователя и пароля. |
adom string / обязательный | Параметр (adom) в запрошенном URL. |
bypass_validation boolean | Устанавливайте значение True только в том случае, если схема модуля отличается от структуры API FortiManager. Модуль продолжит выполнение без проверки параметров. Варианты:
|
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
forticloud_access_token string | Аутентификация клиента Ansible с помощью токена доступа к API FortiCloud. |
proposed_method string | Переопределяемый метод для базового запроса Json RPC. Варианты:
|
rc_failed list / elements=integer | Список кодов rc, для которых переопределяются условия сбоя. |
rc_succeeded list / elements=integer | Список кодов rc, для которых переопределяются условия успешного выполнения. |
wanprof string / обязательный | Параметр (wanprof) в запрошенном URL. |
wanprof_system_virtualwanlink dictionary | Параметры верхнего уровня. |
|
fail_alert_interfaces псевдонимы: fail-alert-interfaces any |
(список) Физические интерфейсы, о проблемах с которыми будут отправляться оповещения. |
|
fail_detect псевдонимы: fail-detect string |
Включить или отключить проверку состояния интернет-соединения SD-WAN Варианты:
|
|
health_check псевдонимы: health-check list / elements=dictionary |
Проверка работоспособности. |
|
_dynamic_server псевдонимы: _dynamic-server string |
Динамический сервер. |
|
addr_mode псевдонимы: addr-mode string |
Режим адресации Варианты:
|
|
diffservcode string |
Кодовая точка дифференцированного обслуживания |
|
dns_request_domain псевдонимы: dns-request-domain string |
Полное доменное имя, которое нужно разрешить при DNS-проверке. |
|
failtime integer |
Количество сбоев, после которого сервер считается недоступным |
|
ha_priority псевдонимы: ha-priority integer |
Приоритет при выборе узла HA |
|
http_agent псевдонимы: http-agent string |
Строка в поле http-agent заголовка HTTP. |
|
http_get псевдонимы: http-get string |
URL для связи с сервером, если используется протокол HTTP. |
|
http_match псевдонимы: http-match string |
Ожидаемая строка ответа сервера, если используется протокол HTTP. |
|
internet_service_id псевдонимы: internet-service-id string |
Идентификатор интернет-службы. |
|
interval integer |
Интервал проверки состояния или время между попытками подключения к серверу |
|
members any |
(список или строка) Список порядковых номеров участников. |
|
name string |
Название проверки состояния или проверки работоспособности. |
|
packet_size псевдонимы: packet-size integer |
Размер пакета в тестовом сеансе TWAMP, |
|
password any |
(список) Пароль контроллера TWAMP в режиме аутентификации |
|
port integer |
Номер порта для связи с сервером по выбранному протоколу. |
|
probe_count псевдонимы: probe-count integer |
Количество последних проб, используемых для расчета задержки и джиттера |
|
probe_packets псевдонимы: probe-packets string |
Включить или отключить передачу пробных пакетов. Варианты:
|
|
probe_timeout псевдонимы: probe-timeout integer |
Время ожидания, по истечении которого пробный пакет считается потерянным |
|
protocol string |
Протокол, используемый для проверки возможности FortiGate обмениваться данными с сервером. Варианты:
|
|
recoverytime integer |
Количество успешных ответов, после которого сервер считается восстановившим работу |
|
security_mode псевдонимы: security-mode string |
Режим безопасности контроллера TWAMP. Варианты:
|
|
server any |
(список) IP-адрес или полное доменное имя сервера. |
|
sla list / elements=dictionary |
Параметры SLA. |
|
id integer |
Идентификатор SLA. |
|
jitter_threshold псевдонимы: jitter-threshold integer |
Порог джиттера для принятия решений по SLA, в миллисекундах. |
|
latency_threshold псевдонимы: latency-threshold integer |
Порог задержки для принятия решений по SLA, в миллисекундах. |
|
link_cost_factor псевдонимы: link-cost-factor list / elements=string |
Критерии выбора канала. Варианты:
|
|
packetloss_threshold псевдонимы: packetloss-threshold integer |
Порог потери пакетов для принятия решений по SLA, в процентах. |
|
sla_fail_log_period псевдонимы: sla-fail-log-period integer |
Интервал в секундах, с которым создаются сообщения журнала о сбое SLA |
|
sla_pass_log_period псевдонимы: sla-pass-log-period integer |
Интервал в секундах, с которым создаются сообщения журнала об успешном прохождении SLA |
|
system_dns псевдонимы: system-dns string |
Включить или отключить использование системного DNS-сервера для проб. Варианты:
|
|
threshold_alert_jitter псевдонимы: threshold-alert-jitter integer |
Порог оповещения для джиттера |
|
threshold_alert_latency псевдонимы: threshold-alert-latency integer |
Порог оповещения для задержки |
|
threshold_alert_packetloss псевдонимы: threshold-alert-packetloss integer |
Порог оповещения для потери пакетов |
|
threshold_warning_jitter псевдонимы: threshold-warning-jitter integer |
Порог предупреждения для джиттера |
|
threshold_warning_latency псевдонимы: threshold-warning-latency integer |
Порог предупреждения для задержки |
|
threshold_warning_packetloss псевдонимы: threshold-warning-packetloss integer |
Порог предупреждения для потери пакетов |
|
timeout integer |
Время ожидания ответа сервера, по истечении которого попытка подключения считается неудачной |
|
update_cascade_interface aliases: update-cascade-interface string |
Включить/отключить обновление каскадного интерфейса. Варианты:
|
|
update_static_route aliases: update-static-route string |
Включить/отключить обновление статического маршрута. Варианты:
|
|
load_balance_mode aliases: load-balance-mode string |
Алгоритм или режим балансировки интернет-трафика между участниками SD-WAN. Варианты:
|
|
members list / elements=dictionary |
Участники. |
|
_dynamic_member aliases: _dynamic-member string |
Динамический участник. |
|
comment string |
Комментарии. |
|
cost integer |
Стоимость этого интерфейса для служб в режиме SLA |
|
gateway string |
Шлюз по умолчанию для этого интерфейса. |
|
gateway6 string |
Шлюз IPv6. |
|
ingress_spillover_threshold aliases: ingress-spillover-threshold integer |
Порог входящего трафика для переключения на резервный интерфейс |
|
interface string |
Имя интерфейса. |
|
priority integer |
Приоритет интерфейса |
|
seq_num aliases: seq-num integer |
Порядковый номер |
|
source string |
Исходный IP-адрес, используемый в пакете проверки работоспособности, отправляемом серверу. |
|
source6 string |
Исходный IPv6-адрес, используемый в пакете проверки работоспособности, отправляемом серверу. |
|
spillover_threshold aliases: spillover-threshold integer |
Порог исходящего трафика для переключения на резервный интерфейс |
|
status string |
Включить/отключить этот интерфейс в SD-WAN. Варианты:
|
|
volume_ratio aliases: volume-ratio integer |
Измеренное соотношение объёмов |
|
weight integer |
Вес этого интерфейса при взвешенной балансировке нагрузки. |
|
neighbor list / elements=dictionary |
Сосед. |
|
health_check aliases: health-check string |
Имя проверки работоспособности SD-WAN. |
|
ip string |
IP-адрес соседа. |
|
member string |
Порядковый номер участника. |
|
role string |
Роль соседа. Варианты:
|
|
sla_id aliases: sla-id integer |
Идентификатор SLA. |
|
neighbor_hold_boot_time aliases: neighbor-hold-boot-time integer |
Период ожидания в секундах при переключении с основного соседа на вторичного после запуска соседа. |
|
neighbor_hold_down aliases: neighbor-hold-down string |
Включить/отключить задержку переключения со вторичного соседа на основного. Варианты:
|
|
neighbor_hold_down_time aliases: neighbor-hold-down-time integer |
Период ожидания в секундах при переключении со вторичного соседа на основного, если задержка переключения отключена. |
|
service list / elements=dictionary |
Служба. |
|
addr_mode aliases: addr-mode string |
Режим адресации Варианты:
|
|
bandwidth_weight aliases: bandwidth-weight integer |
Коэффициент обратной величины доступной двунаправленной пропускной способности в формуле custom-profile-1. |
|
default string |
Включить/отключить использование SD-WAN в качестве службы по умолчанию. Варианты:
|
|
dscp_forward aliases: dscp-forward string |
Включить/отключить тег DSCP для прямого трафика. Варианты:
|
|
dscp_forward_tag aliases: dscp-forward-tag string |
Тег DSCP для прямого трафика. |
|
dscp_reverse aliases: dscp-reverse string |
Включить/отключить тег DSCP для обратного трафика. Варианты:
|
|
dscp_reverse_tag aliases: dscp-reverse-tag string |
Тег DSCP для обратного трафика. |
|
dst any |
(список или строка) Имя адреса назначения. |
|
dst6 any |
(список или строка) Имя адреса назначения IPv6. |
|
dst_negate aliases: dst-negate string |
Включить/отключить инверсию совпадения адреса назначения. Варианты:
|
|
end_port aliases: end-port integer |
Номер конечного порта назначения. |
|
gateway string |
Включить/отключить шлюз службы SD-WAN. Варианты:
|
|
groups any |
(список или строка) Группы пользователей. |
|
health_check aliases: health-check string |
Проверка работоспособности. |
|
hold_down_time aliases: hold-down-time integer |
Период ожидания в секундах при переключении с резервного участника на основного |
|
id integer |
Идентификатор правила приоритета |
|
input_device aliases: input-device any |
(список или строка) Имя исходного интерфейса. |
|
input_device_negate aliases: input-device-negate string |
Включить/отключить инверсию совпадения входного устройства. Варианты:
|
|
internet_service aliases: internet-service string |
Включить/отключить использование интернет-службы для балансировки нагрузки на основе приложений. Варианты:
|
|
internet_service_app_ctrl aliases: internet-service-app-ctrl any |
(список) Список идентификаторов интернет-служб на основе контроля приложений. |
|
internet_service_app_ctrl_group aliases: internet-service-app-ctrl-group any |
(список или строка) Список групп интернет-служб на основе контроля приложений. |
|
internet_service_ctrl aliases: internet-service-ctrl any |
(список) Список идентификаторов интернет-служб на основе управления. |
|
internet_service_ctrl_group aliases: internet-service-ctrl-group any |
(список или строка) Список групп интернет-служб на основе управления. |
|
internet_service_custom aliases: internet-service-custom any |
(список или строка) Список имён пользовательских интернет-служб. |
|
internet_service_custom_group aliases: internet-service-custom-group any |
(список или строка) Список групп пользовательских интернет-сервисов. |
|
internet_service_group aliases: internet-service-group any |
(список или строка) Список групп интернет-сервисов. |
|
internet_service_id aliases: internet-service-id any |
(список или строка) Список идентификаторов интернет-сервисов. |
|
internet_service_name aliases: internet-service-name string |
Список названий интернет-сервисов. |
|
jitter_weight aliases: jitter-weight integer |
Коэффициент джиттера в формуле custom-profile-1. |
|
latency_weight aliases: latency-weight integer |
Коэффициент задержки в формуле custom-profile-1. |
|
link_cost_factor aliases: link-cost-factor string |
Фактор стоимости канала. Допустимые значения:
|
|
link_cost_threshold aliases: link-cost-threshold integer |
Пороговое процентное изменение значений стоимости канала, приводящее к повторному созданию маршрута политики. |
|
member string |
Порядковый номер участника. |
|
mode string |
Определяет, как правило приоритета задаёт приоритет интерфейсов в SD-WAN. Допустимые значения:
|
|
name string |
Название правила приоритета. |
|
packet_loss_weight aliases: packet-loss-weight integer |
Коэффициент потери пакетов в формуле custom-profile-1. |
|
priority_members aliases: priority-members any |
(список или строка) Список порядковых номеров участников. |
|
protocol integer |
Номер протокола. |
|
quality_link aliases: quality-link integer |
Оценка качества. |
|
role string |
Роль сервиса для взаимодействия с соседним узлом. Допустимые значения:
|
|
route_tag aliases: route-tag integer |
Тег маршрута карты маршрутов IPv4. |
|
sla list / elements=dictionary |
SLA. |
|
health_check aliases: health-check string |
Проверка работоспособности Virtual WAN Link. |
|
id integer |
Идентификатор SLA. |
|
sla_compare_method aliases: sla-compare-method string |
Метод сравнения значения SLA для режимов SLA и балансировки нагрузки. Допустимые значения:
|
|
src any |
(список или строка) Название исходного адреса. |
|
src6 any |
(список или строка) Название исходного адреса IPv6. |
|
src_negate aliases: src-negate string |
Включить или отключить инверсию совпадения исходного адреса. Допустимые значения:
|
|
standalone_action aliases: standalone-action string |
Включить или отключить сервис, если выбранная роль соседнего узла является автономной, а роль сервиса — нет. Допустимые значения:
|
|
start_port aliases: start-port integer |
Начальный номер порта назначения. |
|
status string |
Включить или отключить сервис SD-WAN. Допустимые значения:
|
|
tos string |
Шаблон битов типа обслуживания. |
|
tos_mask aliases: tos-mask string |
Биты типа обслуживания для проверки. |
|
users any |
(список или строка) Имя пользователя. |
|
status string |
Включить или отключить SD-WAN. Допустимые значения:
|
workspace_locking_adom string | ADOM, который необходимо заблокировать для FortiManager, работающего в режиме рабочего пространства. Значением может быть global или другое значение, включая root. |
workspace_locking_timeout integer | Максимальное время ожидания в секундах, пока другой пользователь снимет блокировку рабочего пространства. По умолчанию: |
Примечания
Примечание
- Начиная с версии 2.4.0, имена всех входных аргументов соответствуют соглашению об именовании с подчёркиваниями (snake_case). Замените аргументы, например «var-name», на «var_name». Старые имена аргументов по-прежнему доступны, однако будут выдаваться предупреждения об устаревании. Чтобы отключить эти предупреждения, задайте deprecation_warnings=False в ansible.cfg.
- Этот модуль FortiManager поддерживает работу в режиме блокировки рабочего пространства; для этого используются параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout.
- Обычно выполнение модуля завершается ошибкой при возврате ненулевого значения rc. Условия завершения с ошибкой или успехом также можно переопределить с помощью параметров rc_failed и rc_succeeded.
Примеры
- name: Example playbook (generated based on argument schema)
hosts: fortimanagers
connection: httpapi
gather_facts: false
tasks:
- name: Configure redundant internet connections using SD-WAN
fortinet.fortimanager.fmgr_wanprof_system_virtualwanlink:
# workspace_locking_adom: <global or your adom name>
adom: <your own value>
wanprof: <your own value>
wanprof_system_virtualwanlink:
# fail_detect: <value in [disable, enable]>
# health_check:
# - _dynamic_server: <string>
# addr_mode: <value in [ipv4, ipv6]>
# failtime: <integer>
# http_agent: <string>
# http_get: <string>
# http_match: <string>
# interval: <integer>
# members: <list or string>
# name: <string>
# packet_size: <integer>
# password: <list or string>
# port: <integer>
# protocol: <value in [ping, tcp-echo, udp-echo, ...]>
# recoverytime: <integer>
# security_mode: <value in [none, authentication]>
# server: <list or string>
# sla:
# - id: <integer>
# jitter_threshold: <integer>
# latency_threshold: <integer>
# link_cost_factor: ["latency", "jitter", "packet-loss"]
# packetloss_threshold: <integer>
# threshold_alert_jitter: <integer>
# threshold_alert_latency: <integer>
# threshold_alert_packetloss: <integer>
# threshold_warning_jitter: <integer>
# threshold_warning_latency: <integer>
# threshold_warning_packetloss: <integer>
# update_cascade_interface: <value in [disable, enable]>
# update_static_route: <value in [disable, enable]>
# internet_service_id: <string>
# probe_packets: <value in [disable, enable]>
# sla_fail_log_period: <integer>
# sla_pass_log_period: <integer>
# timeout: <integer>
# ha_priority: <integer>
# diffservcode: <string>
# probe_timeout: <integer>
# dns_request_domain: <string>
# probe_count: <integer>
# system_dns: <value in [disable, enable]>
# load_balance_mode: <value in [source-ip-based, weight-based, usage-based, ...]>
# members:
# - _dynamic_member: <string>
# comment: <string>
# gateway: <string>
# gateway6: <string>
# ingress_spillover_threshold: <integer>
# interface: <string>
# priority: <integer>
# seq_num: <integer>
# source: <string>
# source6: <string>
# spillover_threshold: <integer>
# status: <value in [disable, enable]>
# volume_ratio: <integer>
# weight: <integer>
# cost: <integer>
# service:
# - addr_mode: <value in [ipv4, ipv6]>
# bandwidth_weight: <integer>
# default: <value in [disable, enable]>
# dscp_forward: <value in [disable, enable]>
# dscp_forward_tag: <string>
# dscp_reverse: <value in [disable, enable]>
# dscp_reverse_tag: <string>
# dst: <list or string>
# dst_negate: <value in [disable, enable]>
# dst6: <list or string>
# end_port: <integer>
# gateway: <value in [disable, enable]>
# groups: <list or string>
# health_check: <string>
# hold_down_time: <integer>
# id: <integer>
# internet_service: <value in [disable, enable]>
# internet_service_ctrl: <list or integer>
# internet_service_ctrl_group: <list or string>
# internet_service_custom: <list or string>
# internet_service_custom_group: <list or string>
# internet_service_group: <list or string>
# internet_service_id: <list or string>
# jitter_weight: <integer>
# latency_weight: <integer>
# link_cost_factor: <value in [latency, jitter, packet-loss, ...]>
# link_cost_threshold: <integer>
# member: <string>
# mode: <value in [auto, manual, priority, ...]>
# name: <string>
# packet_loss_weight: <integer>
# priority_members: <list or string>
# protocol: <integer>
# quality_link: <integer>
# route_tag: <integer>
# sla:
# - health_check: <string>
# id: <integer>
# src: <list or string>
# src_negate: <value in [disable, enable]>
# src6: <list or string>
# start_port: <integer>
# status: <value in [disable, enable]>
# tos: <string>
# tos_mask: <string>
# users: <list or string>
# internet_service_app_ctrl: <list or integer>
# internet_service_app_ctrl_group: <list or string>
# role: <value in [primary, secondary, standalone]>
# sla_compare_method: <value in [order, number]>
# standalone_action: <value in [disable, enable]>
# input_device: <list or string>
# internet_service_name: <string>
# input_device_negate: <value in [disable, enable]>
# status: <value in [disable, enable]>
# neighbor:
# - health_check: <string>
# ip: <string>
# member: <string>
# role: <value in [primary, secondary, standalone]>
# sla_id: <integer>
# neighbor_hold_boot_time: <integer>
# neighbor_hold_down: <value in [disable, enable]>
# neighbor_hold_down_time: <integer>
# fail_alert_interfaces: <list or string>
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
meta dictionary | Результат запроса. Возвращается: всегда |
|
request_url string |
Полный URL запроса. Возвращается: всегда Пример: |
|
response_code integer |
Статус запроса API. Возвращается: всегда Пример: |
|
response_data list / elements=string |
Ответ API. Возвращается: всегда |
|
response_message string |
Текстовое описание ответа API. Возвращается: всегда Пример: |
|
system_information dictionary |
Информация о целевой системе. Возвращается: всегда |
rc integer | Статус запроса. Возвращается: всегда Пример: |
version_check_warning list / elements=string | Предупреждение о том, что используемые в сценарии параметры не поддерживаются текущей версией FortiManager. Возвращается: при наличии сложных данных |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortimanager/fmgr_wanprof_system_virtualwanlink_module.html