community.vmware.vmware_dvs_portgroup_find – Поиск группы(ы) портов в среде VMware

Примечание

Этот плагин является частью коллекции community.vmware (версия 1.6.0).

Для его установки используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать его в книге задач, укажите: community.vmware.vmware_dvs_portgroup_find.

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

Обзор

Найти группу(ы) портов на основе различных критериев, таких как распределённый коммутатор виртуальных машин, идентификатор VLAN или строку в имени.

Требования

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

python >= 2.7
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
dvswitch строка		Имя распределённого коммутатора виртуальных машин для поиска.
hostname строка		Имя хоста или IP-адрес сервера vCenter или ESXi сервера vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
name строка		Строка для проверки внутри имени группы портов. Базовая проверка вхождения, используя операцию python `in`.
password строка		Пароль сервера vCenter или ESXi сервера vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число	По умолчанию: 443	Номер порта сервера vCenter или ESXi сервера vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PORT`. Поддержка переменных окружения добавлена в Ansible 2.6.
proxy_host строка		Адрес прокси-сервера, который будет принимать все запросы HTTPS и перенаправлять их. Формат – имя хоста или IP-адрес. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12
proxy_port целое число		Порт HTTP прокси-сервера, который будет принимать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PROXY_PORT`.
show_uplink логический	Варианты: нет ← да	Отображать или скрывать группы портов uplink. Актуально только когда предоставлено `vlanid`.
username строка		Имя пользователя сервера vCenter или ESXi сервера vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs логический	Варианты: нет да ←	Разрешает подключение, когда сертификаты SSL не валидны. Установите значение `false` когда сертификаты не надёжны. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено `true`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
vlanid целое число		Идентификатор VLAN может быть любым числом от 1 до 4094. Этот критерий поиска будет искать в диапазонах VLAN, чтобы найти возможные совпадения.

Примечания

Примечание

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

Примеры

- name: Get all portgroups in dvswitch vDS
  community.vmware.vmware_dvs_portgroup_find:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    dvswitch: 'vDS'
  delegate_to: localhost

- name: Confirm if vlan 15 is present
  community.vmware.vmware_dvs_portgroup_find:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    vlanid: '15'
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
dvs_portgroups список / элементы=строка	при успехе	базовые данные найденных групп портов Пример: [{'dvswitch': 'vDS', 'name': 'N-51', 'pvlan': True, 'trunk': True, 'vlan_id': '0'}]

Авторы

David Martinez (@dx0xm)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/vmware/vmware_dvs_portgroup_find_module.html