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

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

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

Обзор

Этот модуль может быть использован для настройки частных VLAN (PVLAN) на коммутаторе распределённой сети.

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
hostname строка		Имя хоста или IP-адрес сервера vCenter vSphere или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
password строка		Пароль сервера vCenter vSphere или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число добавлено в 2.5	По умолчанию: 443	Номер порта сервера vCenter vSphere или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_PORT`. Поддержка переменных окружения добавлена в Ansible 2.6.
primary_pvlans список	По умолчанию: []	Список идентификаторов VLAN, которые должны быть настроены как первичные PVLAN. Если `primary_pvlans` не указано, все PVLAN будут удалены, если присутствуют. Каждый элемент списка требует установленного primary_pvlan_id (целое число). Вторичный promiscuous PVLAN будет создан автоматически. Если `secondary_pvlans` не указано, первичные PVLAN и каждый вторичный promiscuous PVLAN будут созданы. См. примеры для получения дополнительной информации.
secondary_pvlans список	По умолчанию: []	Список идентификаторов VLAN, которые должны быть настроены как вторичные PVLAN. `primary_pvlans` необходимо указать для создания вторичного PVLAN. Если `primary_pvlans` не указано, все PVLAN будут удалены, если присутствуют. Каждый элемент списка требует установленных primary_pvlan_id (целое число), secondary_pvlan_id (целое число) и pvlan_type (строка). Тип вторичного PVLAN может быть изолированным или общинным. Вторичный promiscuous PVLAN будет создан автоматически. См. примеры для получения дополнительной информации.
switch строка / обязательно		Имя коммутатора распределённой сети. псевдонимы: dvswitch
username строка		Имя пользователя сервера vCenter vSphere или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs булево	Варианты: no yes ←	Разрешает подключение, когда сертификаты SSL не валидны. Установите в `false`, когда сертификаты не доверяются. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.

Примечания

Примечание

Тестировано на vSphere 6.5 и 6.7

Примеры

- name: Create PVLANs on a Distributed Switch
  vmware_dvswitch_pvlans:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch: dvSwitch
    primary_pvlans:
      - primary_pvlan_id: 1
      - primary_pvlan_id: 4
    secondary_pvlans:
      - primary_pvlan_id: 1
        secondary_pvlan_id: 2
        pvlan_type: isolated
      - primary_pvlan_id: 1
        secondary_pvlan_id: 3
        pvlan_type: community
      - primary_pvlan_id: 4
        secondary_pvlan_id: 5
        pvlan_type: community
  delegate_to: localhost

- name: Create primary PVLAN and secondary promiscuous PVLAN on a Distributed Switch
  vmware_dvswitch_pvlans:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch: dvSwitch
    primary_pvlans:
      - primary_pvlan_id: 1
  delegate_to: localhost

- name: Remove all PVLANs from a Distributed Switch
  vmware_dvswitch_pvlans:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch: dvSwitch
    primary_pvlans: []
    secondary_pvlans: []
  delegate_to: localhost

Значения возврата

Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
result строка	всегда	информация об операции, которая была выполнена Пример: {'changed': True, 'dvswitch': 'dvSwitch', 'private_vlans': [{'primary_pvlan_id': 1, 'pvlan_type': 'promiscuous', 'secondary_pvlan_id': 1}, {'primary_pvlan_id': 1, 'pvlan_type': 'isolated', 'secondary_pvlan_id': 2}, {'primary_pvlan_id': 1, 'pvlan_type': 'community', 'secondary_pvlan_id': 3}], 'private_vlans_previous': [], 'result': 'Все частные VLAN добавлены'}

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом 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_pvlans_module.html