vmware_dvswitch_uplink_pg – Управление конфигурацией порта-группы для верхнего уровня распределённого коммутатора

Новое в версии 2.8.

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

Описание

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

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
advanced словарь	Значение по умолчанию: {"block_override": true, "netflow_override": false, "port_config_reset_at_disconnect": true, "traffic_filter_override": false, "vendor_config_override": false, "vlan_override": false}	Словарь, который настраивает расширенные параметры политики для порта-группы верхнего уровня. Допустимые атрибуты: - `port_config_reset_at_disconnect` (bool): указывает, будет ли автоматически сброшена конфигурация порта после отключения. (по умолчанию: true) - `block_override` (bool): указывает, может ли политика блокировки изменяться на уровне порта. (по умолчанию: true) - `netflow_override` (bool): указывает, может ли политика NetFlow изменяться на уровне порта. (по умолчанию: false) - `traffic_filter_override` (bool): указывает, может ли политика фильтрации трафика изменяться на уровне порта. (по умолчанию: false) - `vendor_config_override` (bool): указывает, может ли конфигурация вендора изменяться на уровне порта. (по умолчанию: false) - `vlan_override` (bool): указывает, может ли VLAN изменяться на уровне порта. (по умолчанию: false) псевдонимы: port_policy
block_all_ports булево	Варианты: нет ← да	Указывает, заблокированы ли все порты на порта-группе верхнего уровня.
description строка		Описание порта-группы верхнего уровня.
hostname строка		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
lacp словарь	Значение по умолчанию: {"mode": "passive", "status": "disabled"}	Словарь, который настраивает параметры LACP для порта-группы верхнего уровня. Эти параметры используются только если режим поддержки LACP установлен в «basic». Необходимые параметры: - `status` (строка): Указывает, включен ли LACP. (по умолчанию: disabled) - `mode` (строка): Состояние согласования каналов/портов. (по умолчанию: passive)
name строка		Имя порта-группы верхнего уровня. Если не указано, используется текущее имя.
netflow_enabled булево	Варианты: нет ← да	Указывает, включен ли NetFlow на порта-группе верхнего уровня.
password строка		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число добавлено в 2.5	Значение по умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в Ansible 2.6.
proxy_host строка добавлено в 2.9		Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12
proxy_port целое число добавлено в 2.9		Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
switch строка / обязательно		Имя распределённого коммутатора. псевдонимы: dvswitch
username строка		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs булево	Варианты: нет да ←	Разрешает подключение, когда SSL-сертификаты недействительны. Установите в `false`, если сертификаты ненадёжные. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
vlan_trunk_range список	Значение по умолчанию: ["0-4094"]	Диапазон VLAN-транка, который следует настроить с порта-группой верхнего уровня. Это может быть комбинация нескольких диапазонов и чисел, например: [ 2-3967, 4049-4092 ].

Примечания

Примечание

Проверено на vSphere 6.5 и 6.7

Примеры

- name: Configure Uplink portgroup
  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
  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': 'Порта-группа верхнего уровня уже настроена должным образом', 'vlan_trunk_range': ['2-3967', '4049-4092']}

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Christian Kotte (@ckotte)

Подсказка

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

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