Spec-Zone.ru › Ansible

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

Варианты:

  • false
  • true

name

string

Имя создаваемого дата-центра. Обязательно при state=[‘present’]

session_timeout

float

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

Настройки времени ожидания для клиентского сеанса.

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

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

state

string

Варианты:

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

vcenter_hostname

string / обязательный

Имя узла или IP-адрес vSphere vCenter

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

vcenter_password

string / обязательный

Пароль vSphere vCenter

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

vcenter_rest_log_file

string

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

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

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

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

переменной окружения VMWARE_REST_LOG_FILE.

vcenter_username

string / обязательный

Имя пользователя 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

string

Принудительное удаление существующего дата-центра

Возвращается: При успешном выполнении

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

results

list / элементы=string

Принудительное удаление существующего дата-центра

Возвращается: При успешном выполнении

Пример: [{"_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–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

Spec-Zone.ru

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