Spec-Zone.ru › Ansible

Модуль 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.

Варианты:

  • false
  • true

name

string

Имя создаваемого центра обработки данных. Требуется при state=[‘present’]

session_timeout

float

добавлено в vmware.vmware_rest 2.1.0

Параметры таймаута для сеанса клиента.

Максимальное количество секунд для всей операции, включая установление соединения, отправку запроса и получение ответа.

Значение по умолчанию — 300 с.

state

string

Варианты:

  • "absent"
  • "present" ← (по умолчанию)

vcenter_hostname

string / required

Имя хоста или IP-адрес vSphere vCenter

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_HOST.

vcenter_password

string / required

Пароль vSphere vCenter

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_PASSWORD.

vcenter_rest_log_file

string

Этот необязательный параметр позволяет указать расположение файла журнала.

Этот файл будет использоваться для записи взаимодействия HTTP REST.

Файл будет храниться на хосте, на котором выполняется модуль.

Если значение не указано в задаче, вместо него будет использовано значение

переменной среды VMWARE_REST_LOG_FILE.

vcenter_username

string / required

Имя пользователя vSphere vCenter

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_USER.

vcenter_validate_certs

boolean

Разрешает подключение, когда SSL-сертификаты недействительны. Установите в false, если сертификаты не являются доверенными.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Тестировалось на 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

строка

Принудительное удаление существующего ЦОД

Возвращается: При успехе

Пример: "All items completed"

results

список / элементы=строка

Принудительное удаление существующего ЦОД

Возвращается: При успехе

Пример: [{"_ansible_item_label": {"datacenter": "datacenter-1001", "name": "my_dc"}, "_ansible_no_log": null, "ansible_loop_var": "item", "attempts": 1, "changed": 1, "failed": 0, "invocation": {"module_args": {"datacenter": "datacenter-1001", "folder": null, "force": 1, "name": null, "session_timeout": null, "state": "absent", "vcenter_hostname": "vcenter.test", "vcenter_password": "VALUE_SPECIFIED_IN_NO_LOG_PARAMETER", "vcenter_rest_log_file": "/tmp/vmware_rest.log", "vcenter_username": "administrator@vsphere.local", "vcenter_validate_certs": 0}}, "item": {"datacenter": "datacenter-1001", "name": "my_dc"}, "value": {}}]

Авторы

  • Команда Ansible Cloud (@ansible-collections)

Ссылки на коллекцию

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (источники)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API