Модуль community.vmware.vmware_dvs_portgroup — создание или удаление группы портов распределенного vSwitch.

Примечание

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

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

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

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

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

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

Создание или удаление группы портов распределенного vSwitch.

Параметры

Параметр	Комментарии
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_HOST`.
in_traffic_shaping dictionary	Словарь, задающий параметры формирования входящего трафика для группы портов.
average_bandwidth integer	Задает среднее во времени количество битов в секунду, разрешенное для передачи через порт, то есть допустимую среднюю нагрузку. Игнорируется, если `in_traffic_shaping.inherited=true`.
burst_size integer	Максимальное количество битов в секунду, разрешенное для передачи через порт при отправке/отправке или получении всплеска трафика. Игнорируется, если `in_traffic_shaping.inherited=true`.
enabled boolean	Указывает, включено ли формирование входящего трафика. Игнорируется, если `in_traffic_shaping.inherited=true`. Варианты: `false` `true`
inherited boolean / обязательный	Наследовать ли параметры коммутатора. Варианты: `false` `true`
peak_bandwidth integer	Максимальное количество байтов, разрешенное для передачи при всплеске. Игнорируется, если `in_traffic_shaping.inherited=true`.
mac_learning dictionary	Этот параметр устарел; вместо него следует использовать `network_policy.mac_learning`. Он будет удален в версии 7.0.0. Словарь, задающий параметры обучения MAC-адресов для группы портов. Игнорируется, если `network_policy.inherited=true`. Игнорируется, если задано `network_policy.mac_learning`. Обратите внимание: включение этого параметра может отключить наследование неразборчивого режима и других параметров!
allow_unicast_flooding boolean	Флаг, разрешающий рассылку входящего трафика на MAC-адреса, которые еще не были изучены. Варианты: `false` `true`
enabled boolean	Флаг, указывающий, разрешено ли обучение исходным MAC-адресам. Варианты: `false` `true`
limit integer	Максимальное количество MAC-адресов, которые можно изучить.
limit_policy string	Политика коммутации по умолчанию после превышения лимита MAC-адресов. Варианты: `"allow"` `"drop"`
net_flow string	Указывает, следует ли анализировать IP-трафик виртуальных машин, проходящий через vds, отправляя отчеты сборщику NetFlow. Варианты: `"true"` `"on"` `"yes"` `"false"` `"off"` `"no"` `"inherited"`
network_policy dictionary	Словарь, задающий различные параметры безопасности для группы портов.
forged_transmits boolean	Указывает, разрешена ли отправка поддельных пакетов. Игнорируется, если `network_policy.inherited=true`. Варианты: `false` `true`
inherited boolean / обязательный	Наследовать ли параметры коммутатора. Обратите внимание: включение этого параметра также приведет к наследованию конфигурации обучения MAC-адресов (`mac_learning`) от коммутатора! Варианты: `false` `true`
mac_changes boolean	Указывает, разрешено ли изменение MAC-адресов. Игнорируется, если `network_policy.inherited=true`. Варианты: `false` `true`
mac_learning dictionary добавлено в community.vmware 5.6.0	Настройка обучения MAC-адресов для группы портов. Игнорируется, если `network_policy.inherited=true`.
allow_unicast_flooding boolean	Флаг, разрешающий рассылку входящего трафика на MAC-адреса, которые еще не были изучены. Варианты: `false` `true`
enabled boolean	Флаг, указывающий, разрешено ли обучение исходным MAC-адресам. Варианты: `false` `true`
limit integer	Максимальное количество MAC-адресов, которые можно изучить.
limit_policy string	Политика коммутации по умолчанию после превышения лимита MAC-адресов. Варианты: `"allow"` `"drop"`
promiscuous boolean	Указывает, разрешен ли неразборчивый режим. Игнорируется, если `network_policy.inherited=true`. Варианты: `false` `true`
num_ports integer	Количество портов, которое должна содержать группа портов.
out_traffic_shaping dictionary	Словарь, задающий параметры формирования исходящего трафика для группы портов.
average_bandwidth integer	Задает среднее во времени количество битов в секунду, разрешенное для передачи через порт, то есть допустимую среднюю нагрузку. Игнорируется, если `out_traffic_shaping.inherited=true`.
burst_size integer	Максимальное количество битов в секунду, разрешенное для передачи через порт при отправке/отправке или получении всплеска трафика. Игнорируется, если `out_traffic_shaping.inherited=true`.
enabled boolean	Указывает, включено ли формирование исходящего трафика. Игнорируется, если `out_traffic_shaping.inherited=true`. Варианты: `false` `true`
inherited boolean / обязательный	Наследовать ли параметры коммутатора. Варианты: `false` `true`
peak_bandwidth integer	Максимальное количество байтов, разрешенное для передачи при всплеске. Игнорируется, если `out_traffic_shaping.inherited=true`.
password псевдонимы: pass, pwd string	Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PASSWORD`.
port integer	Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PORT`. По умолчанию: `443`
port_allocation string	Эластичные группы портов автоматически увеличивают или уменьшают количество портов по мере необходимости. Допустимо только при `port_binding=static`. Если не указано, будет установлено значение `elastic` при `port_binding=static`. Если не указано, будет установлено значение `fixed` при `port_binding=ephemeral`. Варианты: `"elastic"` `"fixed"`
port_binding string / обязательный	Тип привязки портов определяет, когда порты в группе портов назначаются виртуальным машинам. Дополнительные сведения см. в статье VMware KB 1022312 https://kb.vmware.com/s/article/1022312. Варианты: `"static"` `"ephemeral"`
port_policy dictionary	Словарь, задающий расширенные параметры политики для группы портов. По умолчанию: `{"block_override": true, "ipfix_override": false, "live_port_move": false, "mac_management_override": false, "network_rp_override": false, "port_config_reset_at_disconnect": true, "shaping_override": false, "traffic_filter_override": false, "uplink_teaming_override": false, "vendor_config_override": false, "vlan_override": false}`
block_override boolean	Указывает, можно ли изменять политику блокировки для каждого порта. Варианты: `false` `true` ← (по умолчанию)
ipfix_override boolean	Указывает, можно ли изменять политику ipfix для каждого порта. Варианты: `false` ← (по умолчанию) `true`
live_port_move boolean	Указывает, можно ли переместить активный порт в группу портов или из нее. Варианты: `false` ← (по умолчанию) `true`
mac_management_override boolean	Указывает, можно ли изменять политику безопасности для каждого порта. Варианты: `false` ← (по умолчанию) `true`
network_rp_override boolean	Указывает, можно ли изменять пул сетевых ресурсов для каждого порта. Варианты: `false` ← (по умолчанию) `true`
port_config_reset_at_disconnect boolean	Указывает, сбрасывается ли конфигурация порта автоматически после отключения. Варианты: `false` `true` ← (по умолчанию)
shaping_override boolean	Указывает, можно ли изменять политику формирования трафика для каждого порта. Варианты: `false` ← (по умолчанию) `true`
traffic_filter_override boolean	Указывает, можно ли изменять фильтр трафика для каждого порта. Варианты: `false` ← (по умолчанию) `true`
uplink_teaming_override boolean	Указывает, можно ли изменять политику объединения восходящих каналов для каждого порта. Варианты: `false` ← (по умолчанию) `true`
vendor_config_override boolean	Указывает, можно ли изменять конфигурацию поставщика для каждого порта. Варианты: `false` ← (по умолчанию) `true`
vlan_override boolean	Указывает, можно ли изменять vlan для каждого порта. Варианты: `false` ← (по умолчанию) `true`
portgroup_description псевдонимы: description string	Описание группы портов
portgroup_name string / обязательный	Имя создаваемой или удаляемой группы портов.
proxy_host string	Адрес прокси-сервера, который будет получать все HTTPS-запросы и перенаправлять их. Формат: имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PROXY_HOST`.

