модуль fortinet.fortios.fortios_switch_controller_managed_switch — настройка устройств FortiSwitch, управляемых этим FortiGate, в Fortinet FortiOS и FortiGate.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.
Чтобы использовать его в плейбуке, укажите: fortinet.fortios.fortios_switch_controller_managed_switch.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя функцию switch_controller и категорию managed_switch. В примерах приведены все параметры и значения, которые необходимо настроить в соответствии с источниками данных перед использованием. Проверено с FOS v6.0.0
Требования
На хосте, на котором выполняется этот модуль, должны быть соблюдены следующие требования.
- ansible>=2.16
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Аутентификация на основе токена. Создается в графическом интерфейсе FortiGate. |
enable_log boolean | Включить/отключить ведение журнала для задачи. Варианты:
|
member_path string | Путь к атрибуту элемента, с которым выполняется операция. Если атрибутов несколько, они разделяются косой чертой. Параметр с пометкой member_path можно использовать для выполнения операции с элементом. |
member_state string | Добавить или удалить элемент по указанному пути к атрибуту. Если задан параметр member_state, параметр state игнорируется. Варианты:
|
state string / обязательный | Указывает, следует ли создать или удалить объект. Варианты:
|
switch_controller_managed_switch dictionary | Настройка устройств FortiSwitch, управляемых этим FortiGate. |
|
access_profile string |
Профиль доступа FortiSwitch. Источник: switch-controller.security-policy.local-access.name. |
|
custom_command list / элементы=dictionary |
Метод настройки команд FortiSwitch, которые будут отправлены на это устройство FortiSwitch после перезапуска контроллера коммутаторов FortiGate или самого FortiSwitch. |
|
command_entry string / обязательный |
Список команд FortiSwitch. |
|
command_name string |
Названия команд, которые будут отправлены на это устройство FortiSwitch, как указано в config switch-controller custom-command. Источник: switch-controller.custom-command.command-name. |
|
delayed_restart_trigger integer |
Отложенный перезапуск, инициированный для этого FortiSwitch. |
|
description string |
Описание. |
|
dhcp_server_access_list string |
Список контроля доступа серверов для DHCP snooping. Варианты:
|
|
dhcp_snooping_static_client list / элементы=dictionary |
Настройка статических клиентов DHCP snooping FortiSwitch. |
|
ip string |
Статический IP-адрес клиента. |
|
mac string |
MAC-адрес клиента. |
|
name string / обязательный |
Имя клиента. |
|
port string |
Имя интерфейса. |
|
vlan string |
Имя VLAN. Источник: system.interface.name. |
|
directly_connected integer |
Непосредственно подключенный FortiSwitch. |
|
dynamic_capability string |
Список функций, поддерживаемых этим FortiSwitch (не настраивается), который передается на устройство FortiGate для последующей настройки, инициируемой устройством FortiGate. |
|
dynamically_discovered integer |
FortiSwitch, обнаруженный динамически. |
|
firmware_provision string |
Включить/отключить установку микропрограммы на FortiSwitch при подключении. Варианты:
|
|
firmware_provision_latest string |
Включить/отключить однократную автоматическую установку последней версии микропрограммы. Варианты:
|
|
firmware_provision_version string |
Версия микропрограммы для установки на этот FortiSwitch при загрузке (major.minor.build, например 6.2.1234). |
|
flow_identity string |
Идентификатор коммутатора для отслеживания потоков NetFlow/IPFIX в шестнадцатеричном формате (00000000-FFFFFFFF). |
|
fsw_wan1_admin string |
Состояние административного управления WAN1 FortiSwitch; включите, чтобы разрешить управление FortiSwitch как управляемым коммутатором. Варианты:
|
|
fsw_wan1_peer string |
Порт узла-партнера WAN1 FortiSwitch. Источник: system.interface.name. |
|
fsw_wan2_admin string |
Состояние административного управления WAN2 FortiSwitch; включите, чтобы разрешить управление FortiSwitch как управляемым коммутатором. Варианты:
|
|
fsw_wan2_peer string |
Порт узла-партнера WAN2 FortiSwitch. |
|
igmp_snooping dictionary |
Настройка глобальных параметров IGMP snooping FortiSwitch. |
|
aging_time integer |
Максимальное время хранения записи multicast snooping, для которой не было получено ни одного пакета (15–3600 с). |
|
flood_unknown_multicast string |
Включить/отключить рассылку неизвестного многоадресного трафика. Варианты:
|
|
local_override string |
Включить/отключить переопределение глобальной конфигурации IGMP snooping. Варианты:
|
|
vlans list / элементы=dictionary |
Настройка VLAN для IGMP snooping. |
|
proxy string |
Прокси IGMP snooping для интерфейса VLAN. Варианты:
|
|
querier string |
Включить/отключить опросчик IGMP snooping для интерфейса VLAN. Варианты:
|
|
querier_addr string |
Адрес опросчика IGMP snooping. |
|
version integer |
Версия опросчика IGMP snooping. |
|
vlan_name string / обязательный |
Список VLAN FortiSwitch. Источник: system.interface.name. |
|
ip_source_guard list / элементы=dictionary |
Защита источника IP-адреса. |
|
binding_entry list / элементы=dictionary |
Настройка IP- и MAC-адресов. |
|
entry_name string / обязательный |
Настройка пары привязки. |
|
ip string |
Исходный IP-адрес для этого правила. |
|
mac string |
MAC-адрес для этого правила. |
|
description string |
Описание. |
|
port string / обязательный |
Входящий интерфейс, к которому привязана защита источника. |
|
l3_discovered integer |
Обнаружено управление уровня 3. |
|
max_allowed_trunk_members integer |
Максимально допустимое число участников транка FortiSwitch. |
|
mclag_igmp_snooping_aware string |
Включить/отключить поддержку IGMP snooping в MCLAG. Варианты:
|
|
mgmt_mode integer |
Режим управления FortiLink. |
|
mirror list / элементы=dictionary |
Метод настройки зеркалирования пакетов FortiSwitch. |
|
dst string |
Порт назначения. |
|
name string / обязательный |
Имя зеркала. |
|
src_egress list / элементы=dictionary |
Исходящие интерфейсы-источники. |
|
name string / обязательный |
Имя интерфейса. |
|
src_ingress list / элементы=dictionary |
Входящие интерфейсы-источники. |
|
name string / обязательно |
Имя интерфейса. |
|
status string |
Активная/неактивная конфигурация зеркалирования. Варианты:
|
|
switching_packet string |
Включить/отключить коммутацию при зеркалировании. Варианты:
|
|
name string |
Имя управляемого коммутатора. |
|
override_snmp_community string |
Включить/отключить переопределение глобальных сообществ SNMP. Варианты:
|
|
override_snmp_sysinfo string |
Включить/отключить переопределение глобальных системных сведений SNMP. Варианты:
|
|
override_snmp_trap_threshold string |
Включить/отключить переопределение глобальных пороговых значений SNMP-ловушек. Варианты:
|
|
override_snmp_user string |
Включить/отключить переопределение глобальных пользователей SNMP. Варианты:
|
|
owner_vdom string |
VDOM, которому принадлежит порт. |
|
poe_detection_type integer |
Тип обнаружения PoE для FortiSwitch. |
|
poe_lldp_detection string |
Включить/отключить обнаружение PoE LLDP. Варианты:
|
|
poe_pre_standard_detection string |
Включить/отключить обнаружение PoE до стандартизации. Варианты:
|
|
ports list / elements=dictionary |
Список портов управляемого коммутатора. |
|
access_mode string |
Режим доступа порта. Варианты:
|
|
acl_group list / elements=dictionary |
Группы ACL на этом порту. |
|
name string / обязательно |
Имя группы ACL. Источник: switch-controller.acl.group.name. |
|
aggregator_mode string |
Режим выбора участника LACP. Варианты:
|
|
allow_arp_monitor string |
Включить/отключить возможность мониторинга ARP. Варианты:
|
|
allowed_vlans list / elements=dictionary |
Настройка VLAN с тегами для порта коммутатора. |
|
vlan_name string / обязательно |
Имя VLAN. Источник: system.interface.name. |
|
allowed_vlans_all string |
Включить/отключить все определённые VLAN на этом порту. Варианты:
|
|
arp_inspection_trust string |
Доверенная или недоверенная динамическая проверка ARP. Варианты:
|
|
bundle string |
Включить/отключить объединение в группу агрегации каналов (LAG) для интерфейсов, не являющихся FortiLink. Варианты:
|
|
description string |
Описание порта. |
|
dhcp_snoop_option82_override list / elements=dictionary |
Настройка переопределения опции 82 для DHCP snooping. |
|
circuit_id string |
Строка идентификатора канала. |
|
remote_id string |
Строка удалённого идентификатора. |
|
vlan_name string / обязательно |
VLAN для DHCP snooping с опцией 82. Источник: system.interface.name. |
|
dhcp_snoop_option82_trust string |
Включить/отключить разрешение DHCP с опцией 82 на недоверенном интерфейсе. Варианты:
|
|
dhcp_snooping string |
Доверенный или недоверенный интерфейс DHCP snooping. Варианты:
|
|
discard_mode string |
Настройка режима отбрасывания для порта. Варианты:
|
|
edge_port string |
Включить/отключить использование этого интерфейса в качестве граничного порта для объединения рабочих станций и/или компьютеров. Варианты:
|
|
export_tags list / elements=dictionary |
Настройка тегов экспорта для порта FortiSwitch при его экспорте в пул виртуальных портов. |
|
tag_name string / обязательно |
Имя тега порта FortiSwitch при экспорте в пул виртуальных портов. Источник: switch-controller.switch-interface-tag.name. |
|
export_to string |
Экспорт порта управляемого коммутатора в VDOM арендатора. Источник: system.vdom.name. |
|
export_to_pool string |
Экспорт порта контроллера коммутатора в список пулов. Источник: switch-controller.virtual-port-pool.name. |
|
export_to_pool_flag integer |
Экспорт порта контроллера коммутатора в список пулов. |
|
fallback_port string |
Резервный порт LACP. |
|
fec_capable integer |
Поддержка FEC. |
|
fec_state string |
Состояние коррекции ошибок при передаче. Варианты:
|
|
fgt_peer_device_name string |
Имя устройства-соседа FGT. |
|
fgt_peer_port_name string |
Имя порта устройства-соседа FGT. |
|
fiber_port integer |
Оптоволоконный порт. |
|
flags integer |
Флаги свойств порта. |
|
flap_duration integer |
Период, за который рассчитываются события переключения состояния (в секундах). |
|
flap_rate integer |
Количество событий изменения состояния, необходимых в течение периода flap-duration. |
|
flap_timeout integer |
Время отключения защиты от переключений состояния (мин). |
|
flapguard string |
Включить/отключить защиту от частых переключений состояния. Варианты:
|
|
flow_control string |
Направление управления потоком. Варианты:
|
|
fortilink_port integer |
Порт восходящего канала FortiLink. |
|
fortiswitch_acls list / elements=dictionary |
Списки ACL на этом порту. |
|
id integer / обязательно |
Идентификатор ACL. См. <a href=’#notes’>Примечания</a>. |
|
igmp_snooping string |
Установка режима IGMP snooping для физического интерфейса порта. Варианты:
|
|
igmp_snooping_flood_reports string |
Включить/отключить рассылку отчётов IGMP на этот интерфейс при включённом IGMP snooping. Варианты:
|
|
igmps_flood_reports string |
Включить или отключить рассылку отчетов IGMP на этот интерфейс, если включен IGMP Snooping. Возможные значения:
|
|
igmps_flood_traffic string |
Включить или отключить рассылку трафика IGMP Snooping на этот интерфейс. Возможные значения:
|
|
interface_tags list / elements=dictionary |
Теги, связанные с интерфейсом для различных функций, включая пул виртуальных портов и динамическую политику портов. |
|
tag_name string / обязательный |
Имя тега порта FortiSwitch при экспорте в пул виртуальных портов или сопоставлении с динамической политикой портов. Источник: switch-controller.switch-interface-tag.name. |
|
ip_source_guard string |
Включить или отключить защиту источника IP-адреса. Возможные значения:
|
|
isl_local_trunk_name string |
Имя локального транкового канала ISL. |
|
isl_peer_device_name string |
Имя соседнего устройства ISL. |
|
isl_peer_port_name string |
Имя порта соседнего устройства ISL. |
|
lacp_speed string |
Отправлять сообщения протокола управления агрегацией каналов (LACP) каждые 30 секунд (медленный режим) или каждую секунду (быстрый режим). Возможные значения:
|
|
learning_limit integer |
Ограничение количества динамических MAC-адресов на этом порту (1–128; 0 = без ограничений, значение по умолчанию). |
|
lldp_profile string |
Профиль TLV порта LLDP. Источник: switch-controller.lldp-profile.name. |
|
lldp_status string |
Состояние передачи и приема LLDP. Возможные значения:
|
|
log_mac_event string |
Включить или отключить ведение журнала событий динамических MAC-адресов. Возможные значения:
|
|
loop_guard string |
Включить или отключить защиту от петель на этом интерфейсе — оптимизацию STP, предотвращающую образование сетевых петель. Возможные значения:
|
|
loop_guard_timeout integer |
Тайм-аут защиты от петель (0–120 мин). |
|
mac_addr string |
MAC-адрес порта/транкового канала. |
|
matched_dpp_intf_tags string |
Теги интерфейса, соответствующие динамической политике портов. |
|
matched_dpp_policy string |
Дочерняя политика, соответствующая динамической политике портов. |
|
max_bundle integer |
Максимальный размер группы LAG (1–24). |
|
mcast_snooping_flood_traffic string |
Включить или отключить рассылку трафика IGMP Snooping на этот интерфейс. Возможные значения:
|
|
mclag string |
Включить или отключить агрегацию каналов между несколькими коммутаторами (MCLAG). Возможные значения:
|
|
mclag_icl_port integer |
Порт MCLAG-ICL. |
|
media_type string |
Тип среды передачи данных. |
|
member_withdrawal_behavior string |
Поведение порта после его исключения из-за потери управляющих пакетов. Возможные значения:
|
|
members list / elements=dictionary |
Интерфейсы агрегированной группы LAG. |
|
member_name string / обязательный |
Имя интерфейса из доступных вариантов. |
|
min_bundle integer |
Минимальный размер группы LAG (1–24). |
|
mode string |
Режим LACP: игнорировать и не отправлять управляющие сообщения либо согласовывать агрегацию 802.3ad в пассивном или активном режиме. Возможные значения:
|
|
p2p_port integer |
Порт общего туннеля одноранговой связи. |
|
packet_sample_rate integer |
Частота выборки пакетов (0–99999 пакетов/с). |
|
packet_sampler string |
Включить или отключить выборку пакетов на этом интерфейсе. Возможные значения:
|
|
pause_meter integer |
Настройка скорости входящего потока пауз, в кбит/с. |
|
pause_meter_resume string |
Порог возобновления трафика на входящем порту. Возможные значения:
|
|
pd_capable integer |
Поддержка питания устройства. |
|
poe_capable integer |
Поддержка PoE. |
|
poe_max_power string |
Максимальная мощность PoE. |
|
poe_mode_bt_cabable integer |
Поддержка режима PoE IEEE 802.3BT. |
|
poe_port_mode string |
Настройка режима порта PoE. Возможные значения:
|
|
poe_port_power string |
Настройка питания порта PoE. Возможные значения:
|
|
poe_port_priority string |
Настройка приоритета порта PoE. Возможные значения:
|
|
poe_pre_standard_detection string |
Включить или отключить обнаружение устройств PoE, не соответствующих стандарту. Возможные значения:
|
|
poe_standard string |
Поддерживаемый стандарт PoE. |
|
poe_status string |
Включить или отключить PoE. Возможные значения:
|
|
port_name string / обязательный |
Имя порта коммутатора. |
|
port_number integer |
Номер порта. |
|
port_owner string |
Имя порта коммутатора. |
|
port_policy string |
Динамическая политика портов контроллера коммутатора из доступных вариантов. Источник: switch-controller.dynamic-port-policy.name. |
|
port_prefix_type integer |
Тип префикса порта. |
|
port_security_policy string |
Политика аутентификации контроллера коммутатора, применяемая к этому управляемому коммутатору; выберите один из доступных вариантов. Источник: switch-controller .security-policy.802-1X.name. |
|
port_selection_criteria string |
Алгоритм выбора агрегируемых портов. Возможные значения:
|
|
ptp_policy string |
Конфигурация политики PTP. Источник: switch-controller.ptp.interface-policy.name. |
|
ptp_status string |
Включить или отключить политику PTP на этом порту FortiSwitch. Возможные значения:
|
|
qnq string |
Сети VLAN 802.1AD в VDom. Источник: system.interface.name. |
|
qos_policy string |
Политика QoS контроллера коммутатора из доступных вариантов. Источник: switch-controller.qos.qos-policy.name. |
|
rpvst_port string |
Включить или отключить взаимодействие с Rapid PVST на этом интерфейсе. Возможные значения:
|
|
sample_direction string |
Направление выборки пакетов. Варианты:
|
|
sflow_counter_interval integer |
Интервал опроса счетчика выборки sFlow в секундах (0–255). |
|
sflow_sample_rate integer |
Частота выборки sFlow (0–99999 пакетов/с). |
|
sflow_sampler string |
Включить или отключить протокол sFlow на этом интерфейсе. Варианты:
|
|
speed string |
Скорость порта коммутатора; значение по умолчанию и доступные настройки зависят от оборудования. Варианты:
|
|
speed_mask integer |
Маска скорости порта коммутатора. |
|
stacking_port integer |
Порт стекирования. |
|
status string |
Административный статус порта коммутатора: включен или выключен. Варианты:
|
|
sticky_mac string |
Включить или отключить sticky MAC на интерфейсе. Варианты:
|
|
storm_control_policy string |
Политика управления штормовым трафиком контроллера коммутатора из доступных вариантов. Источник: switch-controller.storm-control-policy.name. |
|
stp_bpdu_guard string |
Включить или отключить защиту BPDU STP на этом интерфейсе. Варианты:
|
|
stp_bpdu_guard_timeout integer |
Время отключения защиты BPDU Guard (0–120 мин). |
|
stp_root_guard string |
Включить или отключить защиту корневого моста STP на этом интерфейсе. Варианты:
|
|
stp_state string |
Включить или отключить протокол связующего дерева (STP) на этом интерфейсе. Варианты:
|
|
switch_id string |
Идентификатор коммутатора. |
|
type string |
Тип интерфейса: физический порт или порт транка. Варианты:
|
|
untagged_vlans list / elements=dictionary |
Настройка VLAN без тегов для порта коммутатора. |
|
vlan_name string / обязательно |
Имя VLAN. Источник: system.interface.name. |
|
virtual_port integer |
Виртуализированный порт коммутатора. |
|
vlan string |
Назначить порты коммутатора VLAN. Источник: system.interface.name. |
|
pre_provisioned integer |
Предварительно подготовленный управляемый коммутатор. |
|
ptp_profile string |
Конфигурация профиля PTP. Источник: switch-controller.ptp.profile.name. |
|
ptp_status string |
Включить или отключить профиль PTP на этом FortiSwitch. Варианты:
|
|
purdue_level string |
Уровень по модели Purdue для этого FortiSwitch. Варианты:
|
|
qos_drop_policy string |
Задать политику отбрасывания QoS. Варианты:
|
|
qos_red_probability integer |
Задать вероятность отбрасывания QoS RED/WRED. |
|
radius_nas_ip string |
IP-адрес NAS. |
|
radius_nas_ip_override string |
Использовать локально заданный IP-адрес NAS. Варианты:
|
|
remote_log list / elements=dictionary |
Настройка отправки журналов с устройства FortiSwitch на удаленный сервер syslog. |
|
csv string |
Включить или отключить строки в формате CSV (значения, разделенные запятыми). Варианты:
|
|
facility string |
Категория сообщений для отправки на удаленный сервер syslog. Варианты:
|
|
name string / обязательно |
Имя удаленного журнала. |
|
port integer |
Порт, на котором ожидает подключения удаленный сервер syslog. |
|
server string |
IPv4-адрес удаленного сервера syslog. |
|
severity string |
Уровень серьезности журналов, передаваемых на удаленный сервер журналов. Варианты:
|
|
status string |
Включить или отключить отправку журналов с устройства FortiSwitch на удаленный сервер syslog. Варианты:
|
|
route_offload string |
Включить или отключить разгрузку маршрутизации на этом FortiSwitch. Варианты:
|
|
route_offload_mclag string |
Включить или отключить разгрузку маршрутизации MCLAG на этом FortiSwitch. Варианты:
|
|
route_offload_router list / elements=dictionary |
Настройка IP-адреса маршрутизатора для разгрузки маршрутизации MCLAG. |
|
router_ip string |
IP-адрес маршрутизатора. |
|
vlan_name string / обязательно |
Имя VLAN. Источник: system.interface.name. |
|
router_static list / elements=dictionary |
Настройка статических маршрутов. |
|
blackhole string |
Включить или отключить черную дыру для этого маршрута. Варианты:
|
|
comment string |
Комментарий. |
|
device string |
Исходящий интерфейс шлюза. Источник: switch-controller.managed-switch.system-interface.name. |
|
distance integer |
Административное расстояние маршрута (1–255). |
|
dst string |
IP-адрес назначения и маска для этого маршрута. |
|
dynamic_gateway string |
Включить или отключить динамический шлюз. Варианты:
|
|
gateway string |
IP-адрес шлюза для этого маршрута. |
|
id integer / обязательно |
Порядковый номер записи. См. <a href=’#notes’>Примечания</a>. |
|
status string |
Включить или отключить маршрут. Варианты:
|
|
switch_id string |
Идентификатор коммутатора. Источник: switch-controller.managed-switch.switch-id. |
|
vrf string |
VRF для этого маршрута. Источник: switch-controller.managed-switch.router-vrf.name. |
|
router_vrf list / elements=dictionary |
Настройка VRF. |
|
name string / required |
Имя записи VRF. |
|
switch_id string |
Идентификатор коммутатора. Источник: switch-controller.managed-switch.switch-id. |
|
vrfid integer |
Идентификатор VRF. |
|
settings_802_1X dictionary |
Способ настройки глобальных параметров 802.1X для FortiSwitch. |
|
link_down_auth string |
Состояние аутентификации, устанавливаемое при разрыве соединения. Варианты:
|
|
local_override string |
Включите, чтобы переопределить глобальные параметры 802.1X на отдельных устройствах FortiSwitch. Варианты:
|
|
mab_reauth string |
Включение или отключение параметров повторной аутентификации MAB. Варианты:
|
|
mac_called_station_delimiter string |
Разделитель MAC-адреса вызываемой станции. Варианты:
|
|
mac_calling_station_delimiter string |
Разделитель MAC-адреса вызывающей станции. Варианты:
|
|
mac_case string |
Регистр MAC-адреса. Варианты:
|
|
mac_password_delimiter string |
Разделитель пароля для аутентификации MAC. Варианты:
|
|
mac_username_delimiter string |
Разделитель имени пользователя для аутентификации MAC. Варианты:
|
|
max_reauth_attempt integer |
Максимальное количество попыток аутентификации (0–15). |
|
reauth_period integer |
Интервал повторной аутентификации (1–1440 мин). |
|
tx_period integer |
Период передачи 802.1X (секунды). |
|
sn string |
Серийный номер управляемого коммутатора. |
|
snmp_community list / elements=dictionary |
Способ настройки сообществ протокола простого сетевого управления (SNMP). |
|
events list / elements=string |
Уведомления SNMP (ловушки) для отправки. Варианты:
|
|
hosts list / elements=dictionary |
Настройка менеджеров SNMP IPv4 (узлов). |
|
id integer / required |
Идентификатор записи узла. См. <a href=’#notes’>примечания</a>. |
|
ip string |
IPv4-адрес менеджера SNMP (узла). |
|
id integer / required |
Идентификатор сообщества SNMP. См. <a href=’#notes’>примечания</a>. |
|
name string |
Имя сообщества SNMP. |
|
query_v1_port integer |
Порт запросов SNMP v1. |
|
query_v1_status string |
Включение/отключение запросов SNMP v1. Варианты:
|
|
query_v2c_port integer |
Порт запросов SNMP v2c. |
|
query_v2c_status string |
Включение/отключение запросов SNMP v2c. Варианты:
|
|
status string |
Включение/отключение этого сообщества SNMP. Варианты:
|
|
trap_v1_lport integer |
Локальный порт ловушек SNMP v2c. |
|
trap_v1_rport integer |
Удалённый порт ловушек SNMP v2c. |
|
trap_v1_status string |
Включение/отключение ловушек SNMP v1. Варианты:
|
|
trap_v2c_lport integer |
Локальный порт ловушек SNMP v2c. |
|
trap_v2c_rport integer |
Удалённый порт ловушек SNMP v2c. |
|
trap_v2c_status string |
Включение/отключение ловушек SNMP v2c. Варианты:
|
|
snmp_sysinfo dictionary |
Способ настройки системной информации протокола простого сетевого управления (SNMP). |
|
contact_info string |
Контактная информация. |
|
description string |
Описание системы. |
|
engine_id string |
Строка локального идентификатора механизма SNMP (не более 24 символов). |
|
location string |
Расположение системы. |
|
status string |
Включение/отключение SNMP. Варианты:
|
|
snmp_trap_threshold dictionary |
Способ настройки пороговых значений ловушек протокола простого сетевого управления (SNMP). |
|
trap_high_cpu_threshold integer |
Использование ЦП, при котором отправляется ловушка. |
|
trap_log_full_threshold integer |
Использование диска журналов, при котором отправляется ловушка. |
|
trap_low_memory_threshold integer |
Использование памяти, при котором отправляется ловушка. |
|
snmp_user list / elements=dictionary |
Способ настройки пользователей протокола простого сетевого управления (SNMP). |
|
auth_proto string |
Протокол аутентификации. Варианты:
|
|
auth_pwd string |
Пароль для протокола аутентификации. |
|
name string / required |
Имя пользователя SNMP. |
|
priv_proto string |
Протокол обеспечения конфиденциальности (шифрования). Варианты:
|
|
priv_pwd string |
Пароль для протокола обеспечения конфиденциальности (шифрования). |
|
queries string |
Включение/отключение запросов SNMP для этого пользователя. Варианты:
|
|
query_port integer |
Порт запросов SNMPv3. |
|
security_level string |
Уровень безопасности для аутентификации и шифрования сообщений. Варианты:
|
|
staged_image_version string |
Версия подготовленного образа для FortiSwitch. |
|
static_mac list / elements=dictionary |
Метод настройки для изменения статических и закрепленных MAC-адресов FortiSwitch. |
|
description string |
Описание. |
|
id integer / required |
Идентификатор. См. <a href=’#notes’>Примечания</a>. |
|
interface string |
Имя интерфейса. |
|
mac string |
MAC-адрес. |
|
type string |
Тип. Варианты:
|
|
vlan string |
VLAN. Источник: system.interface.name. |
|
storm_control dictionary |
Метод настройки для изменения параметров защиты от широковещательного шторма FortiSwitch, которая измеряет активность трафика по скорости передачи данных, чтобы предотвратить сбои в работе сети. |
|
broadcast string |
Включить или отключить защиту от широковещательного шторма для отбрасывания широковещательного трафика. Варианты:
|
|
burst_size_level integer |
Увеличьте уровень, чтобы обрабатывать всплески трафика (0–4). |
|
local_override string |
Включите этот параметр, чтобы переопределить глобальные настройки защиты от широковещательного шторма FortiSwitch для данного устройства FortiSwitch. Варианты:
|
|
rate integer |
Скорость в пакетах в секунду, при превышении которой защита от широковещательного шторма отбрасывает избыточный трафик (0–10000000). |
|
unknown_multicast string |
Включить или отключить защиту от широковещательного шторма для отбрасывания неизвестного многоадресного трафика. Варианты:
|
|
unknown_unicast string |
Включить или отключить защиту от широковещательного шторма для отбрасывания неизвестного одноадресного трафика. Варианты:
|
|
stp_instance list / elements=dictionary |
Метод настройки для изменения экземпляров протокола связующего дерева (STP). |
|
id string / required |
Идентификатор экземпляра. |
|
priority string |
Приоритет. Варианты:
|
|
stp_settings dictionary |
Метод настройки для изменения параметров протокола связующего дерева (STP), используемого для предотвращения петель в мостах. |
|
forward_time integer |
Время, в течение которого порт находится в состоянии прослушивания и обучения (4–30 с). |
|
hello_time integer |
Интервал между последовательными кадрами блоков данных протокола моста (BPDU) STP, отправляемыми через порт (1–10 с). |
|
local_override string |
Включите этот параметр, чтобы настроить локальные параметры STP, переопределяющие глобальные параметры STP. Варианты:
|
|
max_age integer |
Максимальное время, в течение которого порт моста хранит сведения о BPDU конфигурации (6–40 с). |
|
max_hops integer |
Максимальное количество переходов между корневым мостом и самым удаленным мостом (1–40). |
|
name string |
Имя конфигурации локальных параметров STP. |
|
pending_timer integer |
Время ожидания (1–15 с). |
|
revision integer |
Номер ревизии STP (0–65535). |
|
status string |
Включить или отключить STP. Варианты:
|
|
switch_device_tag string |
Метка или тег, задаваемые пользователем. |
|
switch_dhcp_opt43_key string |
Ключ DHCP option43. |
|
switch_id string / required |
Имя управляемого коммутатора. |
|
switch_log dictionary |
Метод настройки для изменения параметров ведения журналов FortiSwitch (журналы передаются в журнал событий FortiGate и добавляются в него). |
|
local_override string |
Включите этот параметр, чтобы настроить локальные параметры ведения журналов, переопределяющие глобальные параметры. Варианты:
|
|
severity string |
Уровень серьезности журналов FortiSwitch, добавляемых в журнал событий FortiGate. Варианты:
|
|
status string |
Включить или отключить добавление журналов FortiSwitch в журнал событий FortiGate. Варианты:
|
|
switch_profile string |
Профиль FortiSwitch. Источник: switch-controller.switch-profile.name. |
|
switch_stp_settings dictionary |
Настройка протокола связующего дерева (STP). |
|
status string |
Включить или отключить STP. Варианты:
|
|
system_dhcp_server list / elements=dictionary |
Настройка DHCP-серверов. |
|
default_gateway string |
IP-адрес шлюза по умолчанию, назначаемый DHCP-сервером. |
|
dns_server1 string |
DNS-сервер 1. |
|
dns_server2 string |
DNS-сервер 2. |
|
dns_server3 string |
DNS-сервер 3. |
|
dns_service string |
Параметры назначения DNS-серверов клиентам DHCP. Варианты:
|
|
id integer / required |
Идентификатор. См. <a href=’#notes’>Примечания</a>. |
|
interface string |
DHCP-сервер может назначать клиентам, подключенным к этому интерфейсу, параметры IP-конфигурации. Источник: switch-controller.managed-switch .system-interface.name. |
|
ip_range list / elements=dictionary |
Настройка диапазона IP-адресов DHCP. |
|
end_ip string |
Конец диапазона IP-адресов. |
|
id integer / required |
Идентификатор. См. <a href=’#notes’>Примечания</a>. |
|
start_ip string |
Начало диапазона IP-адресов. |
|
lease_time integer |
Время аренды в секундах; значение 0 означает неограниченное время. |
|
netmask string |
Маска подсети, назначаемая DHCP-сервером. |
|
ntp_server1 string |
NTP-сервер 1. |
|
ntp_server2 string |
NTP-сервер 2. |
|
ntp_server3 string |
NTP-сервер 3. |
|
ntp_service string |
Параметры назначения серверов сетевого протокола времени (NTP) клиентам DHCP. Варианты:
|
|
options list / elements=dictionary |
Параметры DHCP. |
|
code integer |
Код параметра DHCP. |
|
id integer / required |
Идентификатор. См. <a href=’#notes’>Примечания</a>. |
|
ip list / elements=string |
IP-адреса параметра DHCP. |
|
type string |
Тип параметра DHCP. Варианты:
|
|
value string |
Значение параметра DHCP. |
|
status string |
Включить или отключить эту конфигурацию DHCP. Варианты:
|
|
switch_id string |
Идентификатор коммутатора. Источник: switch-controller.managed-switch.switch-id. |
|
system_interface list / elements=dictionary |
Настройка системного интерфейса на FortiSwitch. |
|
allowaccess list / elements=string |
Разрешённые типы доступа к управлению этим интерфейсом. Варианты:
|
|
interface string |
Имя интерфейса. Источник: switch-controller.managed-switch.ports.port-name. |
|
ip string |
IP-адрес и маска для этого интерфейса. |
|
mode string |
Режим адресации интерфейса. Варианты:
|
|
name string / required |
Имя интерфейса. |
|
status string |
Включить или отключить интерфейс. Варианты:
|
|
switch_id string |
Идентификатор коммутатора. Источник: switch-controller.managed-switch.switch-id. |
|
type string |
Тип интерфейса. Варианты:
|
|
vlan string |
Имя VLAN. Источник: system.interface.name. |
|
vrf string |
VRF для этого маршрута. Источник: switch-controller.managed-switch.router-vrf.name. |
|
tdr_supported string |
Поддержка TDR. |
|
type string |
Указание типа коммутатора: физический или виртуальный. Варианты:
|
|
version integer |
Версия FortiSwitch. |
|
vlan list / elements=dictionary |
Настройка приоритета назначения VLAN. |
|
assignment_priority integer |
Приоритет назначения VLAN по имени для 802.1x Radius (Tunnel-Private-Group-Id). Чем меньше значение, тем выше приоритет. |
|
vlan_name string / required |
Имя VLAN. Источник: system.interface.name. |
vdom string | Виртуальный домен из числа ранее определённых. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
Примечания
Примечание
- Устаревший fortiosapi объявлен нерекомендуемым; предпочтительный способ запуска плейбуков — httpapi.
- Модуль поддерживает check_mode.
Примеры
- name: Configure FortiSwitch devices that are managed by this FortiGate.
fortinet.fortios.fortios_switch_controller_managed_switch:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
switch_controller_managed_switch:
settings_802_1X:
link_down_auth: "set-unauth"
local_override: "enable"
mab_reauth: "disable"
mac_called_station_delimiter: "colon"
mac_calling_station_delimiter: "colon"
mac_case: "lowercase"
mac_password_delimiter: "colon"
mac_username_delimiter: "colon"
max_reauth_attempt: "3"
reauth_period: "60"
tx_period: "30"
access_profile: "<your_own_value> (source switch-controller.security-policy.local-access.name)"
custom_command:
-
command_entry: "<your_own_value>"
command_name: "<your_own_value> (source switch-controller.custom-command.command-name)"
delayed_restart_trigger: "0"
description: "<your_own_value>"
dhcp_server_access_list: "global"
dhcp_snooping_static_client:
-
ip: "<your_own_value>"
mac: "<your_own_value>"
name: "default_name_25"
port: "<your_own_value>"
vlan: "<your_own_value> (source system.interface.name)"
directly_connected: "0"
dynamic_capability: "<your_own_value>"
dynamically_discovered: "0"
firmware_provision: "enable"
firmware_provision_latest: "disable"
firmware_provision_version: "<your_own_value>"
flow_identity: "<your_own_value>"
fsw_wan1_admin: "discovered"
fsw_wan1_peer: "<your_own_value> (source system.interface.name)"
fsw_wan2_admin: "discovered"
fsw_wan2_peer: "<your_own_value>"
igmp_snooping:
aging_time: "300"
flood_unknown_multicast: "enable"
local_override: "enable"
vlans:
-
proxy: "disable"
querier: "disable"
querier_addr: "<your_own_value>"
version: "2"
vlan_name: "<your_own_value> (source system.interface.name)"
ip_source_guard:
-
binding_entry:
-
entry_name: "<your_own_value>"
ip: "<your_own_value>"
mac: "<your_own_value>"
description: "<your_own_value>"
port: "<your_own_value>"
l3_discovered: "0"
max_allowed_trunk_members: "0"
mclag_igmp_snooping_aware: "enable"
mgmt_mode: "0"
mirror:
-
dst: "<your_own_value>"
name: "default_name_62"
src_egress:
-
name: "default_name_64"
src_ingress:
-
name: "default_name_66"
status: "active"
switching_packet: "enable"
name: "default_name_69"
override_snmp_community: "enable"
override_snmp_sysinfo: "disable"
override_snmp_trap_threshold: "enable"
override_snmp_user: "enable"
owner_vdom: "<your_own_value>"
poe_detection_type: "0"
poe_lldp_detection: "enable"
poe_pre_standard_detection: "enable"
ports:
-
access_mode: "dynamic"
acl_group:
-
name: "default_name_81 (source switch-controller.acl.group.name)"
aggregator_mode: "bandwidth"
allow_arp_monitor: "disable"
allowed_vlans:
-
vlan_name: "<your_own_value> (source system.interface.name)"
allowed_vlans_all: "enable"
arp_inspection_trust: "untrusted"
bundle: "enable"
description: "<your_own_value>"
dhcp_snoop_option82_override:
-
circuit_id: "<your_own_value>"
remote_id: "<your_own_value>"
vlan_name: "<your_own_value> (source system.interface.name)"
dhcp_snoop_option82_trust: "enable"
dhcp_snooping: "untrusted"
discard_mode: "none"
edge_port: "enable"
export_tags:
-
tag_name: "<your_own_value> (source switch-controller.switch-interface-tag.name)"
export_to: "<your_own_value> (source system.vdom.name)"
export_to_pool: "<your_own_value> (source switch-controller.virtual-port-pool.name)"
export_to_pool_flag: "0"
fallback_port: "<your_own_value>"
fec_capable: "0"
fec_state: "disabled"
fgt_peer_device_name: "<your_own_value>"
fgt_peer_port_name: "<your_own_value>"
fiber_port: "0"
flags: "0"
flap_duration: "30"
flap_rate: "5"
flap_timeout: "0"
flapguard: "enable"
flow_control: "disable"
fortilink_port: "0"
fortiswitch_acls:
-
id: "117"
igmp_snooping: "enable"
igmp_snooping_flood_reports: "enable"
igmps_flood_reports: "enable"
igmps_flood_traffic: "enable"
interface_tags:
-
tag_name: "<your_own_value> (source switch-controller.switch-interface-tag.name)"
ip_source_guard: "disable"
isl_local_trunk_name: "<your_own_value>"
isl_peer_device_name: "<your_own_value>"
isl_peer_port_name: "<your_own_value>"
lacp_speed: "slow"
learning_limit: "0"
lldp_profile: "<your_own_value> (source switch-controller.lldp-profile.name)"
lldp_status: "disable"
log_mac_event: "disable"
loop_guard: "enabled"
loop_guard_timeout: "45"
mac_addr: "<your_own_value>"
matched_dpp_intf_tags: "<your_own_value>"
matched_dpp_policy: "<your_own_value>"
max_bundle: "24"
mcast_snooping_flood_traffic: "enable"
mclag: "enable"
mclag_icl_port: "0"
media_type: "<your_own_value>"
member_withdrawal_behavior: "forward"
members:
-
member_name: "<your_own_value>"
min_bundle: "1"
mode: "static"
p2p_port: "0"
packet_sample_rate: "512"
packet_sampler: "enabled"
pause_meter: "0"
pause_meter_resume: "75%"
pd_capable: "0"
poe_capable: "0"
poe_max_power: "<your_own_value>"
poe_mode_bt_cabable: "0"
poe_port_mode: "ieee802-3af"
poe_port_power: "normal"
poe_port_priority: "critical-priority"
poe_pre_standard_detection: "enable"
poe_standard: "<your_own_value>"
poe_status: "enable"
port_name: "<your_own_value>"
port_number: "0"
port_owner: "<your_own_value>"
port_policy: "<your_own_value> (source switch-controller.dynamic-port-policy.name)"
port_prefix_type: "0"
port_security_policy: "<your_own_value> (source switch-controller.security-policy.802-1X.name)"
port_selection_criteria: "src-mac"
ptp_policy: "<your_own_value> (source switch-controller.ptp.interface-policy.name)"
ptp_status: "disable"
qnq: "<your_own_value> (source system.interface.name)"
qos_policy: "<your_own_value> (source switch-controller.qos.qos-policy.name)"
rpvst_port: "disabled"
sample_direction: "tx"
sflow_counter_interval: "0"
sflow_sample_rate: "49999"
sflow_sampler: "enabled"
speed: "10half"
speed_mask: "2147483647"
stacking_port: "0"
status: "up"
sticky_mac: "enable"
storm_control_policy: "<your_own_value> (source switch-controller.storm-control-policy.name)"
stp_bpdu_guard: "enabled"
stp_bpdu_guard_timeout: "5"
stp_root_guard: "enabled"
stp_state: "enabled"
switch_id: "<your_own_value>"
type: "physical"
untagged_vlans:
-
vlan_name: "<your_own_value> (source system.interface.name)"
virtual_port: "0"
vlan: "<your_own_value> (source system.interface.name)"
pre_provisioned: "0"
ptp_profile: "<your_own_value> (source switch-controller.ptp.profile.name)"
ptp_status: "disable"
purdue_level: "1"
qos_drop_policy: "taildrop"
qos_red_probability: "12"
radius_nas_ip: "<your_own_value>"
radius_nas_ip_override: "disable"
remote_log:
-
csv: "enable"
facility: "kernel"
name: "default_name_206"
port: "514"
server: "192.168.100.40"
severity: "emergency"
status: "enable"
route_offload: "disable"
route_offload_mclag: "disable"
route_offload_router:
-
router_ip: "<your_own_value>"
vlan_name: "<your_own_value> (source system.interface.name)"
router_static:
-
blackhole: "disable"
comment: "Comment."
device: "<your_own_value> (source switch-controller.managed-switch.system-interface.name)"
distance: "10"
dst: "<your_own_value>"
dynamic_gateway: "disable"
gateway: "<your_own_value>"
id: "224"
status: "disable"
switch_id: "<your_own_value> (source switch-controller.managed-switch.switch-id)"
vrf: "<your_own_value> (source switch-controller.managed-switch.router-vrf.name)"
router_vrf:
-
name: "default_name_229"
switch_id: "<your_own_value> (source switch-controller.managed-switch.switch-id)"
vrfid: "0"
sn: "<your_own_value>"
snmp_community:
-
events: "cpu-high"
hosts:
-
id: "236"
ip: "<your_own_value>"
id: "238"
name: "default_name_239"
query_v1_port: "161"
query_v1_status: "disable"
query_v2c_port: "161"
query_v2c_status: "disable"
status: "disable"
trap_v1_lport: "162"
trap_v1_rport: "162"
trap_v1_status: "disable"
trap_v2c_lport: "162"
trap_v2c_rport: "162"
trap_v2c_status: "disable"
snmp_sysinfo:
contact_info: "<your_own_value>"
description: "<your_own_value>"
engine_id: "<your_own_value>"
location: "<your_own_value>"
status: "disable"
snmp_trap_threshold:
trap_high_cpu_threshold: "80"
trap_log_full_threshold: "90"
trap_low_memory_threshold: "80"
snmp_user:
-
auth_proto: "md5"
auth_pwd: "<your_own_value>"
name: "default_name_264"
priv_proto: "aes128"
priv_pwd: "<your_own_value>"
queries: "disable"
query_port: "161"
security_level: "no-auth-no-priv"
staged_image_version: "<your_own_value>"
static_mac:
-
description: "<your_own_value>"
id: "273"
interface: "<your_own_value>"
mac: "<your_own_value>"
type: "static"
vlan: "<your_own_value> (source system.interface.name)"
storm_control:
broadcast: "enable"
burst_size_level: "0"
local_override: "enable"
rate: "500"
unknown_multicast: "enable"
unknown_unicast: "enable"
stp_instance:
-
id: "286"
priority: "0"
stp_settings:
forward_time: "15"
hello_time: "2"
local_override: "enable"
max_age: "20"
max_hops: "20"
name: "default_name_294"
pending_timer: "4"
revision: "0"
status: "enable"
switch_device_tag: "<your_own_value>"
switch_dhcp_opt43_key: "<your_own_value>"
switch_id: "<your_own_value>"
switch_log:
local_override: "enable"
severity: "emergency"
status: "enable"
switch_profile: "<your_own_value> (source switch-controller.switch-profile.name)"
switch_stp_settings:
status: "enable"
system_dhcp_server:
-
default_gateway: "<your_own_value>"
dns_server1: "<your_own_value>"
dns_server2: "<your_own_value>"
dns_server3: "<your_own_value>"
dns_service: "local"
id: "314"
interface: "<your_own_value> (source switch-controller.managed-switch.system-interface.name)"
ip_range:
-
end_ip: "<your_own_value>"
id: "318"
start_ip: "<your_own_value>"
lease_time: "604800"
netmask: "<your_own_value>"
ntp_server1: "<your_own_value>"
ntp_server2: "<your_own_value>"
ntp_server3: "<your_own_value>"
ntp_service: "local"
options:
-
code: "0"
id: "328"
ip: "<your_own_value>"
type: "hex"
value: "<your_own_value>"
status: "disable"
switch_id: "<your_own_value> (source switch-controller.managed-switch.switch-id)"
system_interface:
-
allowaccess: "ping"
interface: "<your_own_value> (source switch-controller.managed-switch.ports.port-name)"
ip: "<your_own_value>"
mode: "static"
name: "default_name_339"
status: "disable"
switch_id: "<your_own_value> (source switch-controller.managed-switch.switch-id)"
type: "vlan"
vlan: "<your_own_value> (source system.interface.name)"
vrf: "<your_own_value> (source switch-controller.managed-switch.router-vrf.name)"
tdr_supported: "<your_own_value>"
type: "virtual"
version: "0"
vlan:
-
assignment_priority: "128"
vlan_name: "<your_own_value> (source system.interface.name)"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; далее перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
build string | Номер сборки образа FortiGate Возвращается: всегда Пример: |
http_method string | Последний метод, использованный для передачи конфигурации в FortiGate Возвращается: всегда Пример: |
http_status string | Последний результат, возвращённый FortiGate при выполнении последней операции Возвращается: всегда Пример: |
mkey string | Мастер-ключ (идентификатор), использованный при последнем вызове FortiGate Возвращается: при успехе Пример: |
name string | Имя таблицы, использованной для выполнения запроса Возвращается: всегда Пример: |
path string | Путь к таблице, использованной для выполнения запроса Возвращается: всегда Пример: |
revision string | Внутренний номер редакции Возвращается: всегда Пример: |
serial string | Серийный номер устройства Возвращается: всегда Пример: |
status string | Результат выполнения операции Возвращается: всегда Пример: |
vdom string | Используемый виртуальный домен Возвращается: всегда Пример: |
version string | Версия FortiGate Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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/fortios/fortios_switch_controller_managed_switch_module.html