Spec-Zone.ru › Ansible 2.8

ovirt_quota – Модуль для управления квотами центров обработки данных в oVirt/RHV

Новая версия с 2.3.

  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

Описание

  • Модуль для управления квотами центров обработки данных в 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.
cluster_grace
-
Ограничение по кластеру (жёсткий лимит) в процентах (1-100).

Псевдонимы: cluster_hard_limit
cluster_threshold
-
Пороговое значение по кластеру (мягкий лимит) в процентах (0-100).

Псевдонимы: cluster_soft_limit
clusters
-
Список словарей с ограничениями по кластеру, которые действительны для конкретного кластера.
Если кластер не указан, он действителен для всех кластеров в системе:
cluster
-
Имя кластера.
cpu
-
Ограничение по CPU.
memory
-
Ограничение по памяти (в ГиБ).
data_center
- / обязательно
Имя центра обработки данных, где должна управляться квота.
description
-
Описание квоты для управления.
fetch_nested
логическое значение
добавлен в 2.3
    Варианты:
  • нет
  • да
Если True, модуль получит дополнительные данные из API.
Он получит идентификаторы дисков, снимков и т.д. ВМ. Пользователь может настроить получение других атрибутов вложенных сущностей, указав nested_attributes.
id
-
добавлен в 2.8
Идентификатор квоты для управления.
name
- / обязательно
Имя квоты для управления.
nested_attributes
список
добавлен в 2.3
Указывает список атрибутов, которые должны быть получены из API.
Этот параметр применим только если fetch_nested равно true.
poll_interval
целое число
По умолчанию:
3
Количество секунд, которые модуль ожидает, прежде чем отправить другой запрос о статусе сущности.
state
-
    Варианты:
  • present ←
  • absent
Должна ли квота быть present/absent.
storage_grace
-
Ограничение по хранилищу (жёсткий лимит) в процентах (1-100).

Псевдонимы: storage_hard_limit
storage_threshold
-
Пороговое значение по хранилищу (мягкий лимит) в процентах (0-100).

Псевдонимы: storage_soft_limit
storages
-
Список словарей с ограничениями по хранилищу, которые действительны для конкретного хранилища.
Если хранилище не указано, оно действительн для всех хранилищ в системе:
size
-
Ограничение по размеру (в ГиБ).
storage
-
Имя хранилища.
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:

# Add cluster quota to cluster cluster1 with memory limit 20GiB and CPU limit to 10:
- ovirt_quota:
    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_quota:
    name: quota2
    data_center: dcX
    clusters:
        - memory: 30
          cpu: 15

# Add storage quota to storage data1 with size limit to 100GiB
- ovirt_quota:
    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_quota:
    state: absent
    data_center: dcX
    name: quota1

# Change Quota Name
- ovirt_quota:
    id: 00000000-0000-0000-0000-000000000000
    name: "new_quota_name"
    data_center: dcX

Возвращаемые значения

Общие значения возвращаемых данных документированы здесь, ниже приведены поля, уникальные для данного модуля:

Ключ Возвращаемое значение Описание
id
строка
При успешном поиске квоты.
Идентификатор квоты, которая управляется

Пример:
7de90f31-222c-436c-a1ca-7e655bd5b60c
quota
словарь
При успешном поиске квоты.
Словарь всех атрибутов квоты. Атрибуты квоты можно найти на вашем экземпляре oVirt/RHV по следующему URL: http://ovirt.github.io/ovirt-engine-api-model/master/#types/quota.



Статус

  • Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
  • Этот модуль поддерживается сообществом 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.8/modules/ovirt_quota_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API