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 boolean добавлено в 2.3 |
| Если True, модуль получит дополнительные данные из API. Он получит идентификаторы дисков ВМ, снимков и т. д. Пользователь может настроить получение других атрибутов вложенных сущностей, указав nested_attributes. |
| force - добавлено в 2.5 | Значение по умолчанию: "no" | Этот параметр может использоваться только при удалении центра обработки данных. Если 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 - |
| Центр обработки данных должен быть present или absent. |
| timeout - | Значение по умолчанию: 180 | Количество секунд, которое модуль должен ждать, пока экземпляр не перейдет в желаемое состояние. |
| wait boolean |
|
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 словарь | При успехе, если центр обработки данных найден. | Словарь всех атрибутов центра обработки данных. Атрибуты центра обработки данных можно найти на вашем экземпляре 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.7/modules/ovirt_datacenter_module.html
