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-адрес сервера, обычно что-то вроде `https://server.example.com/ovirt-engine/api`. Значение по умолчанию задается переменной окружения OVIRT_URL.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. Он извлечёт идентификаторы дисков, снимков и т. д. Пользователь может настроить извлечение других атрибутов вложенных сущностей, указав 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.0.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
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже приведены поля, уникальные для этого модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| data_center словарь | При успехе, если центр обработки данных найден. | Словарь всех атрибутов центра обработки данных. Атрибуты центра обработки данных можно найти на вашем экземпляре oVirt/RHV по следующему URL: http://ovirt.github.io/ovirt-engine-api-model/master/#types/datacenter. |
| id строка | При успехе, если центр обработки данных найден. | Идентификатор управляемого центра обработки данных Пример: 7de90f31-222c-436c-a1ca-7e655bd5b60c |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Автор
- 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.5/modules/ovirt_datacenter_module.html
