vmware_drs_group – Создаёт группу vm/host в заданном кластере

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

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

Описание

Этот модуль может использоваться для создания групп VM/Host в заданном кластере. Создаёт группу vm, если vms установлено. Создаёт группу host, если hosts установлено.

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cluster_name строка / обязательно		Кластер для создания группы vm/host.
datacenter строка		Центр обработки данных для поиска заданного кластера. Если не задано, мы используем первый встретившийся кластер с `cluster_name`. алиасы: datacenter_name
group_name строка / обязательно		Имя группы для создания или удаления.
hostname строка		Имя хоста или IP-адрес сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
hosts список		Список хостов для создания в группе. Требуется только если `vms` не задано.
password строка		Пароль сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. алиасы: pass, pwd
port целое число добавлено в 2.5	По умолчанию: 443	Номер порта сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `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`.
state строка / обязательно	Варианты: present ← absent	Если установлено значение `present`, и группа не существует, то группа будет создана. Если установлено значение `absent`, и группа существует, то группа будет удалена.
username строка		Имя пользователя сервера vCenter или 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.
vms список		Список vm для создания в группе. Требуется только если `hosts` не задано.

Примечания

Примечание

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

Примеры

---
- name: "Create DRS VM group"
  delegate_to: localhost
  vmware_drs_group:
    hostname: "{{ vcenter_hostname }}"
    password: "{{ vcenter_password }}"
    username: "{{ vcenter_username }}"
    cluster_name: DC0_C0
    datacenter_name: DC0
    group_name: TEST_VM_01
    vms:
      - DC0_C0_RP0_VM0
      - DC0_C0_RP0_VM1
    state: present

- name: "Create DRS Host group"
  delegate_to: localhost
  vmware_drs_group:
    hostname: "{{ vcenter_hostname }}"
    password: "{{ vcenter_password }}"
    username: "{{ vcenter_username }}"
    cluster_name: DC0_C0
    datacenter_name: DC0
    group_name: TEST_HOST_01
    hosts:
      - DC0_C0_H0
      - DC0_C0_H1
      - DC0_C0_H2
    state: present

- name: "Delete DRS Host group"
  delegate_to: localhost
  vmware_drs_group:
    hostname: "{{ vcenter_hostname }}"
    password: "{{ vcenter_password }}"
    username: "{{ vcenter_username }}"
    cluster_name: DC0_C0
    datacenter_name: DC0
    group_name: TEST_HOST_01
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
drs_group_facts словарь	всегда	Метаданные о созданной группе DRS Пример: {'drs_group_facts': {'changed': True, 'failed': False, 'msg': 'Успешно создана группа хостов TEST_HOST_01', 'result': {'DC0_C0': [{'group_name': 'TEST_HOST_01', 'hosts': ['DC0_C0_H0', 'DC0_C0_H1', 'DC0_C0_H2'], 'type': 'host'}]}}}

Статус

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

Авторы

Карстен Кай Якобсен (@karstenjakobsen)

Подсказка

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

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