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

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

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

Обзор

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

Требования

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

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}	Словарь, который настраивает дополнительные параметры политики для группы портов Uplink. Допустимые атрибуты: - `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 boolean	Варианты: нет ← да	Указывает, заблокированы ли все порты в группе портов Uplink.
description string		Описание группы портов Uplink.
hostname string		Имя хоста или IP-адрес сервера vCenter vSphere или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
lacp -	Значение по умолчанию: {"mode": "passive", "status": "disabled"}	Словарь, который настраивает параметры LACP для группы портов Uplink. Эти параметры используются только если режим поддержки LACP установлен в 'basic'. Необходимые параметры: - `status` (str): Указывает, включён ли LACP. (по умолчанию: выключен) - `mode` (str): Состояние переговоров для uplinks/портов. (по умолчанию: пассивный)
name string		Имя группы портов Uplink. Если не указано, используется текущее имя.
netflow_enabled boolean	Варианты: нет ← да	Указывает, включён ли NetFlow в группе портов Uplink.
password string		Пароль сервера vCenter vSphere или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port integer добавлено в 2.5	Значение по умолчанию: 443	Номер порта сервера vCenter vSphere или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в Ansible 2.6.
switch string / обязательно		Имя распределённого коммутатора. псевдонимы: dvswitch
username string		Имя пользователя сервера vCenter vSphere или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs boolean	Варианты: нет да ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `false`, когда сертификаты ненадёжны. Если значение не указано в задаче, используется значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено в `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
vlan_trunk_range list	Значение по умолчанию: ["0-4094"]	Диапазон VLAN trunk, который должен быть настроен с группой портов Uplink. Может быть сочетанием нескольких диапазонов и чисел, например: [ 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 string	всегда	информация об операции Пример: {'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 уже правильно настроена', '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.8/modules/vmware_dvswitch_uplink_pg_module.html