fortinet.fortimanager.fmgr_wtpprofile_radio3 модуль — Параметры конфигурации радио 3.

Примечание

Этот модуль входит в коллекцию fortinet.fortimanager (версия 2.7.0).

Вы, возможно, уже установили эту коллекцию, если используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install fortinet.fortimanager.

Для использования в плейбуке укажите: fortinet.fortimanager.fmgr_wtpprofile_radio3.

Добавлен в fortinet.fortimanager 2.1.0

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Этот модуль позволяет настроить устройство FortiManager.
Примеры включают все параметры и значения, которые необходимо скорректировать в источниках данных перед использованием.

Параметры

Параметр	Комментарии
access_token строка	Токен для доступа к FortiManager без использования имени пользователя и пароля.
adom строка / обязательно	Параметр (adom) в запрошенном URL.
bypass_validation логическое значение	Устанавливается в значение True только тогда, когда схема модуля отличается от структуры API FortiManager, модуль продолжает выполнение без проверки параметров. Варианты: `false` ← (по умолчанию) `true`
enable_log логическое значение	Включить/выключить ведение журнала для задачи. Варианты: `false` ← (по умолчанию) `true`
forticloud_access_token строка	Аутентифицировать клиент Ansible с помощью токена доступа к API forticloud.
proposed_method строка	Переопределенный метод для основного запроса Json RPC. Варианты: `"update"` `"set"` `"add"`
rc_failed список / элементы=целое число	Список кодов rc, с помощью которых будут переопределены условия для завершения работы с ошибкой.
rc_succeeded список / элементы=целое число	Список кодов rc, с помощью которых будут переопределены условия для успешного завершения.
workspace_locking_adom строка	ADOM для блокировки FortiManager, работающего в режиме рабочего пространства; значение может быть глобальным и другими, включая root.
workspace_locking_timeout целое число	Максимальное время в секундах ожидания, пока другой пользователь не разблокирует рабочее пространство. По умолчанию: `300`
wtp-profile строка	Устарело, используйте «wtp_profile»
wtp_profile строка	Параметр (wtp-profile) в запрошенном URL.
wtpprofile_radio3 словарь	Настроены параметры верхнего уровня.
80211d строка	Устарело, переименуйте на d80211d. Включить/выключить 802. Варианты: `"disable"` `"enable"`
80211mc строка	Устарело, переименуйте на d80211mc. Включить/выключить 802. Варианты: `"disable"` `"enable"`
airtime-fairness строка	Устарело, переименуйте на airtime_fairness. Включить/выключить справедливость времени эфира. Варианты: `"disable"` `"enable"`
amsdu строка	Включить/выключить 802. Варианты: `"disable"` `"enable"`
ap-handoff строка	Устарело, переименуйте на ap_handoff. Включить/выключить передачу клиентов между точками доступа. Варианты: `"disable"` `"enable"`
ap-sniffer-addr строка	Устарело, переименуйте на ap_sniffer_addr. MAC-адрес для мониторинга.
ap-sniffer-bufsize целое число	Устарело, переименуйте на ap_sniffer_bufsize. Размер буфера анализатора.
ap-sniffer-chan целое число	Устарело, переименуйте на ap_sniffer_chan. Канал для работы анализатора.