proxy_port integer	Порт HTTP-прокси, который будет принимать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_PROXY_PORT`.
state string	Определяет, должна ли группа портов существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
switch_name string / обязательный	Имя распределённого vSwitch, на котором должна быть создана группа портов.
teaming_policy dictionary	Словарь, задающий различные параметры объединения сетевых адаптеров для группы портов. По умолчанию: `{"load_balance_policy": "loadbalance_srcid", "notify_switches": true, "rolling_order": false}`
active_uplinks list / elements=string	Список активных восходящих каналов, используемых для балансировки нагрузки.
inbound_policy boolean	Указывает, применяется ли политика объединения сетевых адаптеров также к входящим кадрам. Варианты: `false` `true`
load_balance_policy string	Политика объединения сетевых адаптеров. Варианты: `"loadbalance_ip"` `"loadbalance_srcmac"` `"loadbalance_srcid"` ← (по умолчанию) `"loadbalance_loadbased"` `"failover_explicit"`
notify_switches boolean	Указывает, нужно ли уведомлять физический коммутатор при отказе канала связи. Варианты: `false` `true` ← (по умолчанию)
rolling_order boolean	Указывает, следует ли использовать последовательную политику при восстановлении каналов связи. Варианты: `false` ← (по умолчанию) `true`
standby_uplinks list / elements=string	Список резервных восходящих каналов, используемых для переключения при отказе.
username псевдонимы: admin, user string	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_USER`.
validate_certs boolean	Разрешает подключение, если SSL-сертификаты недействительны. Установите значение `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использоваться значение переменной окружения `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
vlan_id string / обязательный	Идентификатор VLAN, который следует настроить для группы портов; укажите 0, если VLAN не используется. Если `vlan_trunk=true`, здесь можно указать сочетание нескольких диапазонов и чисел, например: 1-200, 205, 400-4094. Допустимый диапазон — от 0 до 4094. Перекрывающиеся диапазоны разрешены. Если `vlan_private=true`, соответствующая частная VLAN уже должна быть настроена в распределённом vSwitch.
vlan_private boolean	Указывает, предназначен ли этот параметр для частной VLAN. Взаимоисключающий параметр с `vlan_trunk`. Варианты: `false` ← (по умолчанию) `true`
vlan_trunk boolean	Указывает, является ли это транковым соединением VLAN. Взаимоисключающий параметр с `vlan_private`. Варианты: `false` ← (по умолчанию) `true`

