Модуль vmware.vmware_rest.vcenter_host — Добавление нового автономного хоста в инвентарь vCenter
Примечание
Этот модуль является частью коллекции vmware.vmware_rest (версия 3.2.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install vmware.vmware_rest. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробностей.
Для использования в плейбуке укажите: vmware.vmware_rest.vcenter_host.
Новое в vmware.vmware_rest 0.1.0
Описание
- Добавление нового автономного хоста в инвентарь vCenter. Новым подключенным хостом будет подключенное состояние. Сервер vCenter проверит сертификат SSL перед добавлением хоста в свой инвентарь. В случае, если сертификат SSL не может быть проверен из-за того, что центр сертификации не распознан или сертификат является самозаверяющимся, сервер vCenter вернется к режиму проверки отпечатков пальцев, как определено в Host.CreateSpec.ThumbprintVerification.
Требования
Ниже перечислены требования, необходимые на хосте, который выполняет этот модуль.
- vSphere 7.0.3 или более поздняя версия
- python >= 3.6
- aiohttp
Параметры
Параметр | Комментарии |
|---|---|
folder string | Папка хоста и кластера, в которой должен быть создан новый автономный хост. Это поле в настоящее время обязательно. В будущем, если это поле не установлено, система попытается выбрать подходящую папку для хоста; если папку выбрать невозможно, операция создания хоста завершится неудачей. Когда клиенты передают значение этой структуры в качестве параметра, поле должно быть идентификатором ресурса, возвращенного vmware.vmware_rest.vcenter_folder_info. |
force_add boolean | Следует ли добавлять хост на vCenter Server, даже если он управляется другим vCenter Server. Оригинальный vCenterServer теряет соединение с хостом. Если не задано, forceAdd по умолчанию равно false. Варианты:
|
host string | Идентификатор хоста, который необходимо отключить. Параметр должен быть идентификатором ресурса, возвращенного vmware.vmware_rest.vcenter_host_info. Обязательно с state=[‘absent’, ‘connect’, ‘disconnect’] |
hostname string | IP-адрес или DNS-разрешаемое имя хоста. Обязательно с state=[‘present’] |
password string | Пароль для учетной записи администратора на хосте. Обязательно с state=[‘present’] |
port integer | Порт хоста. Если не задано, будет использован порт 443. |
session_timeout float добавлено в vmware.vmware_rest 2.1.0 | Настройки тайм-аута для сеанса клиента. Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и ответ. Значение по умолчанию — 300 с. |
state string | Варианты:
|
thumbprint string | Отпечаток сертификата SSL, который, как ожидается, будет у хоста. Отпечаток всегда вычисляется с использованием хэша SHA1 и представляет собой строковое представление этого хэша в формате: xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx, где «x» представляет шестнадцатеричную цифру. Это поле является необязательным, и оно актуально только тогда, когда значение thumbprint_verification равно THUMBPRINT. |
thumbprint_verification string | Перечисляемый тип thumbprint_verification определяет схемы проверки отпечатков для сертификата SSL хоста. Обязательно с state=[‘present’] Варианты:
|
user_name string | Учетная запись администратора на хосте. Обязательно с state=[‘present’] |
vcenter_hostname string / required | Имя хоста или IP-адрес vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
vcenter_password string / required | Пароль vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
vcenter_rest_log_file string | Этот необязательный параметр можно использовать для установки местоположения файла журнала. Этот файл будет использоваться для записи взаимодействия HTTP REST. Файл будет храниться на хосте, на котором запущен модуль. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
vcenter_username string / required | Имя пользователя vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
vcenter_validate_certs boolean | Разрешает подключение, когда сертификаты SSL недействительны. Установите значение Если значение не указано в задаче, вместо него будет использовано значение переменной среды Варианты:
|
Примечания
Примечание
- Тестировалось на vSphere 7.0.3
Примеры
- name: Connect the host(s)
vmware.vmware_rest.vcenter_host:
hostname: "{{ lookup('env', 'ESXI1_HOSTNAME') }}"
user_name: "{{ lookup('env', 'ESXI1_USERNAME') }}"
password: "{{ lookup('env', 'ESXI1_PASSWORD') }}"
thumbprint_verification: NONE
folder: '{{ my_host_folder.folder }}'
Значения возврата
Общие значения возврата документированы здесь, ниже приведены поля, уникальные для данного модуля:
Ключ | Описание |
|---|---|
value строка | Подключить хост(ы) Возвращается: При успехе Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/vmware/vmware_rest/vcenter_host_module.html
