vmware_dvs_portgroup - Создание или удаление группы портов распределённого коммутатора vSwitch.

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

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

Описание

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

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
hostname		Имя хоста или IP-адрес сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в версии 2.6.
network_policy (добавлено в 2.5)	Значение по умолчанию: {u'promiscuous': False, u'mac_changes': False, u'forged_transmits': False}	Словарь, определяющий различные параметры безопасности для группы портов. Допустимые атрибуты: - `promiscuous` (bool): разрешено ли использование promiscuous режима. (значение по умолчанию: false) - `forged_transmits` (bool): разрешены ли поддельные передачи. (значение по умолчанию: false) - `mac_changes` (bool): разрешены ли изменения MAC-адресов. (значение по умолчанию: false)
num_ports обязательно		Количество портов, которые должна содержать группа портов.
password		Пароль сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в версии 2.6. Псевдонимы: pass, pwd
port (добавлено в 2.5)	Значение по умолчанию: 443	Номер порта сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PORT`. Поддержка переменных окружения добавлена в версии 2.6.
port_policy (добавлено в 2.5)	Значение по умолчанию: {u'traffic_filter_override': False, u'network_rp_override': False, u'live_port_move': False, u'security_override': False, u'vendor_config_override': False, u'port_config_reset_at_disconnect': True, u'uplink_teaming_override': False, u'block_override': True, u'shaping_override': False, u'vlan_override': False, u'ipfix_override': False}	Словарь, определяющий расширенные параметры политики для группы портов. Допустимые атрибуты: - `block_override` (bool): можно ли изменять политику блокировки для каждого порта. (значение по умолчанию: true) - `ipfix_override` (bool): можно ли изменять политику ipfix для каждого порта. (значение по умолчанию: false) - `live_port_move` (bool): можно ли перемещать порт в или из группы портов в режиме реального времени. (значение по умолчанию: false) - `network_rp_override` (bool): можно ли изменять сетевой пул ресурсов для каждого порта. (значение по умолчанию: false) - `port_config_reset_at_disconnect` (bool): автоматически ли сбрасываются настройки порта после отключения. (значение по умолчанию: true) - `security_override` (bool): можно ли изменять политику безопасности для каждого порта. (значение по умолчанию: false) - `shaping_override` (bool): можно ли изменять политику формирования трафика для каждого порта. (значение по умолчанию: false) - `traffic_filter_override` (bool): можно ли изменять фильтр трафика для каждого порта. (значение по умолчанию: false) - `uplink_teaming_override` (bool): можно ли изменять политику объединения каналов для каждого порта. (значение по умолчанию: false) - `vendor_config_override` (bool): можно ли изменять конфигурацию поставщика для каждого порта. (значение по умолчанию: false) - `vlan_override` (bool): можно ли изменять VLAN для каждого порта. (значение по умолчанию: false)
portgroup_name обязательно		Имя группы портов, которое необходимо создать или удалить.
portgroup_type обязательно	Варианты: earlyBinding lateBinding ephemeral	См. базу знаний VMware 1022312 относительно типов групп портов.
state обязательно (добавлено в 2.5)	Варианты: no yes	Определяет, должна ли группа портов присутствовать.
switch_name обязательно		Имя распределённого коммутатора vSwitch, на котором должна быть создана группа портов.
teaming_policy (добавлено в 2.5)	Значение по умолчанию: {u'notify_switches': True, u'load_balance_policy': u'loadbalance_srcid', u'inbound_policy': False, u'rolling_order': False}	Словарь, определяющий различные параметры объединения каналов для группы портов. Допустимые атрибуты: - `load_balance_policy` (строка): Политика объединения сетевых адаптеров. (значение по умолчанию: loadbalance_srcid) - варианты: [ loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, failover_explicit] - `inbound_policy` (bool): применяется ли политика объединения к входящим кадрам. (значение по умолчанию: False) - `notify_switches` (bool): уведомляются ли физические коммутаторы о сбое соединения. (значение по умолчанию: True) - `rolling_order` (bool): используется ли пошаговая политика при восстановлении соединения. (значение по умолчанию: False)
username		Имя пользователя сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в версии 2.6. Псевдонимы: user, admin
validate_certs	Варианты: no yes Значение по умолчанию: True	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `false`, когда сертификаты ненадёжны. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в версии 2.6.
vlan_id обязательно		Идентификатор VLAN, который должен быть настроен для группы портов. Используйте 0 для отсутствия VLAN. Если `vlan_trunk` установлено в true, это может быть диапазон, например: 1-4094.
vlan_trunk (добавлено в 2.5)	Варианты: нет ← да	Указывает, является ли это VLAN-шлейфом.

Примечания

Примечание

Проверено на vSphere 5.5
Проверено на vSphere 6.5

Примеры

- name: Create vlan portgroup
  connection: local
  vmware_dvs_portgroup:
     hostname: vcenter_ip_or_hostname
     username: vcenter_username
     password: vcenter_password
     portgroup_name: vlan-123-portrgoup
     switch_name: dvSwitch
     vlan_id: 123
     num_ports: 120
     portgroup_type: earlyBinding
     state: present

- name: Create vlan trunk portgroup
  connection: local
  vmware_dvs_portgroup:
     hostname: vcenter_ip_or_hostname
     username: vcenter_username
     password: vcenter_password
     portgroup_name: vlan-trunk-portrgoup
     switch_name: dvSwitch
     vlan_id: 1-1000
     vlan_trunk: True
     num_ports: 120
     portgroup_type: earlyBinding
     state: present

- name: Create no-vlan portgroup
  connection: local
  vmware_dvs_portgroup:
     hostname: vcenter_ip_or_hostname
     username: vcenter_username
     password: vcenter_password
     portgroup_name: no-vlan-portrgoup
     switch_name: dvSwitch
     vlan_id: 0
     num_ports: 120
     portgroup_type: earlyBinding
     state: present

- name: Create vlan portgroup with all security and port policies
  connection: local
  vmware_dvs_portgroup:
     hostname: vcenter_ip_or_hostname
     username: vcenter_username
     password: vcenter_password
     portgroup_name: vlan-123-portrgoup
     switch_name: dvSwitch
     vlan_id: 123
     num_ports: 120
     portgroup_type: earlyBinding
     state: present
     network_policy:
       promiscuous: yes
       forged_transmits: yes
       mac_changes: yes
     port_policy:
       block_override: yes
       ipfix_override: yes
       live_port_move: yes
       network_rp_override: yes
       port_config_reset_at_disconnect: yes
       security_override: yes
       shaping_override: yes
       traffic_filter_override: yes
       uplink_teaming_override: yes
       vendor_config_override: yes
       vlan_override: yes

Статус

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

Автор

Joseph Callen (@jcpowermac)
Philippe Dellaert (@pdellaert) <philippe@dellaert.org>

Подсказка

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

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