Модуль community.vmware.vmware_dvswitch_uplink_pg — Управление конфигурацией группы портов uplink распределённого коммутатора

Примечание

Этот модуль входит в коллекцию community.vmware (версия 4.7.1).

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

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

Чтобы использовать его в плейбуке, укажите: community.vmware.vmware_dvswitch_uplink_pg.

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

Описание

Этот модуль можно использовать для настройки группы портов uplink распределённого коммутатора.

Параметры

Параметр	Комментарии
advanced aliases: port_policy словарь	Словарь, настраивающий расширенные параметры политики для uplink-группы портов. По умолчанию: `{"block_override": true, "netflow_override": false, "port_config_reset_at_disconnect": true, "traffic_filter_override": false, "vendor_config_override": false, "vlan_override": false}`
block_override логическое	Указывает, можно ли изменить политику блокировки для каждого порта. Возможные значения: `false` `true` ← (по умолчанию)
netflow_override логическое	Указывает, можно ли изменить политику NetFlow для каждого порта. Возможные значения: `false` ← (по умолчанию) `true`
port_config_reset_at_disconnect логическое	Указывает, сбрасываются ли настройки порта автоматически после отключения. Возможные значения: `false` `true` ← (по умолчанию)
traffic_filter_override логическое	Указывает, можно ли изменить фильтр трафика для каждого порта. Возможные значения: `false` ← (по умолчанию) `true`
vendor_config_override логическое	Указывает, можно ли изменить конфигурацию поставщика для каждого порта. Возможные значения: `false` ← (по умолчанию) `true`
vlan_override логическое	Указывает, можно ли изменить VLAN для каждого порта. Возможные значения: `false` ← (по умолчанию) `true`
block_all_ports логическое	Указывает, заблокированы ли все порты в uplink-группе портов. Возможные значения: `false` ← (по умолчанию) `true`
description строка	Описание uplink-группы портов.
hostname строка	Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`.
lacp словарь	Словарь, настраивающий параметры LACP для uplink-группы портов. Параметры используются только в том случае, если режим поддержки LACP установлен в «basic». По умолчанию: `{"mode": "passive", "status": "disabled"}`
mode строка	Состояние переговоров uplink/портов. Возможные значения: `"active"` `"passive"` ← (по умолчанию)
status строка	Указывает, включен ли LACP. Возможные значения: `"enabled"` `"disabled"` ← (по умолчанию)
name строка	Имя uplink-группы портов. Если не указано, будет использоваться текущее имя.
netflow_enabled логическое	Указывает, включен ли NetFlow в uplink-группе портов. Возможные значения: `false` ← (по умолчанию) `true`
password aliases: pass, pwd строка	Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`.

END_OF_DOCUMENT_MARKER

порт целое число	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`. По умолчанию: `443`
proxy_host строка	Адрес прокси-сервера, который будет принимать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_HOST`.
proxy_port целое число	Порт HTTP-прокси-сервера, который будет принимать все запросы HTTPS и пересылать их. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
switch псевдонимы: dvswitch строка / обязательно	Имя распределённого коммутатора.
username псевдонимы: admin, user строка	Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`.
validate_certs булево	Разрешает подключение, когда сертификаты SSL недействительны. Устанавливается в `false`, когда сертификаты ненадёжны. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
vlan_trunk_range список / элементы=строка	Диапазон VLAN-туннелей, который должен быть настроен с группой портов uplink. Может быть комбинацией нескольких диапазонов и чисел, например: [ 2-3967, 4049-4092 ]. По умолчанию: `["0-4094"]`

Примечания

Примечание

Все модули требуют доступа к API для записи и поэтому не поддерживаются в бесплатной лицензии ESXi.
Все имена переменных и объектов VMware чувствительны к регистру.

Примеры

- name: Configure Uplink portgroup
  community.vmware.vmware_dvswitch_uplink_pg:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcsa_username }}'
    password: '{{ vcsa_password }}'
    switch: dvSwitch
    name: dvSwitch-DVUplinks
    advanced:
      port_config_reset_at_disconnect: true
      block_override: true
      vendor_config_override: false
      vlan_override: false
      netflow_override: false
      traffic_filter_override: false
    vlan_trunk_range:
      - '0-4094'
    netflow_enabled: false
    block_all_ports: false
  delegate_to: localhost

- name: Enabled LACP on Uplink portgroup
  community.vmware.vmware_dvswitch_uplink_pg:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcsa_username }}'
    password: '{{ vcsa_password }}'
    switch: dvSwitch
    lacp:
      status: enabled
      mode: active
  delegate_to: localhost

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

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

Ключ	Описание
result строка	информация об операции Возвращается: всегда Пример: `"{'adv_block_ports': True, 'adv_netflow': False, 'adv_reset_at_disconnect': True, 'adv_traffic_filtering': False, 'adv_vendor_conf': False, 'adv_vlan': False, 'block_all_ports': False, 'changed': False, 'description': None, 'dvswitch': 'dvSwitch', 'lacp_status': 'disabled', 'lacp_status_previous': 'enabled', 'name': 'dvSwitch-DVUplinks', 'netflow_enabled': False, 'result': 'Uplink portgroup already configured properly', 'vlan_trunk_range': ['2-3967', '4049-4092']}"`

Ключ

Описание

result

строка

информация об операции

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

Пример: "{'adv_block_ports': True, 'adv_netflow': False, 'adv_reset_at_disconnect': True, 'adv_traffic_filtering': False, 'adv_vendor_conf': False, 'adv_vlan': False, 'block_all_ports': False, 'changed': False, 'description': None, 'dvswitch': 'dvSwitch', 'lacp_status': 'disabled', 'lacp_status_previous': 'enabled', 'name': 'dvSwitch-DVUplinks', 'netflow_enabled': False, 'result': 'Uplink portgroup already configured properly', 'vlan_trunk_range': ['2-3967', '4049-4092']}"

Авторы

Christian Kotte (@ckotte)

Ссылки на коллекцию

© 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/community/vmware/vmware_dvswitch_uplink_pg_module.html