vmware_portgroup — Создание VMware портгруппы

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

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

Описание

Создание VMware портгруппы на заданном/заданных хосте/хостах или хостах заданного кластера

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cluster_name (добавлен в 2.5)		Имя кластера для членства хоста. Портгруппа будет создана на всех хостах заданного кластера. Этот параметр необходим, если `hosts` не указан.
hostname		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в версии 2.6.
hosts (добавлен в 2.5)		Список имен хоста или хостов, на которых необходимо добавить портгруппу. Этот параметр необходим, если `cluster_name` не указан. Псевдонимы: esxi_hostname
network_policy (добавлен в 2.2)	Значение по умолчанию: {u'mac_changes': False, u'promiscuous_mode': False, u'forged_transmits': False}	Политика сети определяет параметры безопасности второго уровня для портгруппы, такие как режим promiscuous, в котором гостевой адаптер прослушивает все пакеты, изменения MAC-адресов и поддельные передачи. Словарь, который настраивает различные значения безопасности для портгруппы. Допустимые атрибуты: - `promiscuous_mode` (bool): указывает, разрешен ли режим promiscuous. (по умолчанию: false) - `forged_transmits` (bool): указывает, разрешены ли поддельные передачи. (по умолчанию: false) - `mac_changes` (bool): указывает, разрешены ли изменения mac. (по умолчанию: false)
password		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в версии 2.6. Псевдонимы: pass, pwd
port (добавлен в 2.5)	Значение по умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PORT`. Поддержка переменных окружения добавлена в версии 2.6.
portgroup_name обязательно		Имя портгруппы для добавления.
state (добавлен в 2.5)	Варианты: present ← absent	Определяет, должна ли портгруппа присутствовать или нет.
switch_name обязательно		vSwitch для изменения.
username		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в версии 2.6. Псевдонимы: user, admin
validate_certs	Варианты: no yes Значение по умолчанию: True	Разрешает подключение, когда сертификаты SSL недействительны. Установите в значение `false`, когда сертификаты не доверяются. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в версии 2.6.
vlan_id обязательно		Идентификатор VLAN для назначения портгруппы.

Примечания

Примечание

Тестировалось на vSphere 5.5, 6.5

Примеры

- name: Add Management Network VM Portgroup
  vmware_portgroup:
    hostname: esxi_hostname
    username: esxi_username
    password: esxi_password
    switch_name: vswitch_name
    portgroup_name: portgroup_name
    vlan_id: vlan_id

- name: Add Portgroup with Promiscuous Mode Enabled
  vmware_portgroup:
    hostname: esxi_hostname
    username: esxi_username
    password: esxi_password
    switch_name: vswitch_name
    portgroup_name: portgroup_name
    network_policy:
        promiscuous_mode: True

- name: Add Management Network VM Portgroup to specific hosts
  vmware_portgroup:
    hostname: vCenter_hostname
    username: esxi_username
    password: esxi_password
    hosts: [esxi_hostname_one]
    switch_name: vswitch_name
    portgroup_name: portgroup_name
    vlan_id: vlan_id

- name: Add Management Network VM Portgroup to all hosts in a cluster
  vmware_portgroup:
    hostname: vCenter_hostname
    username: esxi_username
    password: esxi_password
    cluster_name: rh_engineering
    switch_name: vswitch_name
    portgroup_name: portgroup_name
    vlan_id: vlan_id

- name: Remove Management Network VM Portgroup to all hosts in a cluster
  vmware_portgroup:
    hostname: vCenter_hostname
    username: esxi_username
    password: esxi_password
    cluster_name: rh_engineering
    switch_name: vswitch_name
    portgroup_name: portgroup_name
    vlan_id: vlan_id
    state: absent

Возвращаемые значения

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

Ключ	Возвращаемое значение	Описание
result dict	всегда	метаданные о портгруппе Пример: {'esxi01.example.com': {'portgroup_name': 'pg0010', 'switch_name': 'vswitch_0001', 'vlan_id': 1}}

Статус

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

Автор

Joseph Callen (@jcpowermac)
Russell Teague (@mtnbikenc)
Abhijeet Kasurde (@akasurde) <akasurde@redhat.com>

Подсказка

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

© 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_portgroup_module.html