Spec-Zone.ru › Ansible 2.5

os_quota - Управление квотами OpenStack

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

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

Обзор

  • Управление квотами OpenStack. С помощью данного модуля можно создавать, обновлять или удалять квоты. Квота будет обновлена, если найдено соответствующее проект и она присутствует.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • python >= 2.6
  • python >= 2.7
  • shade
  • shade > 1.9.0

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
api_timeout
Сколько времени должна ждать сокетная связь перед временным выходом из строя API-вызовов. Если этот параметр опущен, он не будет передан библиотеке запросов.
auth
Словарь, содержащий информацию об авторизации, необходимую стратегии подключения к облаку. Для стандартного плагина password в него войдут auth_url, username, password, project_name и любая информация о домене, если облако её поддерживает. Для других плагинов этот параметр должен содержать требуемые параметры плагина. Параметр не требуется, если указано имя облака или присутствуют переменные окружения OpenStack OS_*.
auth_type
Название плагина авторизации для использования. Если облако использует аутентификацию, отличную от парольной, здесь должно быть указано имя плагина, и содержимое параметра auth должно быть соответствующим образом обновлено.
availability_zone
Игнорируется. Присутствует для обратной совместимости.
backup_gigabytes По умолчанию:
None
Максимальный размер резервных копий в ГБ.
backups По умолчанию:
None
Максимальное количество разрешённых резервных копий.
cacert
Путь к пакету сертификатов CA, который может быть использован для проверки SSL-API-запросов.
cert
Путь к клиенту сертификата для использования в ходе SSL-транзакции.
cloud
Имя облака или конфигурация облака для работы. Если cloud является строкой, она ссылается на конфигурацию облака, определённую в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не требуется, если указан auth или присутствуют переменные окружения OpenStack OS_* . Если cloud является словарем, он содержит полную конфигурацию облака, как в разделе clouds.yaml.
cores По умолчанию:
None
Максимальное количество процессоров на проект.
fixed_ips По умолчанию:
None
Количество фиксированных IP-адресов для разрешения.
floating_ips По умолчанию:
None
Количество плавающих IP-адресов для разрешения в Compute.

Псевдонимы: compute_floating_ips
floatingip По умолчанию:
None
Количество плавающих IP-адресов для разрешения в Network.

Псевдонимы: network_floating_ips
gigabytes По умолчанию:
None
Максимальный объём хранилища для проекта.
gigabytes_lvm По умолчанию:
None
Максимальный размер отдельных томов LVM в ГБ.
injected_file_size По умолчанию:
None
Максимальный размер файла в байтах.
injected_files По умолчанию:
None
Количество разрешенных файлов.
injected_path_size По умолчанию:
None
Максимальный размер пути.
instances По умолчанию:
None
Максимальное количество разрешённых виртуальных машин.
interface
(добавлено в 2.3)
    Варианты:
  • public ←
  • internal
  • admin
Тип URL конечной точки для извлечения из каталога сервисов.

Псевдонимы: endpoint_type
key
Путь к клиентскому ключу для использования в ходе SSL-транзакции.
key_pairs По умолчанию:
None
Количество разрешённых пар ключей.
loadbalancer
(добавлено в 2.4)
По умолчанию:
None
Количество разрешенных балансировщиков нагрузки.
name
обязательно
Имя проекта OpenStack для управления.
network По умолчанию:
None
Количество разрешённых сетей.
per_volume_gigabytes По умолчанию:
None
Максимальный размер отдельных томов в ГБ.
pool
(добавлено в 2.4)
По умолчанию:
None
Количество разрешённых пулов балансировщиков нагрузки.
port По умолчанию:
None
Количество портов сети для разрешения, которое должно быть больше, чем ограничение по виртуальным машинам.
properties По умолчанию:
None
Количество разрешённых свойств.
ram По умолчанию:
None
Максимальное количество ОЗУ в МБ.
rbac_policy По умолчанию:
None
Количество разрешённых политик.
region_name
Имя региона.
router По умолчанию:
None
Количество разрешённых маршрутизаторов.
security_group По умолчанию:
None
Количество разрешённых групп безопасности.
security_group_rule По умолчанию:
None
Количество правил на группу безопасности для разрешения.
server_group_members По умолчанию:
None
Количество разрешенных участников групп серверов.
server_groups По умолчанию:
None
Количество разрешённых групп серверов.
snapshots По умолчанию:
None
Количество разрешённых снимков.
snapshots_lvm По умолчанию:
None
Количество разрешённых снимков LVM.
state По умолчанию:
present
Значение present устанавливает квоту, а значение absent сбрасывает квоту до системных значений по умолчанию.
subnet По умолчанию:
None
Количество разрешённых подсетей.
subnetpool По умолчанию:
None
Количество разрешенных пулов подсетей.
timeout По умолчанию:
180
Сколько времени Ansible должно ждать запрашиваемого ресурса.
verify
    Варианты:
  • no
  • yes
