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

Примечание

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

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

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

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

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

Краткое описание

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

Параметры

Параметр	Комментарии
advanced псевдонимы: port_policy словарь	Словарь, задающий дополнительные параметры политики для группы портов восходящего канала. По умолчанию: `{"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 логический	Указывает, заблокированы ли все порты группы портов восходящего канала. Варианты: `false` ← (по умолчанию) `true`
description строка	Описание группы портов восходящего канала.
hostname строка	Имя узла или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_HOST`.
lacp словарь	Словарь, задающий параметры LACP для группы портов восходящего канала. Эти параметры используются, только если для режима поддержки LACP задано значение ‘basic’. По умолчанию: `{"mode": "passive", "status": "disabled"}`
mode строка	Состояние согласования восходящих каналов/портов. Варианты: `"active"` `"passive"` ← (по умолчанию)
status строка	Указывает, включен ли LACP. Варианты: `"enabled"` `"disabled"` ← (по умолчанию)
name строка	Имя группы портов восходящего канала. Если имя не указано, будет использовано текущее.
netflow_enabled логический	Указывает, включен ли NetFlow для группы портов восходящего канала. Варианты: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd строка	Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PASSWORD`.
port целое число	Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PORT`. По умолчанию: `443`
proxy_host строка	Адрес прокси-сервера, который будет получать и перенаправлять все HTTPS-запросы. Укажите имя узла или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_HOST`.
proxy_port целое число	Порт HTTP-прокси-сервера, который будет получать и перенаправлять все HTTPS-запросы. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
switch псевдонимы: dvswitch строка / обязательный	Имя распределенного коммутатора.
username псевдонимы: admin, user строка	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_USER`.
validate_certs логический	Разрешает подключение при недействительных SSL-сертификатах. Установите значение `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
vlan_trunk_range список / элементы=строка	Диапазон VLAN trunk, который следует настроить для группы портов восходящего канала. Можно указать несколько диапазонов и номеров, например: [ 2-3967, 4049-4092 ]. По умолчанию: `["0-4094"]`

Примечания

Примечание

Всем модулям необходим доступ к API на запись, поэтому они не поддерживаются при использовании бесплатной лицензии ESXi.
Имена всех переменных и объектов VMware чувствительны к регистру.
Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не использует системное хранилище сертификатов. Чтобы указать хранилище сертификатов, задайте переменную среды REQUESTS_CA_BUNDLE. Обратите внимание: если эта переменная задана, в некоторых случаях значение ‘false’ для параметра ‘validate_certs’ может быть проигнорировано. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/vmware/vmware_dvswitch_uplink_pg_module.html