Модуль fortinet.fortimanager.fmgr_wtpprofile_radio2 – Параметры конфигурации радио 2.

Примечание

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

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

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

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

Новое в fortinet.fortimanager 2.0.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, работающего в режиме рабочей области. Значение может быть глобальным и другими, включая корневой.
workspace_locking_timeout целое	Максимальное время в секундах ожидания освобождения блокировки рабочей области другим пользователем. По умолчанию: `300`
wtp-profile строка	Устаревшее значение, используйте «wtp_profile»
wtp_profile строка	Параметр (wtp-profile) в запрошенном URL.
wtpprofile_radio2 словарь	Настройка параметров верхнего уровня.
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. Пропускная способность канала для сниффера. Choices: `"320MHz"` `"240MHz"` `"160MHz"` `"80MHz"` `"40MHz"` `"20MHz"`
ap-sniffer-ctl string	Устарело, переименуйте в ap_sniffer_ctl. Включить/выключить сниффер на кадре управления WiFi Choices: `"disable"` `"enable"`
ap-sniffer-data string	Устарело, переименуйте в ap_sniffer_data. Включить/выключить сниффер на кадре данных WiFi Choices: `"disable"` `"enable"`
ap-sniffer-mgmt-beacon string	Устарело, переименуйте в ap_sniffer_mgmt_beacon. Включить/выключить сниффер на кадрах маяков управления WiFi Choices: `"disable"` `"enable"`
ap-sniffer-mgmt-other string	Устарело, переименуйте в ap_sniffer_mgmt_other. Включить/выключить сниффер на других кадрах управления WiFi Choices: `"disable"` `"enable"`
ap-sniffer-mgmt-probe string	Устарело, переименуйте в ap_sniffer_mgmt_probe. Включить/выключить сниффер на кадрах зондирования управления WiFi Choices: `"disable"` `"enable"`
arrp-profile string	Устарело, переименуйте в arrp_profile. Распределенное автоматическое предоставление радиоресурсов
auto-power-high integer	Устарело, переименуйте в auto_power_high. Автоматический верхний предел передаваемой мощности в dBm
auto-power-level string	Устарело, переименуйте в auto_power_level. Включить/выключить автоматическую регулировку уровня мощности для предотвращения совпадения каналов… Choices: `"disable"` `"enable"`
auto-power-low integer	Устарело, переименуйте в auto_power_low. Автоматический нижний предел передаваемой мощности в dBm
auto-power-target string	Устарело, переименуйте в auto_power_target. Целевое значение автоматической регулировки передаваемой мощности в dBm.
band string	Диапазон WiFi, на котором работает Radio 2. Choices: `"802.11b"` `"802.11a"` `"802.11g"` `"802.11n"` `"802.11ac"` `"802.11n-5G"` `"802.11g-only"` `"802.11n-only"` `"802.11n,g-only"` `"802.11ac-only"` `"802.11ac,n-only"` `"802.11n-5G-only"` `"802.11ax-5G"` `"802.11ax"` `"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. Тип диапазона WiFi 5G. Choices: `"5g-full"` `"5g-high"` `"5g-low"`
bandwidth-admission-control string	Устарело, переименуйте в bandwidth_admission_control. Включить/выключить мультимедиа WiFi Choices: `"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	(list) Выбранный список каналов беспроводной радиосвязи.
channel-bonding string	Устарело, переименуйте в channel_bonding. Пропускная способность канала Варианты: `"disable"` `"enable"` `"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	Интервал DTIM.
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"`