ap-sniffer-chan-width string	Устаревшее, пожалуйста, переименуйте на ap_sniffer_chan_width. Ширина канала для анализатора. Варианты: `"320MHz"` `"240MHz"` `"160MHz"` `"80MHz"` `"40MHz"` `"20MHz"`
ap-sniffer-ctl string	Устаревшее, пожалуйста, переименуйте на ap_sniffer_ctl. Включить/выключить анализатор на кадрах управления Wi-Fi. Варианты: `"disable"` `"enable"`
ap-sniffer-data string	Устаревшее, пожалуйста, переименуйте на ap_sniffer_data. Включить/выключить анализатор на кадрах данных Wi-Fi. Варианты: `"disable"` `"enable"`
ap-sniffer-mgmt-beacon string	Устаревшее, пожалуйста, переименуйте на ap_sniffer_mgmt_beacon. Включить/выключить анализатор на управляющих кадрах Wi-Fi Beacon. Варианты: `"disable"` `"enable"`
ap-sniffer-mgmt-other string	Устаревшее, пожалуйста, переименуйте на ap_sniffer_mgmt_other. Включить/выключить анализатор на других управляющих кадрах Wi-Fi. Варианты: `"disable"` `"enable"`
ap-sniffer-mgmt-probe string	Устаревшее, пожалуйста, переименуйте на ap_sniffer_mgmt_probe. Включить/выключить анализатор на кадрах зондирования Wi-Fi. Варианты: `"disable"` `"enable"`
arrp-profile string	Устаревшее, пожалуйста, переименуйте на arrp_profile. Распределённое автоматическое предоставление радиоресурсов.
auto-power-high integer	Устаревшее, пожалуйста, переименуйте на auto_power_high. Верхняя граница автоматической регулировки мощности передачи в дБм.
auto-power-level string	Устаревшее, пожалуйста, переименуйте на auto_power_level. Включить/выключить автоматическую регулировку уровня мощности для предотвращения помех в… Варианты: `"disable"` `"enable"`
auto-power-low integer	Устаревшее, пожалуйста, переименуйте на auto_power_low. Нижняя граница автоматической регулировки мощности передачи в дБм.
auto-power-target string	Устаревшее, пожалуйста, переименуйте на auto_power_target. Цель автоматической регулировки мощности передачи в дБм.
band string	Диапазон Wi-Fi, в котором работает Radio 3. Варианты: `"802.11b"` `"802.11a"` `"802.11g"` `"802.11n"` `"802.11ac"` `"802.11n-5G"` `"802.11ax-5G"` `"802.11ax"` `"802.11g-only"` `"802.11n-only"` `"802.11n,g-only"` `"802.11ac-only"` `"802.11ac,n-only"` `"802.11n-5G-only"` `"802.11ax-5G-only"` `"802.11ax,ac-only"` `"802.11ax,ac,n-only"` `"802.11ax-only"` `"802.11ax,n-only"` `"802.11ax,n,g-only"` `"802.11ac-2G"` `"802.11ax-6G"` `"802.11n-2G"` `"802.11ac-5G"` `"802.11ax-2G"` `"802.11be-2G"` `"802.11be-5G"` `"802.11be-6G"`
band-5g-type string	Устаревшее, пожалуйста, переименуйте на band_5g_type. Тип диапазона Wi-Fi 5G. Варианты: `"5g-full"` `"5g-high"` `"5g-low"`
bandwidth-admission-control string	Устаревшее, пожалуйста, переименуйте на bandwidth_admission_control. Включить/выключить мультимедиа Wi-Fi. Варианты: `"disable"` `"enable"`
bandwidth-capacity integer	Устаревшее, пожалуйста, переименуйте на bandwidth_capacity. Максимальная пропускная способность.
beacon-interval integer	Устаревшее, пожалуйста, переименуйте на beacon_interval. Интервал маяка.
bss-color integer	Устаревшее, пожалуйста, переименуйте на bss_color. Значение цвета BSS для этого радио 11ax.

bss-color-mode string	Устарело, переименуйте в bss_color_mode. Режим цвета BSS для этого радио 11ax Варианты: `"auto"` `"static"`
call-admission-control string	Устарело, переименуйте в call_admission_control. Включить/выключить WiFi мультимедиа Варианты: `"disable"` `"enable"`
call-capacity integer	Устарело, переименуйте в call_capacity. Максимальное количество Voice over WLAN
channel any	(список) Выбранный список каналов беспроводной радиосвязи.
channel-bonding string	Устарело, переименуйте в channel_bonding. Пропускная способность канала Варианты: `"80MHz"` `"40MHz"` `"20MHz"` `"160MHz"` `"320MHz"` `"240MHz"`
channel-bonding-ext string	Устарело, переименуйте в channel_bonding_ext. Расширение полосы пропускания канала Варианты: `"320MHz-1"` `"320MHz-2"`
channel-utilization string	Устарело, переименуйте в channel_utilization. Включить/выключить измерение использования канала. Варианты: `"disable"` `"enable"`
coexistence string	Включить/выключить разрешение HT20 и HT40 на одном радио Варианты: `"disable"` `"enable"`
darrp string	Включить/выключить Распределенное автоматическое предоставление радиоресурсов Варианты: `"disable"` `"enable"`
drma string	Включить/выключить динамическое назначение режима радио Варианты: `"disable"` `"enable"`
drma-sensitivity string	Устарело, переименуйте в drma_sensitivity. Коэффициент покрытия сети Варианты: `"low"` `"medium"` `"high"`
dtim integer	Карта индикации передачи трафика
frag-threshold integer	Устарело, переименуйте в frag_threshold. Максимальный размер пакета, который может быть отправлен без фрагментации
frequency-handoff string	Устарело, переименуйте в frequency_handoff. Включить/выключить переключение частоты клиентов на другие каналы Варианты: `"disable"` `"enable"`
iperf-protocol string	Устарело, переименуйте в iperf_protocol. Протокол тестирования Iperf Варианты: `"udp"` `"tcp"`
iperf-server-port integer	Устарело, переименуйте в iperf_server_port. Номер порта службы Iperf.
max-clients integer	Устарело, переименуйте в max_clients. Максимальное количество станций
max-distance integer	Устарело, переименуйте в max_distance. Максимальное ожидаемое расстояние между точкой доступа и клиентами
mimo-mode string	Устарело, переименуйте в mimo_mode. Настроить режим MIMO радио Варианты: `"default"` `"1x1"` `"2x2"` `"3x3"` `"4x4"` `"8x8"`

