Модуль vmware.vmware_rest.vcenter_datacenter – Создание нового центра обработки данных в инвентаре vCenter
Примечание
Этот модуль является частью коллекции vmware.vmware_rest (версия 3.2.0).
Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install vmware.vmware_rest. Для использования этого модуля требуются дополнительные компоненты, см. Требования для получения подробной информации.
Для использования в playbook, укажите: 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 / 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: 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 строка | Принудительное удаление существующего ЦОД Возвращается: При успехе Пример: |
results список / элементы=строка | Принудительное удаление существующего ЦОД Возвращается: При успехе Пример: |
Ссылки на коллекцию
© 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_datacenter_module.html