Spec-Zone.ru › Ansible 2.9

ovirt_quota – Модуль для управления квотами центров обработки данных в 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
строка
Строка, содержащая URL API сервера, обычно что-то вроде `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
-
Ограничение ЦП.
memory
-
Ограничение памяти (в ГБ).
data_center
- / обязательно
Имя центра обработки данных, в котором нужно управлять квотой.
description
-
Описание квоты для управления.
fetch_nested
булево
    Варианты:
  • нет
  • да
Если True, модуль загрузит дополнительные данные из API.
Он загрузит идентификаторы дисков ВМ, снимков и т. д. Пользователь может настроить загрузку других атрибутов вложенных сущностей, указав nested_attributes.
id
-
добавлено в 2.8
Идентификатор квоты для управления.
name
- / обязательно
Имя квоты для управления.
nested_attributes
список
Указывает список атрибутов, которые должны быть загружены из 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
строка
При успешном поиске квоты.
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.9/modules/ovirt_quota_module.html

Spec-Zone.ru

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