mode string	Режим радио 3. Choices: `"disabled"` `"ap"` `"monitor"` `"sniffer"` `"sam"`
optional-antenna string	Устарело, переименуйте в optional_antenna. Дополнительная антенна, используемая на FAP Choices: `"none"` `"FANT-04ABGN-0606-O-N"` `"FANT-04ABGN-1414-P-N"` `"FANT-04ABGN-8065-P-N"` `"FANT-04ABGN-0606-O-R"` `"FANT-04ABGN-0606-P-R"` `"FANT-10ACAX-1213-D-N"` `"FANT-08ABGN-1213-D-R"` `"custom"`
optional-antenna-gain string	Устарело, переименуйте в optional_antenna_gain. Усиление дополнительной антенны в дБи
power-level integer	Устарело, переименуйте в power_level. Уровень мощности радио как процент от максимальной передаваемой мощности
power-mode string	Устарело, переименуйте в power_mode. Установите эффективную изотропную излучаемую мощность радио Choices: `"dBm"` `"percentage"`
power-value integer	Устарело, переименуйте в power_value. Мощность EIRP радио в дБм
powersave-optimize list / elements=string	Устарело, переименуйте в powersave_optimize. Включите функции энергосбережения клиента, такие как TIM, AC VO и OBSS и т.д. Choices: `"tim"` `"ac-vo"` `"no-obss-scan"` `"no-11b-rate"` `"client-rate-follow"`
protection-mode string	Устарело, переименуйте в protection_mode. Включить/выключить 802. Choices: `"rtscts"` `"ctsonly"` `"disable"`
radio-id integer	Устарело, переименуйте в radio_id. Идентификатор радио.
rts-threshold integer	Устарело, переименуйте в rts_threshold. Максимальный размер пакета для RTS-передач, указывающий максимальный размер...
sam-bssid string	Устарело, переименуйте в sam_bssid. BSSID для сети WiFi.
sam-ca-certificate string	Устарело, переименуйте в sam_ca_certificate. Сертификат CA для WPA2/WPA3-ENTERPRISE.
sam-captive-portal string	Устарело, переименуйте в sam_captive_portal. Включить/выключить аутентификацию Captive Portal Choices: `"disable"` `"enable"`
sam-client-certificate string	Устарело, переименуйте в sam_client_certificate. Клиентский сертификат для WPA2/WPA3-ENTERPRISE.
sam-cwp-failure-string string	Устарело, переименуйте в sam_cwp_failure_string. Идентификация ошибки на странице после неправильного входа.
sam-cwp-match-string string	Устарело, переименуйте в sam_cwp_match_string. Идентификационная строка из формы входа в портал Captive Portal.
sam-cwp-password any	(list) Устарело, переименуйте в sam_cwp_password. Пароль для аутентификации Captive Portal.
sam-cwp-success-string string	Устарело, переименуйте в sam_cwp_success_string. Идентификация успешного входа на странице после успешного входа.
sam-cwp-test-url string	Устарело, переименуйте в sam_cwp_test_url. Веб-сайт, к которому пытается получить доступ клиент.
sam-cwp-username string	Устарело, переименуйте в sam_cwp_username. Имя пользователя для аутентификации Captive Portal.

