vmware_dvs_portgroup - Создание или удаление группы портов распределённого коммутатора vSwitch.
Новая версия 2.0.
Описание
- Создание или удаление группы портов распределённого коммутатора vSwitch.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| hostname str | Имя хоста или IP-адрес сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST. Поддержка переменных окружения добавлена в версии 2.6. | |
| network_policy (добавлено в 2.5) | По умолчанию: {"forged_transmits": false, "mac_changes": false, "promiscuous": false} | Словарь, который настраивает различные значения безопасности для группы портов. Допустимые атрибуты: - promiscuous (bool): указывает, разрешён ли режим promiscuous. (по умолчанию: false)- forged_transmits (bool): указывает, разрешены ли forged transmits. (по умолчанию: false)- mac_changes (bool): указывает, разрешены ли изменения MAC-адресов. (по умолчанию: false) |
| num_ports обязательно | Количество портов, которые должна содержать группа портов. | |
| password str | Пароль от сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD. Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: pass, pwd | |
| port int (добавлено в 2.5) | По умолчанию: 443 | Номер порта сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PORT. Поддержка переменных окружения добавлена в версии 2.6. |
| port_policy (добавлено в 2.5) | По умолчанию: {"block_override": true, "ipfix_override": false, "live_port_move": false, "network_rp_override": false, "port_config_reset_at_disconnect": true, "security_override": false, "shaping_override": false, "traffic_filter_override": false, "uplink_teaming_override": false, "vendor_config_override": false, "vlan_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 обязательно |
| См. базу знаний VMware 1022312 по типам групп портов. |
| state bool обязательно (добавлено в 2.5) |
| Определяет, должна ли группа портов присутствовать или нет. |
| switch_name обязательно | Имя распределённого коммутатора vSwitch, на котором должна быть создана группа портов. | |
| teaming_policy (добавлено в 2.5) | По умолчанию: {"inbound_policy": false, "load_balance_policy": "loadbalance_srcid", "notify_switches": true, "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 str | Имя пользователя сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER. Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: admin, user | |
| validate_certs bool |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите в значение false, когда сертификаты ненадёжны.Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_VALIDATE_CERTS. Поддержка переменных окружения добавлена в версии 2.6. Если установлено значение yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
| vlan_id обязательно | Идентификатор VLAN, который должен быть настроен для группы портов, используйте 0 для отсутствия VLAN. Если vlan_trunk настроено на true, это может быть диапазон, например: 1-4094. | |
| vlan_trunk bool (добавлено в 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
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.
Автор
- 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.6/modules/vmware_dvs_portgroup_module.html
