Spec-Zone.ru › Ansible 2.7

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

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

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

Обзор

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

Требования

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

  • openstacksdk
  • openstacksdk >= 0.13.0
  • python >= 2.7

Параметры

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

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

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

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

Псевдонимы: validate_certs
volumes
-
Количество разрешенных томов.
volumes_lvm
-
Количество разрешенных томов LVM.
wait
boolean
    Варианты:
  • 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
complex
Независимо от того, были ли внесены изменения или нет
Словарь, описывающий квоты проекта.

openstack_quotas
-



Статус

  • Данному модулю не гарантируется обратная совместимость. [превью]
  • Данный модуль поддерживается сообществом Ansible. [community]

Авторы

  • Michael Gale (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.7/modules/os_quota_module.html

Spec-Zone.ru

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