sam-eap-method string	Устарело, переименуйте в sam_eap_method. Выберите метод WPA2/WPA3-ENTERPRISE EAP Варианты: `"tls"` `"peap"` `"both"`
sam-password any	(список) Устарело, переименуйте в sam_password. Пароль для подключения к сети WiFi.
sam-private-key string	Устарело, переименуйте в sam_private_key. Закрытый ключ для WPA2/WPA3-ENTERPRISE.
sam-private-key-password any	(список) Устарело, переименуйте в sam_private_key_password. Пароль для файла закрытого ключа для WPA2/WPA3-ENTERPRISE.
sam-report-intv integer	Устарело, переименуйте в sam_report_intv. Интервал отчета SAM
sam-security-type string	Устарело, переименуйте в sam_security_type. Выберите тип безопасности сети WiFi Варианты: `"open"` `"wpa-personal"` `"wpa-enterprise"` `"owe"` `"wpa3-sae"`
sam-server string	Устарело, переименуйте в sam_server. IP-адрес или доменное имя тестового сервера SAM.
sam-server-fqdn string	Устарело, переименуйте в sam_server_fqdn. Доменное имя тестового сервера SAM.
sam-server-ip string	Устарело, переименуйте в sam_server_ip. IP-адрес тестового сервера SAM.
sam-server-type string	Устарело, переименуйте в sam_server_type. Выберите тип сервера SAM Варианты: `"ip"` `"fqdn"`
sam-ssid string	Устарело, переименуйте в sam_ssid. SSID для сети WiFi.
sam-test string	Устарело, переименуйте в sam_test. Выберите тип теста SAM Варианты: `"ping"` `"iperf"`
sam-username string	Устарело, переименуйте в sam_username. Имя пользователя для подключения к сети WiFi.
short-guard-interval string	Устарело, переименуйте в short_guard_interval. Используйте короткий интервал защиты Варианты: `"disable"` `"enable"`
spectrum-analysis string	Устарело, переименуйте в spectrum_analysis. Включить/выключить анализ спектра для поиска помех, которые могли бы отрицат… Варианты: `"disable"` `"enable"` `"scan-only"`
transmit-optimize list / elements=string	Устарело, переименуйте в transmit_optimize. Параметры оптимизации передачи пакетов, включая энергосбережение, агрег… Варианты: `"disable"` `"power-save"` `"aggr-limit"` `"retry-limit"` `"send-bar"`
vap-all string	Устарело, переименуйте в vap_all. Включить/выключить автоматическое наследование всех виртуальных точек доступа Варианты: `"disable"` `"enable"` `"tunnel"` `"bridge"` `"manual"`
vap1 string	Виртуальная точка доступа
vap2 string	Виртуальная точка доступа
vap3 string	Виртуальная точка доступа

vap4 string	Виртуальная точка доступа
vap5 string	Виртуальная точка доступа
vap6 string	Виртуальная точка доступа
vap7 string	Виртуальная точка доступа
vap8 string	Виртуальная точка доступа
vaps any	(список или строка) Ручной выбор списка виртуальных точек доступа
wids-profile string	Устарело, переименуйте на wids_profile. Беспроводная система обнаружения вторжений
zero-wait-dfs string	Устарело, переименуйте на zero_wait_dfs. Включить/выключить zero wait DFS на радио Варианты: `"disable"` `"enable"`

Примечания

Примечание

