ovirt_datacenter – Модуль для управления центрами обработки данных в oVirt/RHV
Обзор
- Модуль для управления центрами обработки данных в oVirt/RHV
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.7
- ovirt-engine-sdk-python >= 4.3.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| auth словарь / обязательно | Словарь со значениями, необходимыми для создания HTTP/HTTPS подключения к oVirt: | ||
| ca_file строка | Файл PEM, содержащий доверенные сертификаты CA. Представленный сервером сертификат будет проверен с помощью этих сертификатов CA. Если параметр ca_file не задан, используется системный хранилище сертификатов CA.Значение по умолчанию устанавливается переменной среды OVIRT_CAFILE. | ||
| headers словарь | Словарь HTTP-заголовков, которые нужно добавить к каждому API-запросу. | ||
| hostname строка | Строка, содержащая имя хоста сервера, обычно что-то вроде `server.example.com`. Значение по умолчанию устанавливается переменной среды OVIRT_HOSTNAME. Требуется либо url, либо hostname. | ||
| insecure логическое |
| Логический флаг, указывающий, нужно ли проверять сертификат TLS сервера и имя хоста. | |
| kerberos логическое |
| Логический флаг, указывающий, нужно ли использовать аутентификацию Kerberos вместо стандартной аутентификации. | |
| password строка / обязательно | Пароль пользователя. Значение по умолчанию устанавливается переменной среды OVIRT_PASSWORD. | ||
| token строка | Токен, который используется вместо входа с именем пользователя/паролем. Значение по умолчанию устанавливается переменной среды OVIRT_TOKEN. | ||
| url строка | Строка, содержащая API-URL сервера, обычно что-то вроде `https://server.example.com/ovirt-engine/api`. Значение по умолчанию устанавливается переменной среды OVIRT_URL. Требуется либо url, либо hostname. | ||
| username строка / обязательно | Имя пользователя, например admin@internal. Значение по умолчанию устанавливается переменной среды OVIRT_USERNAME. | ||
| comment - | Комментарий к центру обработки данных. | ||
| compatibility_version - | Версия совместимости центра обработки данных. | ||
| description - | Описание центра обработки данных. | ||
| fetch_nested логическое |
| Если True, модуль получит дополнительные данные из API. Он получит идентификаторы дисков ВМ, снимков и т.д. Пользователь может настроить запрос других атрибутов вложенных сущностей, указав nested_attributes. | |
| force логическое добавлен в 2.5 |
| Этот параметр можно использовать только при удалении центра обработки данных. Если True, центр обработки данных будет удален принудительно, даже если он содержит кластеры. Значение по умолчанию False, что означает, что удалять можно только пустые центры обработки данных. | |
| id - добавлен в 2.8 | Идентификатор центра обработки данных для управления. | ||
| local логическое |
|
True, если центр обработки данных должен быть локальным, False, если должен быть общим. Значение по умолчанию устанавливается движком. | |
| mac_pool - | Пул MAC-адресов, который должен использоваться этим центром обработки данных. ВАЖНО: Этот параметр устарел в oVirt/RHV 4.1. Вы должны использовать mac_pool в модуле ovirt_clusters, так как MAC-пулы устанавливаются на уровне кластера с версии 4.1. | ||
| name - / обязательно | Имя центра обработки данных для управления. | ||
| nested_attributes список | Указывает список атрибутов, которые нужно получить из API. Этот параметр применяется только когда fetch_nested равно true. | ||
| poll_interval целое число | По умолчанию: 3 | Количество секунд, которое модуль ожидает до отправки другого запроса на проверку состояния сущности. | |
| quota_mode - |
| Режим квотирования центра обработки данных. Один из выключен, аудит или включен
| |
| state - |
| Центр обработки данных должен быть присутствующим или отсутствующим. | |
| timeout целое число | По умолчанию: 180 | Время в секундах, которое модуль должен ждать, пока экземпляр не перейдет в нужное состояние. | |
| wait логическое |
| yes если модуль должен ждать, пока сущность не перейдет в нужное состояние. | |
Примечания
Примечание
- Для использования этого модуля необходимо установить oVirt Python SDK. Чтобы убедиться, что он установлен с правильной версией, можно создать следующую задачу: pip: name=ovirt-engine-sdk-python version=4.3.0
Примеры
# 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
# Change Datacenter Name
- ovirt_datacenter:
id: 00000000-0000-0000-0000-000000000000
name: "new_datacenter_name"
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| data_center словарь | При успехе, если центр обработки данных найден. | Словарь всех атрибутов центра обработки данных. Атрибуты центра обработки данных можно найти на вашем экземпляре oVirt/RHV по следующему URL-адресу: http://ovirt.github.io/ovirt-engine-api-model/master/#types/datacenter. |
| id строка | При успехе, если центр обработки данных найден. | Идентификатор управляемого центра обработки данных Пример: 7de90f31-222c-436c-a1ca-7e655bd5b60c |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается Сообществом 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.9/modules/ovirt_datacenter_module.html
