ovirt_datacenter — Модуль для управления центрами обработки данных в oVirt/RHV
Новый в версии 2.3.
Обзор
- Модуль для управления центрами обработки данных в oVirt/RHV
Псевдонимы: ovirt_datacenters
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.7
- ovirt-engine-sdk-python >= 4.2.4
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| auth обязательно | Словарь со значениями, необходимыми для создания HTTP/HTTPS-соединения с oVirt: username[обязательно] — Имя пользователя, например, admin@internal. Значение по умолчанию задано переменной среды OVIRT_USERNAME.password[обязательно] — Пароль пользователя. Значение по умолчанию задано переменной среды OVIRT_PASSWORD.url — Строка, содержащая URL API сервера, обычно что-то вроде `https://server.example.com/ovirt-engine/api`. Значение по умолчанию задано переменной среды OVIRT_URL. Требуется либо url, либо hostname. hostname — Строка, содержащая имя хоста сервера, обычно что-то вроде `server.example.com`. Значение по умолчанию задано переменной среды OVIRT_HOSTNAME. Требуется либо url, либо hostname. token — Токен, используемый вместо входа с именем пользователя/паролем. Значение по умолчанию задано переменной среды OVIRT_TOKEN.insecure — Флаг булевого типа, указывающий, нужно ли проверять сертификат TLS сервера и имя хоста.ca_file — Файл PEM, содержащий доверенные сертификаты CA. Представленный сервером сертификат будет проверен с помощью этих сертификатов CA. Если параметр `ca_file` не задан, используется системный хранилище сертификатов CA. Значение по умолчанию задано переменной среды OVIRT_CAFILE.kerberos — Флаг булевого типа, указывающий, нужно ли использовать аутентификацию Kerberos вместо стандартной аутентификации по имени пользователя/паролю.headers — Словарь HTTP-заголовков, которые необходимо добавить к каждому вызову API. | |
| comment | Комментарий к центру обработки данных. | |
| compatibility_version | Версия совместимости центра обработки данных. | |
| description | Описание центра обработки данных. | |
| fetch_nested (добавлено в 2.3) | Если True, модуль получит дополнительные данные из API. Будет получены ID дисков ВМ, снимков и т.д. Пользователь может настроить получение других атрибутов вложенных сущностей, указав nested_attributes. | |
| force (добавлено в 2.5) | Значение по умолчанию: "нет" | Этот параметр может быть использован только при удалении центра обработки данных. Если True, центр обработки данных будет удалён принудительно, даже если он содержит кластеры. Значение по умолчанию False, что означает, что удалён только пустой центр обработки данных. |
| local |
True, если центр обработки данных должен быть локальным, False, если он должен быть общим. Значение по умолчанию устанавливается движком. | |
| mac_pool | Пул MAC-адресов, используемый этим центром обработки данных. ВАЖНО: Этот параметр устарел в oVirt/RHV 4.1. Следует использовать mac_pool в модуле ovirt_clusters, поскольку MAC-пулы настраиваются на уровне кластера с версии 4.1. | |
| name обязательно | Имя центра обработки данных, который нужно управлять. | |
| nested_attributes (добавлено в 2.3) | Указывает список атрибутов, которые должны быть получены из API. Этот параметр применяется только, когда fetch_nested равен true. | |
| poll_interval | Значение по умолчанию: 3 | Количество секунд, которое модуль ожидает до отправки следующего запроса на проверку состояния сущности. |
| quota_mode |
| Режим квотирования центра обработки данных. Один из disabled, audit или enabled
|
| state |
| Центр обработки данных должен быть присутствующим или отсутствующим |
| timeout | Значение по умолчанию: 180 | Время в секундах, которое модуль должен ждать, пока экземпляр не перейдет в нужное состояние. |
| wait |
True, если модуль должен ждать, пока сущность не перейдет в нужное состояние. |
Примечания
Примечание
- Для использования этого модуля необходимо установить oVirt Python SDK. Чтобы убедиться, что он установлен с правильной версией, можно создать следующую задачу: pip: name=ovirt-engine-sdk-python version=4.2.4
Примеры
# Examples don't contain auth parameter for simplicity,
# look at ovirt_auth module to see how to reuse authentication:
# Create datacenter
- ovirt_datacenter:
name: mydatacenter
local: True
compatibility_version: 4.0
quota_mode: enabled
# Remove datacenter
- ovirt_datacenter:
state: absent
name: mydatacenter
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| data_center dict | При успехе, если центр обработки данных найден. | Словарь всех атрибутов центра обработки данных. Атрибуты центра обработки данных можно найти на вашем экземпляре oVirt/RHV по следующему URL: http://ovirt.github.io/ovirt-engine-api-model/master/#types/datacenter. |
| id str | При успехе, если центр обработки данных найден. | ID управляемого центра обработки данных Пример: 7de90f31-222c-436c-a1ca-7e655bd5b60c |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Смотрите поддержку модулей и техническое обслуживание для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Ondra Machacek (@machacekondra)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ для улучшения.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/ovirt_datacenter_module.html
