ovirt_quotas — Модуль для управления квотами центров обработки данных в oVirt/RHV
Новый в версии 2.3.
Обзор
- Модуль для управления квотами центров обработки данных в oVirt/RHV
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- 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. | |
| cluster_grace | Запас кластера (жесткое ограничение), определённое в процентах (1–100). | |
| cluster_threshold | Порог кластера (мягкое ограничение), определённое в процентах (0–100). | |
| clusters | Список словарей ограничений кластеров, применимых к конкретному кластеру. Если кластер не указан, ограничения применимы ко всем кластерам системы: cluster — Имя кластера.memory — Ограничение памяти (в GiB).cpu — Ограничение ЦП. | |
| data_center обязательно | Имя центра обработки данных, где следует управлять квотой. | |
| description | Описание квоты для управления. | |
| fetch_nested (добавлено в 2.3) | Если True, модуль получит дополнительные данные из API. Он получит идентификаторы дисков ВМ, снимков и т. д. Пользователь может настроить получение других атрибутов вложенных сущностей, указав nested_attributes. | |
| name обязательно | Имя квоты для управления. | |
| nested_attributes (добавлено в 2.3) | Указывает список атрибутов, которые следует получить из API. Этот параметр применяется только при fetch_nested равен true. | |
| poll_interval | По умолчанию: 3 | Количество секунд, которое модуль ожидает, прежде чем отправить новый запрос на проверку статуса сущности. |
| state |
| Должна ли квота быть присутствующей/отсутствующей. |
| storage_grace | Запас хранилища (жесткое ограничение), определённое в процентах (1–100). | |
| storage_threshold | Порог хранилища (мягкое ограничение), определённое в процентах (0–100). | |
| storages | Список словарей ограничений хранилищ, применимых к конкретному хранилищу. Если хранилище не указано, ограничения применимы ко всем хранилищам системы: storage — Имя хранилища.size — Ограничение размера (в GiB). | |
| 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:
# Add cluster quota to cluster cluster1 with memory limit 20GiB and CPU limit to 10:
- ovirt_quotas:
name: quota1
data_center: dcX
clusters:
- name: cluster1
memory: 20
cpu: 10
# Add cluster quota to all clusters with memory limit 30GiB and CPU limit to 15:
- ovirt_quotas:
name: quota2
data_center: dcX
clusters:
- memory: 30
cpu: 15
# Add storage quota to storage data1 with size limit to 100GiB
- ovirt_quotas:
name: quota3
data_center: dcX
storage_grace: 40
storage_threshold: 60
storages:
- name: data1
size: 100
# Remove quota quota1 (Note the quota must not be assigned to any VM/disk):
- ovirt_quotas:
state: absent
data_center: dcX
name: quota1
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| id str | При успехе, если квота найдена. | Идентификатор квоты, которая управляется. Пример: 7de90f31-222c-436c-a1ca-7e655bd5b60c |
| quota dict | При успехе, если квота найдена. | Словарь всех атрибутов квоты. Атрибуты квоты можно найти на вашем экземпляре oVirt/RHV по следующему URL-адресу: http://ovirt.github.io/ovirt-engine-api-model/master/#types/quota. |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом 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_quotas_module.html
