Модуль fortinet.fortios.fortios_switch_controller_vlan_policy – Настройка политики VLAN для применения на управляемых портах FortiSwitch через динамическую политику портов в FortiOS и FortiGate Fortinet.

Примечание

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

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

Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробностей.

Для использования в книге задач укажите: fortinet.fortios.fortios_switch_controller_vlan_policy.

Новое в fortinet.fortios 2.0.0

Описание
Требования
Параметры
Примечания
Примеры
Значения возврата

Описание

Этот модуль позволяет настроить устройство FortiGate или FortiOS (FOS), позволяя пользователю устанавливать и изменять функцию switch_controller и категорию vlan_policy. Примеры включают все параметры и значения, которые необходимо настроить в источниках данных перед использованием. Тестировалось с FOS v6.0.0

Требования

Ниже приведены требования к хосту, на котором выполняется этот модуль.

ansible>=2.15

Параметры

Параметр	Комментарии
access_token строка	Аутентификация на основе токена. Сгенерировано в графическом интерфейсе Fortigate.
enable_log логическое	Включить/выключить логирование для задачи. Варианты: `false` ← (по умолчанию) `true`
member_path строка	Путь к атрибуту члена для выполнения операции. Разделяется слешем, если атрибутов более одного. Параметр, помеченный member_path, подходит для выполнения операции с членом.
member_state строка	Добавить или удалить члена по указанному пути атрибута. Когда member_state указан, опция state игнорируется. Варианты: `"present"` `"absent"`
state строка / обязательно	Указывает, нужно ли создать или удалить объект. Варианты: `"present"` `"absent"`
switch_controller_vlan_policy словарь	Настройка политики VLAN для применения к управляемым портам FortiSwitch через динамическую политику порта.
allowed_vlans список / элементы=словарь	Разрешенные VLAN, которые будут применяться при использовании этой политики VLAN.
vlan_name строка / обязательно	Имя VLAN. Имя интерфейса источника системы.
allowed_vlans_all строка	Включить/выключить все определенные VLAN при использовании этой политики VLAN. Варианты: `"enable"` `"disable"`
description строка	Описание политики VLAN.
discard_mode строка	Режим удаления, который будет применяться при использовании этой политики VLAN. Варианты: `"none"` `"all-untagged"` `"all-tagged"`
fortilink строка	Интерфейс FortiLink, к которому относится эта политика VLAN. Имя интерфейса источника системы.
name строка / обязательно	Имя политики VLAN.
untagged_vlans список / элементы=словарь	Немаркированные VLAN, которые будут применяться при использовании этой политики VLAN.
vlan_name строка / обязательно	Имя VLAN. Имя интерфейса источника системы.
vlan строка	Базовая VLAN, которая будет применяться при использовании этой политики VLAN. Имя интерфейса источника системы.
vdom строка	Виртуальная область (vdom), определённая ранее. VDOM — это виртуальный экземпляр FortiGate, который может быть настроен и использован как отдельный блок. По умолчанию: `"root"`

Примечания

Примечание

Модуль legacy fortiosapi устарел, httpapi — предпочтительный способ запуска playbooks
Модуль поддерживает режим check_mode.

Примеры

- name: Configure VLAN policy to be applied on the managed FortiSwitch ports through dynamic-port-policy.
  fortinet.fortios.fortios_switch_controller_vlan_policy:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      switch_controller_vlan_policy:
          allowed_vlans:
              -
                  vlan_name: "<your_own_value> (source system.interface.name)"
          allowed_vlans_all: "enable"
          description: "<your_own_value>"
          discard_mode: "none"
          fortilink: "<your_own_value> (source system.interface.name)"
          name: "default_name_9"
          untagged_vlans:
              -
                  vlan_name: "<your_own_value> (source system.interface.name)"
          vlan: "<your_own_value> (source system.interface.name)"

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

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

Ключ	Описание
build строка	Номер сборки образа fortigate Возвращается: всегда Пример: `"1547"`
http_method строка	Последний метод, используемый для предоставления содержимого в FortiGate Возвращается: всегда Пример: `"PUT"`
http_status строка	Последний результат, предоставленный FortiGate по последней применённой операции Возвращается: всегда Пример: `"200"`
mkey строка	Главный ключ (id), использованный в последнем вызове FortiGate Возвращается: успех Пример: `"id"`
name строка	Имя таблицы, используемой для выполнения запроса Возвращается: всегда Пример: `"urlfilter"`
path строка	Путь к таблице, используемой для выполнения запроса Возвращается: всегда Пример: `"webfilter"`
revision строка	Внутренний номер версии Возвращается: всегда Пример: `"17.0.2.10658"`
serial строка	Серийный номер устройства Возвращается: всегда Пример: `"FGVMEVYYQT3AB5352"`
status строка	Указание результата операции Возвращается: всегда Пример: `"success"`
vdom строка	Использованный виртуальный домен Возвращается: всегда Пример: `"root"`
version строка	Версия FortiGate Возвращается: всегда Пример: `"v5.6.3"`

Авторы

Link Zheng (@chillancezen)
Jie Xue (@JieX19)
Hongbin Lu (@fgtdev-hblu)
Frank Shen (@frankshen01)
Miguel Angel Munoz (@mamunozgonzalez)
Nicolas Thomas (@thomnico)

Ссылки на сборку

© 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/fortios/fortios_switch_controller_vlan_policy_module.html