fortios_switch_controller_vlan – Настройка VLAN для контроллера коммутатора в Fortinet’s FortiOS и FortiGate

Новая версия 2.9.

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

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

Требования

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

fortiosapi>=0.9.8

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
host строка				IP-адрес FortiOS или FortiGate.
https булево			Варианты: нет да ←	Указывает, должны ли запросы к FortiGate использовать протокол HTTPS.
password строка			Значение по умолчанию: ""	Пароль FortiOS или FortiGate.
ssl_verify булево			Варианты: нет да ←	Обеспечивает проверку сертификата FortiGate надёжным центром сертификации.
state строка / обязательно			Варианты: present absent	Указывает, нужно ли создать или удалить объект.
switch_controller_vlan словарь			Значение по умолчанию: null	Настройка VLAN для контроллера коммутатора.
	auth строка		Варианты: radius usergroup	Аутентификация.
	color целое число			Цвет значка на графическом интерфейсе.
	comments строка			Комментарий.
	name строка / обязательно			Имя VLAN коммутатора.
	portal_message_override_group строка			Укажите группу для замены сообщений портала.
	portal_message_overrides словарь			Отдельные замены сообщений.
		auth_disclaimer_page строка		Замена сообщения auth-disclaimer-page сообщением из группы portal-message-overrides.
		auth_login_failed_page строка		Замена сообщения auth-login-failed-page сообщением из группы portal-message-overrides.
		auth_login_page строка		Замена сообщения auth-login-page сообщением из группы portal-message-overrides.
		auth_reject_page строка		Замена сообщения auth-reject-page сообщением из группы portal-message-overrides.
	radius_server строка			Сервер радиуса аутентификации. Имя пользователя источника user.radius.name.
	security строка		Варианты: открытый портал-захват 8021x	Безопасность.
	selected_usergroups список			Выбранная группа пользователей.
		name строка / обязательно		Имя группы пользователей. Источник user.group.name.
	usergroup строка			Группа пользователей для аутентификации. Источник user.group.name.
	vdom строка			Виртуальная область.
	vlanid целое число			Идентификатор VLAN.
username строка				Имя пользователя FortiOS или FortiGate.
vdom строка			Значение по умолчанию: "root"	Виртуальная область, определённая ранее. VDOM — виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство.

Примечания

Примечание

Требуется библиотека fortiosapi, разработанная Fortinet
Выполняется как local_action в вашем playbook

Примеры

- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
   ssl_verify: "False"
  tasks:
  - name: Configure VLANs for switch controller.
    fortios_switch_controller_vlan:
      host:  "{{ host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{ vdom }}"
      https: "False"
      state: "present"
      switch_controller_vlan:
        auth: "radius"
        color: "4"
        comments: "<your_own_value>"
        name: "default_name_6"
        portal_message_override_group: "<your_own_value>"
        portal_message_overrides:
            auth_disclaimer_page: "<your_own_value>"
            auth_login_failed_page: "<your_own_value>"
            auth_login_page: "<your_own_value>"
            auth_reject_page: "<your_own_value>"
        radius_server: "<your_own_value> (source user.radius.name)"
        security: "open"
        selected_usergroups:
         -
            name: "default_name_16 (source user.group.name)"
        usergroup: "<your_own_value> (source user.group.name)"
        vdom: "<your_own_value>"
        vlanid: "19"

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

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

Ключ	Возвращаемое значение	Описание
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 строка	всегда	Указание результата операции Пример: успех
vdom строка	всегда	Использованный виртуальный домен Пример: root
version строка	всегда	Версия FortiGate Пример: v5.6.3

Статус

Этот модуль не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Miguel Angel Munoz (@mamunozgonzalez)
Nicolas Thomas (@thomnico)

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/fortios_switch_controller_vlan_module.html