Модуль vmware.vmware_rest.vcenter_datacenter — создание нового дата-центра в инвентаре vCenter
Примечание
Этот модуль входит в коллекцию vmware.vmware_rest (версия 4.10.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install vmware.vmware_rest. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в сценарии, укажите: vmware.vmware_rest.vcenter_datacenter.
Добавлено в vmware.vmware_rest 0.1.0
Краткое описание
- Создание нового дата-центра в инвентаре vCenter
Требования
Следующие требования должны быть выполнены на узле, на котором выполняется этот модуль.
- vSphere 7.0.3 или более поздней версии
- python >= 3.6
- aiohttp
Параметры
Параметр | Комментарии |
|---|---|
datacenter string | Идентификатор удаляемого дата-центра. Параметр должен содержать идентификатор ресурса, возвращаемого модулем vmware.vmware_rest.vcenter_datacenter_info. Обязателен при state=[‘absent’] |
folder string | Папка дата-центров, в которой следует создать новый дата-центр. В настоящее время это поле является обязательным. В будущем, если это поле не будет задано, система попытается выбрать подходящую папку для дата-центра; если выбрать папку не удастся, операция создания дата-центра завершится ошибкой. Если клиенты передают значение этой структуры в качестве параметра, поле должно содержать идентификатор ресурса, возвращаемого модулем vmware.vmware_rest.vcenter_folder_info. |
force boolean | Если значение равно true, удалить дата-центр, даже если он не пуст. Если значение не задано, при непустом дата-центре будет возвращена ошибка ResourceInUse. Это эквивалентно передаче значения false. Варианты:
|
name string | Имя создаваемого дата-центра. Обязательно при state=[‘present’] |
session_timeout float добавлено в vmware.vmware_rest 2.1.0 | Настройки времени ожидания для клиентского сеанса. Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и получение ответа. Значение по умолчанию — 300 с. |
state string | Варианты:
|
vcenter_hostname string / обязательный | Имя узла или IP-адрес vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
vcenter_password string / обязательный | Пароль vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
vcenter_rest_log_file string | Этот необязательный параметр позволяет задать расположение файла журнала. В этом файле будет записываться обмен данными по HTTP REST. Файл будет сохранен на узле, на котором выполняется модуль. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
vcenter_username string / обязательный | Имя пользователя vSphere vCenter Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
vcenter_validate_certs boolean | Разрешает подключение при недействительных SSL-сертификатах. Если сертификаты не являются доверенными, задайте значение Если значение не указано в задаче, вместо него будет использовано значение переменной окружения Варианты:
|
Примечания
Примечание
- Проверено на vSphere 7.0.3
Примеры
- name: Get a list of all the datacenters
register: existing_datacenters
vmware.vmware_rest.vcenter_datacenter_info:
- name: Force delete the existing DC
vmware.vmware_rest.vcenter_datacenter:
state: absent
datacenter: '{{ item.datacenter }}'
force: true
with_items: '{{ existing_datacenters.value }}'
until:
- _result is not failed
retries: 7
- name: Create datacenter my_dc
vmware.vmware_rest.vcenter_datacenter:
name: my_dc
folder: '{{ my_datacenter_folder.folder }}'
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
msg string | Принудительное удаление существующего дата-центра Возвращается: При успешном выполнении Пример: |
results list / элементы=string | Принудительное удаление существующего дата-центра Возвращается: При успешном выполнении Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/vmware/vmware_rest/vcenter_datacenter_module.html