Spec-Zone.ru › Ansible

Модуль fortinet.fortios.fortios_switch_controller_lldp_profile — настройка профилей LLDP FortiSwitch в FortiOS и FortiGate от Fortinet.

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_switch_controller_lldp_profile.

Добавлено в fortinet.fortios 2.0.0

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

Обзор

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

Требования

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

  • ansible>=2.16

Параметры

Параметр

Комментарии

access_token

string

Аутентификация на основе токена. Токен создается в графическом интерфейсе FortiGate.

enable_log

boolean

Включить или отключить ведение журнала для задачи.

Варианты:

  • false ← (по умолчанию)
  • true

member_path

string

Путь к атрибуту элемента, с которым выполняется операция.

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

Параметр member_path можно использовать для выполнения операции с элементом.

member_state

string

Добавить или удалить элемент по указанному пути к атрибуту.

Если задан параметр member_state, параметр state игнорируется.

Варианты:

  • "present"
  • "absent"

state

string / обязательный

Указывает, следует ли создать или удалить объект.

Варианты:

  • "present"
  • "absent"

switch_controller_lldp_profile

dictionary

Настройка профилей LLDP FortiSwitch.

auto_isl

string

Включить или отключить автоматическое агрегирование каналов между коммутаторами (LAG).

Варианты:

  • "disable"
  • "enable"

auto_isl_auth

string

Режим аутентификации автоматического агрегирования каналов между коммутаторами (LAG).

Варианты:

  • "legacy"
  • "strict"
  • "relax"

auto_isl_auth_encrypt

string

Режим шифрования автоматического агрегирования каналов между коммутаторами (LAG).

Варианты:

  • "none"
  • "mixed"
  • "must"

auto_isl_auth_identity

string

Идентификатор аутентификации автоматического агрегирования каналов между коммутаторами (LAG).

auto_isl_auth_macsec_profile

string

Профиль MACsec для шифрования автоматического агрегирования каналов между коммутаторами (LAG).

auto_isl_auth_reauth

integer

Интервал повторной аутентификации автоматического агрегирования каналов между коммутаторами (LAG), в секундах (10–3600).

auto_isl_auth_user

string

Сертификат пользователя для аутентификации автоматического агрегирования каналов между коммутаторами (LAG).

auto_isl_hello_timer

integer

Длительность таймера hello для автоматического агрегирования каналов между коммутаторами (LAG), в секундах (1–30).

auto_isl_port_group

integer

Идентификатор группы портов для автоматического агрегирования каналов между коммутаторами (LAG) (0–9).

auto_isl_receive_timeout

integer

Тайм-аут автоматического агрегирования каналов между коммутаторами (LAG), если ответ не получен (3–90 сек.).

auto_mclag_icl

string

Включить или отключить межкорпусное соединение MCLAG.

Варианты:

  • "disable"
  • "enable"

custom_tlvs

list / elements=dictionary

Способ настройки для редактирования пользовательских записей TLV.

information_string

string

Строка информации, определяемая организацией (0–507 шестнадцатеричных байт).

name

string / обязательный

Имя TLV (не передается).

oui

string

Уникальный идентификатор организации (OUI) — трехбайтовое шестнадцатеричное число для этого TLV.

subtype

integer

Подтип, определяемый организацией (0–255).

med_location_service

list / elements=dictionary

Способ настройки для редактирования категорий TLV (тип-длина-значение) служб определения местоположения Media Endpoint Discovery (MED).

name

string / обязательный

Имя типа службы определения местоположения.

status

string

Включить или отключить этот TLV.

Варианты:

  • "disable"
  • "enable"

sys_location_id

string

Идентификатор службы определения местоположения. Источник: switch-controller.location.name.

med_network_policy

list / elements=dictionary

Способ настройки для редактирования категорий TLV (тип-длина-значение) сетевых политик Media Endpoint Discovery (MED).

assign_vlan

string

Включить или отключить назначение VLAN при применении этого профиля к управляемому порту FortiSwitch.

Варианты:

  • "disable"
  • "enable"

dscp

integer