Начиная с версии 2.4.0, все входные аргументы имеют имя с использованием нижнего подчеркивания (snake_case). Пожалуйста, измените аргументы, такие как “var-name”, на “var_name”. Старые имена аргументов все еще доступны, но вы получите предупреждения об устаревании. Вы можете проигнорировать это предупреждение, установив deprecation_warnings=False в ansible.cfg.
В этом модуле FortiManager поддерживается запуск в режиме блокировки рабочей области, параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout помогают в этой работе.
Обычно выполнение одного модуля может завершиться ошибкой, когда возвращается ненулевой код. Вы также можете переопределить условия завершения ошибкой или успехом с помощью параметров 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: Configuration options for radio 3.
      fortinet.fortimanager.fmgr_wtpprofile_radio3:
        # 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>
        wtp_profile: <your own value>
        wtpprofile_radio3:
          airtime_fairness: <value in [disable, enable]>
          amsdu: <value in [disable, enable]>
          ap_handoff: <value in [disable, enable]>
          ap_sniffer_addr: <string>
          ap_sniffer_bufsize: <integer>
          ap_sniffer_chan: <integer>
          ap_sniffer_ctl: <value in [disable, enable]>
          ap_sniffer_data: <value in [disable, enable]>
          ap_sniffer_mgmt_beacon: <value in [disable, enable]>
          ap_sniffer_mgmt_other: <value in [disable, enable]>
          ap_sniffer_mgmt_probe: <value in [disable, enable]>
          auto_power_high: <integer>
          auto_power_level: <value in [disable, enable]>
          auto_power_low: <integer>
          band: <value in [802.11b, 802.11a, 802.11g, ...]>
          bandwidth_admission_control: <value in [disable, enable]>
          bandwidth_capacity: <integer>
          beacon_interval: <integer>
          call_admission_control: <value in [disable, enable]>
          call_capacity: <integer>
          channel: <list or string>
          channel_bonding: <value in [80MHz, 40MHz, 20MHz, ...]>
          channel_utilization: <value in [disable, enable]>
          coexistence: <value in [disable, enable]>
          darrp: <value in [disable, enable]>
          dtim: <integer>
          frag_threshold: <integer>
          frequency_handoff: <value in [disable, enable]>
          max_clients: <integer>
          max_distance: <integer>
          mode: <value in [disabled, ap, monitor, ...]>
          power_level: <integer>
          powersave_optimize:
            - tim
            - ac-vo
            - no-obss-scan
            - no-11b-rate
            - client-rate-follow
          protection_mode: <value in [rtscts, ctsonly, disable]>
          radio_id: <integer>
          rts_threshold: <integer>
          short_guard_interval: <value in [disable, enable]>
          spectrum_analysis: <value in [disable, enable, scan-only]>
          transmit_optimize:
            - disable
            - power-save
            - aggr-limit
            - retry-limit
            - send-bar
          vap_all: <value in [disable, enable, tunnel, ...]>
          vaps: <list or string>
          wids_profile: <string>
          band_5g_type: <value in [5g-full, 5g-high, 5g-low]>
          zero_wait_dfs: <value in [disable, enable]>
          vap1: <string>
          vap2: <string>
          vap3: <string>
          vap4: <string>
          vap5: <string>
          vap6: <string>
          vap7: <string>
          vap8: <string>
          bss_color: <integer>
          auto_power_target: <string>
          drma: <value in [disable, enable]>
          drma_sensitivity: <value in [low, medium, high]>
          iperf_protocol: <value in [udp, tcp]>
          iperf_server_port: <integer>
          power_mode: <value in [dBm, percentage]>
          power_value: <integer>
          sam_bssid: <string>
          sam_captive_portal: <value in [disable, enable]>
          sam_password: <list or string>
          sam_report_intv: <integer>
          sam_security_type: <value in [open, wpa-personal, wpa-enterprise, ...]>
          sam_server: <string>
          sam_ssid: <string>
          sam_test: <value in [ping, iperf]>
          sam_username: <string>
          arrp_profile: <string>
          bss_color_mode: <value in [auto, static]>
          sam_cwp_failure_string: <string>
          sam_cwp_match_string: <string>
          sam_cwp_password: <list or string>
          sam_cwp_success_string: <string>
          sam_cwp_test_url: <string>
          sam_cwp_username: <string>
          sam_server_fqdn: <string>
          sam_server_ip: <string>
          sam_server_type: <value in [ip, fqdn]>
          d80211d: <value in [disable, enable]>
          optional_antenna: <value in [none, FANT-04ABGN-0606-O-N, FANT-04ABGN-1414-P-N, ...]>
          mimo_mode: <value in [default, 1x1, 2x2, ...]>
          optional_antenna_gain: <string>
          sam_ca_certificate: <string>
          sam_client_certificate: <string>
          sam_eap_method: <value in [tls, peap, both]>
          sam_private_key: <string>
          sam_private_key_password: <list or string>
          channel_bonding_ext: <value in [320MHz-1, 320MHz-2]>
          d80211mc: <value in [disable, enable]>
          ap_sniffer_chan_width: <value in [320MHz, 240MHz, 160MHz, ...]>

Значения возврата

Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
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 список / элементы=строка	Предупреждение, если параметры, используемые в playbook, не поддерживаются текущей версией FortiManager. Возвращается: сложное

Авторы

Xinwei Du (@dux-fortinet)
Xing Li (@lix-fortinet)
Jie Xue (@JieX19)
Link Zheng (@chillancezen)
Frank Shen (@fshen01)
Hongbin Lu (@fgtdev-hblu)

Справочные ссылки

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/fortinet/fortimanager/fmgr_wtpprofile_radio3_module.html