Модуль fortinet.fortimanager.fmgr_wanprof_system_sdwan_healthcheck – проверка состояния 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_sdwan_healthcheck.
Добавлено в fortinet.fortimanager 2.1.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, которыми будут переопределены условия успешного выполнения. |
state string / обязательный | Указание на создание, обновление или удаление объекта. Варианты:
|
wanprof string / обязательный | Параметр (wanprof) в запрошенном URL. |
wanprof_system_sdwan_healthcheck dictionary | Набор параметров верхнего уровня. |
|
_dynamic_server псевдонимы: _dynamic-server string |
Динамический сервер. |
|
addr_mode псевдонимы: addr-mode string |
Режим адресации Варианты:
|
|
agent_probe_timeout псевдонимы: agent-probe-timeout integer |
Время ожидания, прежде чем пробный пакет будет считаться потерянным, если для detect-mode задано значение agent |
|
bandwidth_weight псевдонимы: bandwidth-weight integer |
Коэффициент обратной величины доступной двунаправленной пропускной способности в формуле custom-profile-1. |
|
class_id псевдонимы: class-id string |
Идентификатор класса трафика. |
|
detect_mode псевдонимы: detect-mode string |
Режим определения сервера. Варианты:
|
|
diffservcode string |
Кодовая точка дифференцированного обслуживания |
|
dns_match_ip псевдонимы: dns-match-ip string |
Ожидаемый IP-адрес в ответе DNS-сервера, если используется протокол DNS. |
|
dns_request_domain псевдонимы: dns-request-domain string |
Полное доменное имя для разрешения при DNS-проверке. |
|
embed_measured_health псевдонимы: embed-measured-health string |
Включить/отключить встраивание сведений об измеренном состоянии. Варианты:
|
|
failtime integer |
Количество сбоев, после которого сервер считается недоступным |
|
fortiguard string |
Включить/отключить использование предопределенного сервера FortiGuard. Варианты:
|
|
fortiguard_name псевдонимы: fortiguard-name any |
(список) Имя предопределенной цели проверки состояния. |
|
ftp_file псевдонимы: ftp-file string |
Полный путь и имя файла на FTP-сервере для загрузки при проверке состояния FTP. |
|
ftp_mode псевдонимы: ftp-mode string |
Режим FTP. Варианты:
|
|
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. |
|
interval integer |
Интервал проверки состояния в миллисекундах или время между попытками подключения к серверу |
|
jitter_weight псевдонимы: jitter-weight integer |
Коэффициент джиттера в формуле custom-profile-1. |
|
latency_weight псевдонимы: latency-weight integer |
Коэффициент задержки в формуле custom-profile-1. |
|
members any |
(список или строка) Список порядковых номеров участников. |
|
mos_codec псевдонимы: mos-codec string |
Кодек для расчета MOS Варианты:
|
|
name string / обязательный |
Имя проверки состояния или проверки работоспособности. |
|
packet_loss_weight псевдонимы: packet-loss-weight integer |
Коэффициент потери пакетов в формуле custom-profile-1. |
|
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 с сервером. Варианты:
|
|
quality_measured_method псевдонимы: quality-measured-method string |
Метод измерения качества tcp-connect. Варианты:
|
|
recoverytime integer |
Количество успешных ответов, после которого сервер считается восстановившимся |
|
remote_probe_timeout псевдонимы: remote-probe-timeout integer |
Время ожидания, прежде чем пробный пакет будет считаться потерянным, если для detect-mode задано значение remote |
|
security_mode псевдонимы: security-mode string |
Режим безопасности контроллера twamp. Варианты:
|
|
server any |
(список) IP-адрес или полное доменное имя сервера. |
|
sla list / elements=dictionary |
SLA. |
|
custom_profile_threshold псевдонимы: custom-profile-threshold integer |
Порог пользовательского профиля для отметки SLA как выполненного |
|
id integer |
Идентификатор SLA. |
|
jitter_threshold aliases: jitter-threshold integer |
Джиттер для принятия решения по SLA, в миллисекундах. |
|
latency_threshold aliases: latency-threshold integer |
Задержка для принятия решения по SLA, в миллисекундах. |
|
link_cost_factor aliases: link-cost-factor list / elements=string |
Критерии, используемые для выбора канала. Варианты:
|
|
mos_threshold aliases: mos-threshold string |
Минимальная оценка качества передачи речи (MOS), при которой SLA считается выполненным. |
|
packetloss_threshold aliases: packetloss-threshold integer |
Потери пакетов для принятия решения по SLA, в процентах. |
|
priority_in_sla aliases: priority-in-sla integer |
Значение, добавляемое в таблицу маршрутизации при выполнении SLA |
|
priority_out_sla aliases: priority-out-sla integer |
Значение, добавляемое в таблицу маршрутизации при невыполнении SLA |
|
sla_fail_log_period aliases: sla-fail-log-period integer |
Интервал в секундах, с которым будут создаваться сообщения журнала о невыполнении SLA |
|
sla_id_redistribute aliases: sla-id-redistribute integer |
Выберите идентификатор из подтаблицы SLA. |
|
sla_pass_log_period aliases: sla-pass-log-period integer |
Интервал в секундах, с которым будут создаваться сообщения журнала о выполнении SLA |
|
source string |
Исходный IP-адрес, используемый в пакете проверки работоспособности, отправляемом на сервер. |
|
source6 string |
Исходный IPv6-адрес, используемый в пакете проверки работоспособности, отправляемом на сервер. |
|
system_dns aliases: system-dns string |
Включить или отключить использование системного DNS в качестве сервера проверки. Варианты:
|
|
threshold_alert_jitter aliases: threshold-alert-jitter integer |
Пороговое значение джиттера для оповещения |
|
threshold_alert_latency aliases: threshold-alert-latency integer |
Пороговое значение задержки для оповещения |
|
threshold_alert_packetloss aliases: threshold-alert-packetloss integer |
Пороговое значение потерь пакетов для оповещения |
|
threshold_warning_jitter aliases: threshold-warning-jitter integer |
Пороговое значение джиттера для предупреждения |
|
threshold_warning_latency aliases: threshold-warning-latency integer |
Пороговое значение задержки для предупреждения |
|
threshold_warning_packetloss aliases: threshold-warning-packetloss integer |
Пороговое значение потерь пакетов для предупреждения |
|
update_bgp_route aliases: update-bgp-route string |
Включить или отключить обновление маршрута BGP. Варианты:
|
|
update_cascade_interface aliases: update-cascade-interface string |
Включить или отключить обновление каскадного интерфейса. Варианты:
|
|
update_static_route aliases: update-static-route string |
Включить или отключить обновление статического маршрута. Варианты:
|
|
user string |
Имя пользователя для доступа к серверу проверки. |
|
vrf integer |
Идентификатор виртуальной маршрутизации и пересылки (VRF). |
workspace_locking_adom string | ADOM, который необходимо заблокировать для FortiManager, работающего в режиме рабочей области; в качестве значения можно указать global и другие ADOM, включая 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
- Для создания или обновления объекта используйте директиву state present.
- Для удаления объекта используйте директиву state absent.
Примеры
- name: Example playbook (generated based on argument schema)
hosts: fortimanagers
connection: httpapi
gather_facts: false
tasks:
- name: SD-WAN status checking or health checking.
fortinet.fortimanager.fmgr_wanprof_system_sdwan_healthcheck:
# workspace_locking_adom: <global or your adom name>
adom: <your own value>
wanprof: <your own value>
state: present # <value in [present, absent]>
wanprof_system_sdwan_healthcheck:
name: "your value" # Required variable, string
# _dynamic_server: <string>
# addr_mode: <value in [ipv4, ipv6]>
# diffservcode: <string>
# dns_match_ip: <string>
# dns_request_domain: <string>
# failtime: <integer>
# ftp_file: <string>
# ftp_mode: <value in [passive, port]>
# ha_priority: <integer>
# http_agent: <string>
# http_get: <string>
# http_match: <string>
# interval: <integer>
# members: <list or string>
# packet_size: <integer>
# password: <list or string>
# port: <integer>
# probe_count: <integer>
# probe_packets: <value in [disable, enable]>
# probe_timeout: <integer>
# protocol: <value in [ping, tcp-echo, udp-echo, ...]>
# quality_measured_method: <value in [half-close, half-open]>
# 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", "mos", "remote",
# "custom-profile-1"]
# packetloss_threshold: <integer>
# mos_threshold: <string>
# priority_in_sla: <integer>
# priority_out_sla: <integer>
# custom_profile_threshold: <integer>
# sla_fail_log_period: <integer>
# sla_pass_log_period: <integer>
# system_dns: <value in [disable, enable]>
# 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]>
# user: <string>
# detect_mode: <value in [active, passive, prefer-passive, ...]>
# mos_codec: <value in [g711, g722, g729]>
# source: <string>
# vrf: <integer>
# embed_measured_health: <value in [disable, enable]>
# sla_id_redistribute: <integer>
# class_id: <string>
# source6: <string>
# fortiguard: <value in [disable, enable]>
# fortiguard_name: <list or string>
# agent_probe_timeout: <integer>
# remote_probe_timeout: <integer>
# bandwidth_weight: <integer>
# jitter_weight: <integer>
# latency_weight: <integer>
# packet_loss_weight: <integer>
# update_bgp_route: <value in [disable, enable]>
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
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_sdwan_healthcheck_module.html