Объявляемое значение кода дифференцированного обслуживания (DSCP) — значение заголовка пакета, указывающее требуемый уровень обслуживания трафика, например высокий приоритет или доставку по возможности.

name

string / обязательный

Имя типа политики.

priority

integer

Объявляемый приоритет уровня 2 (0–7; от низшего к высшему).

status

string

Включить или отключить этот TLV.

Варианты:

  • "disable"
  • "enable"

vlan

integer

Идентификатор объявляемой VLAN, если она настроена на порту (0–4094, 0 = тег приоритета).

vlan_intf

string

Объявляемый интерфейс VLAN, если он настроен на порту. Источник: system.interface.name.

med_tlvs

list / elements=string

Передаваемые TLV LLDP-MED (описания типа-длины-значения).

Варианты:

  • "inventory-management"
  • "network-policy"
  • "power-management"
  • "location-identification"

name

string / обязательный

Имя профиля.

tlvs_802dot1

list / elements=string

Передаваемые TLV IEEE 802.1.

Варианты:

  • "port-vlan-id"

tlvs_802dot3

list / elements=string

Передаваемые TLV IEEE 802.3.

Варианты:

  • "max-frame-size"
  • "power-negotiation"

vdom

string

Виртуальный домен из числа ранее определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство.

По умолчанию: "root"

Примечания

Примечание

  • Устаревший fortiosapi объявлен нерекомендуемым; для запуска плейбуков предпочтительно использовать httpapi
  • Модуль поддерживает check_mode.

Примеры

- name: Configure FortiSwitch LLDP profiles.
  fortinet.fortios.fortios_switch_controller_lldp_profile:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      switch_controller_lldp_profile:
          tlvs_802dot1: "port-vlan-id"
          tlvs_802dot3: "max-frame-size"
          auto_isl: "disable"
          auto_isl_auth: "legacy"
          auto_isl_auth_encrypt: "none"
          auto_isl_auth_identity: "<your_own_value>"
          auto_isl_auth_macsec_profile: "<your_own_value>"
          auto_isl_auth_reauth: "3600"
          auto_isl_auth_user: "<your_own_value>"
          auto_isl_hello_timer: "3"
          auto_isl_port_group: "0"
          auto_isl_receive_timeout: "60"
          auto_mclag_icl: "disable"
          custom_tlvs:
              -
                  information_string: "<your_own_value>"
                  name: "default_name_18"
                  oui: "<your_own_value>"
                  subtype: "0"
          med_location_service:
              -
                  name: "default_name_22"
                  status: "disable"
                  sys_location_id: "<your_own_value> (source switch-controller.location.name)"
          med_network_policy:
              -
                  assign_vlan: "disable"
                  dscp: "0"
                  name: "default_name_28"
                  priority: "0"
                  status: "disable"
                  vlan: "2047"
                  vlan_intf: "<your_own_value> (source system.interface.name)"
          med_tlvs: "inventory-management"
          name: "default_name_34"

Возвращаемые значения

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

Ключ

Описание

build

string

Номер сборки образа FortiGate

Возвращается: всегда

Пример: "1547"

http_method

string

Последний метод, использованный для передачи содержимого в FortiGate

Возвращается: всегда

Пример: "PUT"

http_status

string

Последний результат, полученный от FortiGate для последней выполненной операции

Возвращается: всегда

Пример: "200"

mkey

string

Главный ключ (идентификатор), использованный при последнем вызове FortiGate

Возвращается: при успехе

Пример: "id"

name

string

Имя таблицы, использованной для выполнения запроса

Возвращается: всегда

Пример: "urlfilter"

path

string

Путь к таблице, использованной для выполнения запроса

Возвращается: всегда

Пример: "webfilter"

revision

string

Внутренний номер редакции

Возвращается: всегда

Пример: "17.0.2.10658"

serial

string

Серийный номер устройства

Возвращается: всегда

Пример: "FGVMEVYYQT3AB5352"

status

string

Результат выполнения операции

Возвращается: всегда

Пример: "success"

vdom

string

Используемый виртуальный домен

Возвращается: всегда

Пример: "root"

version

string

Версия 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–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_lldp_profile_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API