Нужно ли проверять SSL-API-запросы. До версии 2.3 по умолчанию было True.

Псевдонимы: validate_certs
volumes По умолчанию:
None
Количество разрешённых томов.
volumes_lvm По умолчанию:
None
Количество разрешённых томов LVM.
wait
    Варианты:
  • no
  • yes ←
Должен ли Ansible ждать завершения запрашиваемого ресурса.

Примечания

Примечание

  • Можно использовать стандартные переменные окружения OpenStack, такие как OS_USERNAME, вместо явного указания значений.
  • Информация об авторизации управляется модулем os-client-config, что означает, что значения могут быть взяты из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных окружения, и, наконец, из явных параметров в задачах. Более подробную информацию можно найти по адресу http://docs.openstack.org/developer/os-client-config

Примеры

# List a Project Quota
- os_quota:
    cloud: mycloud
    name: demoproject

# Set a Project back to the defaults
- os_quota:
    cloud: mycloud
    name: demoproject
    state: absent

# Update a Project Quota for cores
- os_quota:
    cloud: mycloud
    name: demoproject
    cores: 100

# Update a Project Quota
- os_quota:
    name: demoproject
    cores: 1000
    volumes: 20
    volumes_type:
      - volume_lvm: 10

# Complete example based on list of projects
- name: Update quotas
  os_quota:
    name: "{{ item.name }}"
    backup_gigabytes: "{{ item.backup_gigabytes }}"
    backups: "{{ item.backups }}"
    cores: "{{ item.cores }}"
    fixed_ips: "{{ item.fixed_ips }}"
    floating_ips: "{{ item.floating_ips }}"
    floatingip: "{{ item.floatingip }}"
    gigabytes: "{{ item.gigabytes }}"
    injected_file_size: "{{ item.injected_file_size }}"
    injected_files: "{{ item.injected_files }}"
    injected_path_size: "{{ item.injected_path_size }}"
    instances: "{{ item.instances }}"
    key_pairs: "{{ item.key_pairs }}"
    loadbalancer: "{{ item.loadbalancer }}"
    per_volume_gigabytes: "{{ item.per_volume_gigabytes }}"
    pool: "{{ item.pool }}"
    port: "{{ item.port }}"
    properties: "{{ item.properties }}"
    ram: "{{ item.ram }}"
    security_group_rule: "{{ item.security_group_rule }}"
    security_group: "{{ item.security_group }}"
    server_group_members: "{{ item.server_group_members }}"
    server_groups: "{{ item.server_groups }}"
    snapshots: "{{ item.snapshots }}"
    volumes: "{{ item.volumes }}"
    volumes_types:
      volumes_lvm: "{{ item.volumes_lvm }}"
    snapshots_types:
      snapshots_lvm: "{{ item.snapshots_lvm }}"
    gigabytes_types:
      gigabytes_lvm: "{{ item.gigabytes_lvm }}"
  with_items:
    - "{{ projects }}"
  when: item.state == "present"

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

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

Ключ Возвращаемое значение Описание
openstack_quotas
сложный
Независимо от того, были ли внесены изменения или нет
Словарь, описывающий квоты проекта.

openstack_quotas



Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.

Автор

  • Майкл Гейл (gale.michael@gmail.com)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/os_quota_module.html

Spec-Zone.ru

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