Примечания

Примечание

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

Примеры

- name: Create vlan portgroup
  community.vmware.vmware_dvs_portgroup:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    portgroup_name: vlan-123-portrgoup
    switch_name: dvSwitch
    vlan_id: 123
    num_ports: 120
    port_binding: static
    state: present
  delegate_to: localhost

- name: Create vlan trunk portgroup
  community.vmware.vmware_dvs_portgroup:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    portgroup_name: vlan-trunk-portrgoup
    portgroup_description: 'Trunk 1-1000, 1005, 1100-1200'
    switch_name: dvSwitch
    vlan_id: 1-1000, 1005, 1100-1200
    vlan_trunk: true
    num_ports: 120
    port_binding: static
    state: present
  delegate_to: localhost

- name: Create private vlan portgroup
  vmware_dvs_portgroup:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    portgroup_name: private-vlan-portrgoup
    switch_name: dvSwitch
    vlan_id: 1001
    vlan_private: true
    num_ports: 120
    port_binding: static
    state: present
  delegate_to: localhost

- name: Create no-vlan portgroup
  community.vmware.vmware_dvs_portgroup:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    portgroup_name: no-vlan-portrgoup
    switch_name: dvSwitch
    vlan_id: 0
    num_ports: 120
    port_binding: static
    state: present
  delegate_to: localhost

- name: Create vlan portgroup with all security and port policies
  community.vmware.vmware_dvs_portgroup:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    portgroup_name: vlan-123-portrgoup
    switch_name: dvSwitch
    vlan_id: 123
    num_ports: 120
    port_binding: static
    state: present
    network_policy:
      inherited: false
      promiscuous: true
      forged_transmits: true
      mac_changes: true
    port_policy:
      block_override: true
      ipfix_override: true
      live_port_move: true
      network_rp_override: true
      port_config_reset_at_disconnect: true
      mac_management_override: true
      shaping_override: true
      traffic_filter_override: true
      uplink_teaming_override: true
      vendor_config_override: true
      vlan_override: true
  delegate_to: localhost

Авторы

Joseph Callen (@jcpowermac)
Philippe Dellaert (@pdellaert)

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

© 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_dvs_portgroup_module.html