режим строка	Режим работы радио 2. Варианты: `"disabled"` `"ap"` `"monitor"` `"sniffer"` `"sam"`
дополнительная-антенна строка	Устарело, пожалуйста, переименуйте на optional_antenna. Дополнительная антенна, используемая на FAP Варианты: `"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. Дополнительное усиление антенны в дБi
уровень-мощности целое число	Устарело, пожалуйста, переименуйте на power_level. Уровень мощности радио в процентах от максимальной мощности передачи
режим-мощности строка	Устарело, пожалуйста, переименуйте на power_mode. Установка эффективной мощности излучения радио Варианты: `"dBm"` `"percentage"`
значение-мощности целое число	Устарело, пожалуйста, переименуйте на power_value. Мощность радио EIRP в дБм
оптимизация-powersave список / элементы=строка	Устарело, пожалуйста, переименуйте на powersave_optimize. Включение функций экономии энергии клиента, таких как TIM, AC VO и OBSS и т. д. Варианты: `"tim"` `"ac-vo"` `"no-obss-scan"` `"no-11b-rate"` `"client-rate-follow"`
режим-защиты строка	Устарело, пожалуйста, переименуйте на protection_mode. Включение/выключение 802. Варианты: `"rtscts"` `"ctsonly"` `"disable"`
id-радио целое число	Устарело, пожалуйста, переименуйте на radio_id. Идентификатор радио.
rts-порог целое число	Устарело, пожалуйста, переименуйте на rts_threshold. Максимальный размер пакета для RTS-передач, определяющий максимальный размер…
sam-bssid строка	Устарело, пожалуйста, переименуйте на sam_bssid. BSSID для сети WiFi.
sam-сертификат-ca строка	Устарело, пожалуйста, переименуйте на sam_ca_certificate. Сертификат CA для WPA2/WPA3-ENTERPRISE.
sam-портал-захвата строка	Устарело, пожалуйста, переименуйте на sam_captive_portal. Включение/выключение аутентификации порта захвата Варианты: `"disable"` `"enable"`
sam-клиентский-сертификат строка	Устарело, пожалуйста, переименуйте на sam_client_certificate. Клиентский сертификат для WPA2/WPA3-ENTERPRISE.
sam-cwp-строка-ошибки строка	Устарело, пожалуйста, переименуйте на sam_cwp_failure_string. Идентификация ошибки на странице после неправильного входа.
sam-cwp-строка-совпадения строка	Устарело, пожалуйста, переименуйте на sam_cwp_match_string. Строка идентификации из формы входа на портале захвата.
sam-cwp-пароль любой	(список) Устарело, пожалуйста, переименуйте на sam_cwp_password. Пароль для аутентификации порта захвата.
sam-cwp-строка-успеха строка	Устарело, пожалуйста, переименуйте на sam_cwp_success_string. Идентификация успеха на странице после успешного входа.
sam-cwp-тестовый-url строка	Устарело, пожалуйста, переименуйте на sam_cwp_test_url. Веб-сайт, к которому пытается получить доступ клиент.
sam-cwp-имя-пользователя строка	Устарело, пожалуйста, переименуйте на sam_cwp_username. Имя пользователя для аутентификации порта захвата.

END_OF_DOCUMENT_MARKER

sam-eap-method string	Устарело, переименуйте в sam_eap_method. Выберите метод WPA2/WPA3-ENTERPRISE EAP Choices: `"tls"` `"peap"` `"both"`
sam-password any	(list) Устарело, переименуйте в sam_password. Пароль для подключения к сети WiFi.
sam-private-key string	Устарело, переименуйте в sam_private_key. Закрытый ключ для WPA2/WPA3-ENTERPRISE.
sam-private-key-password any	(list) Устарело, переименуйте в sam_private_key_password. Пароль для файла закрытого ключа для WPA2/WPA3-ENTERPRISE.
sam-report-intv integer	Устарело, переименуйте в sam_report_intv. Интервал отчета SAM
sam-security-type string	Устарело, переименуйте в sam_security_type. Выберите тип безопасности сети WiFi Choices: `"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 Choices: `"ip"` `"fqdn"`
sam-ssid string	Устарело, переименуйте в sam_ssid. SSID для сети WiFi.
sam-test string	Устарело, переименуйте в sam_test. Выберите тип теста SAM Choices: `"ping"` `"iperf"`
sam-username string	Устарело, переименуйте в sam_username. Имя пользователя для подключения к сети WiFi.
short-guard-interval string	Устарело, переименуйте в short_guard_interval. Используйте короткий интервал защиты Choices: `"disable"` `"enable"`
spectrum-analysis string	Устарело, переименуйте в spectrum_analysis. Включить/выключить анализ спектра для поиска помех, которые могли бы отрица… Choices: `"disable"` `"enable"` `"scan-only"`
transmit-optimize list / elements=string	Устарело, переименуйте в transmit_optimize. Параметры оптимизации передачи пакетов, включая энергосбережение, агрега… Choices: `"disable"` `"power-save"` `"aggr-limit"` `"retry-limit"` `"send-bar"`
vap-all string	Устарело, переименуйте в vap_all. Включить/выключить автоматическое наследование всех виртуальных точек доступа Choices: `"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. Включение/выключение 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. Вы также можете переопределить условия завершения успехом или неудачей с помощью параметров 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 2.
      fortinet.fortimanager.fmgr_wtpprofile_radio2:
        # 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_radio2:
          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 [disable, enable, 80MHz, ...]>
          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>
          airtime_fairness: <value in [disable, enable]>
          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 список / элементы=строка	Предупреждение, если параметры, используемые в книге задач, не поддерживаются текущей версией 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_radio2_module.html