Spec-Zone.ru › Ansible

Модуль openstack.cloud.quota — управление квотами OpenStack

Примечание

Этот модуль входит в коллекцию openstack.cloud (версия 2.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install openstack.cloud. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: openstack.cloud.quota.

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

Краткое описание

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

Требования

На узле, где выполняется этот модуль, должны быть установлены следующие компоненты.

  • python >= 3.6
  • openstacksdk >= 1.0.0

Параметры

Параметр

Описание

api_timeout

integer

Время ожидания сокетного уровня перед истечением срока ожидания вызова API. Если параметр не указан, в библиотеку requests ничего не передаётся.

auth

dictionary

Словарь со сведениями для аутентификации, необходимыми выбранной стратегии плагина аутентификации облака. Для используемого по умолчанию плагина password здесь указываются auth_url, username, password, project_name, а также сведения о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов параметр должен содержать все значения, требуемые соответствующим плагином аутентификации. Этот параметр не требуется, если указано именованное облако или заданы переменные среды OpenStack OS_*.

auth_type

string

Имя используемого плагина аутентификации. Если облако использует аутентификацию, отличную от аутентификации по паролю, здесь следует указать имя плагина и соответствующим образом обновить содержимое параметра auth.

backup_gigabytes

integer

Максимальный размер резервных копий в ГБ.

backups

integer

Максимальное количество резервных копий.

ca_cert

псевдонимы: cacert

string

Путь к пакету сертификатов CA, который можно использовать для проверки запросов к API через SSL.

client_cert

псевдонимы: cert

string

Путь к сертификату клиента, используемому в SSL-транзакции.

client_key

псевдонимы: key

string

Путь к ключу клиента, используемому в SSL-транзакции.

cloud

any

Именованное облако или конфигурация облака, с которыми следует работать. Если cloud — строка, она указывает на именованную конфигурацию облака, определённую в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для параметров auth и auth_type. Этот параметр не требуется, если задан auth или присутствуют переменные среды OpenStack OS_*. Если cloud — словарь, он содержит полную конфигурацию облака, аналогичную разделу файла clouds.yaml.

cores

integer

Максимальное количество процессорных ядер на проект.

fixed_ips

integer

Количество разрешённых фиксированных IP-адресов.

Доступно до версии 2.35 API Nova.

floating_ips

псевдонимы: compute_floating_ips, floatingip, network_floating_ips

integer

Количество разрешённых плавающих IP-адресов.

gigabytes

integer

Максимальный объём хранилища томов для проекта.

groups

integer

Количество групп, разрешённых для проекта.

health_monitors

integer

Максимальное количество создаваемых мониторов состояния.

injected_file_content_bytes

псевдонимы: injected_file_size

integer

Максимальный размер файла в байтах.

Доступно до версии 2.56 API Nova.

injected_file_path_bytes

псевдонимы: injected_path_size

integer

Максимальный размер пути.

Доступно до версии 2.56 API Nova.

injected_files

integer

Количество разрешённых внедряемых файлов.

Доступно до версии 2.56 API Nova.

instances

integer

Максимальное количество разрешённых экземпляров.

interface

псевдонимы: endpoint_type

string

Тип URL конечной точки, выбираемой из каталога служб.

Допустимые значения:

  • "admin"
  • "internal"
  • "public" ← (по умолчанию)

key_pairs

integer

Количество разрешённых пар ключей.

l7_policies

integer

Максимальное количество создаваемых политик L7.

listeners

integer

Максимальное количество создаваемых прослушивателей.

load_balancers

псевдонимы: loadbalancer

integer

Максимальное количество создаваемых балансировщиков нагрузки.

members

integer

Количество участников, разрешённых для балансировщика нагрузки.

metadata_items

integer

Количество элементов метаданных, разрешённых для каждого экземпляра.

name

string / обязательный

Имя проекта OpenStack, которым нужно управлять.

networks

псевдонимы: network

integer

Количество разрешённых сетей.

per_volume_gigabytes

integer

Максимальный размер отдельного тома в ГБ.

pools

псевдонимы: pool

integer

Максимальное количество создаваемых пулов.

ports

псевдонимы: port

integer

Количество разрешённых сетевых портов; это значение должно быть больше лимита экземпляров.

ram

integer

Максимальный объём разрешённой оперативной памяти в МБ.

rbac_policies

псевдонимы: rbac_policy

integer

Количество разрешённых политик.

region_name

string

Имя региона.

routers

псевдонимы: router

integer

Количество разрешённых маршрутизаторов.

sdk_log_level

string

Уровень ведения журнала OpenStackSDK.

Допустимые значения:

  • "INFO" ← (по умолчанию)
  • "DEBUG"

sdk_log_path

string

Путь к файлу журнала OpenStackSDK. Если значение не задано, журнал не записывается.

security_group_rules

псевдонимы: security_group_rule

integer

Количество правил, разрешённых для каждой группы безопасности.

security_groups

псевдонимы: security_group

integer

Количество разрешённых групп безопасности.

server_group_members

integer

Количество разрешённых участников группы серверов.

server_groups

integer

Количество разрешённых групп серверов.

snapshots

integer

Количество разрешённых снимков.

state

string

Значение present устанавливает квоту, а значение absent сбрасывает квоту до значений по умолчанию.

Допустимые значения:

  • "absent"
  • "present" ← (по умолчанию)

subnet_pools

псевдонимы: subnetpool

integer

Количество разрешённых пулов подсетей.

subnets

псевдонимы: subnet

integer

Количество разрешённых подсетей.

timeout

integer

Время ожидания ansible запрошенного ресурса.

По умолчанию: 180

validate_certs

псевдонимы: verify

boolean

Следует ли проверять запросы к API через SSL.

До Ansible 2.3 значение по умолчанию было true.

Допустимые значения:

  • false
  • true

volumes

integer

Количество разрешённых томов.

wait

boolean

Следует ли ansible ожидать завершения операции с запрошенным ресурсом.

Допустимые значения:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Вместо явного указания значений можно использовать стандартные переменные среды OpenStack, например OS_USERNAME.
  • Сведения для аутентификации обрабатываются библиотекой openstacksdk. Это означает, что значения могут поступать из файла конфигурации yaml /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды и, наконец, из явно заданных параметров в плейбуках. Дополнительные сведения доступны по адресу https://docs.openstack.org/openstacksdk/

Примеры

- name: Fetch current project quota
  openstack.cloud.quota:
    cloud: mycloud
    name: demoproject

- name: Reset project quota back to defaults
  openstack.cloud.quota:
    cloud: mycloud
    name: demoproject
    state: absent

- name: Change number of cores and volumes
  openstack.cloud.quota:
    cloud: mycloud
    name: demoproject
    cores: 100
    volumes: 20

- name: Update quota again
  openstack.cloud.quota:
    cloud: mycloud
    name: demo_project
    floating_ips: 5
    networks: 50
    ports: 300
    rbac_policies: 5
    routers: 5
    subnets: 5
    subnet_pools: 5
    security_group_rules: 5
    security_groups: 5
    backup_gigabytes: 500
    backups: 5
    gigabytes: 500
    groups: 1
    pools: 5
    per_volume_gigabytes: 10
    snapshots: 5
    volumes: 5
    cores: 5
    instances: 5
    key_pairs: 5
    metadata_items: 5
    ram: 5
    server_groups: 5
    server_group_members: 5

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

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

Ключ

Описание

quotas

dictionary

Словарь с описанием квоты проекта.

Возвращается: независимо от того, были ли внесены изменения

Пример: {"quotas": {"compute": {"cores": "150,", "fixed_ips": "-1,", "floating_ips": "10,", "injected_file_content_bytes": "10240,", "injected_file_path_bytes": "255,", "injected_files": "5,", "instances": "100,", "key_pairs": "100,", "metadata_items": "128,", "networks": "-1,", "ram": "153600,", "security_group_rules": "-1,", "security_groups": "-1,", "server_group_members": "10,", "server_groups": "10,"}, "load_balancer": {"health_monitors": "10,", "l7_policies": "10,", "listeners": "10,", "load_balancers": "10,", "members": "5,", "pools": "5,"}, "network": {"floating_ips": "50,", "networks": "10,", "ports": "160,", "rbac_policies": "10,", "routers": "10,", "security_group_rules": "100,", "security_groups": "10,", "subnet_pools": "-1,", "subnets": "10,"}, "volume": {"backup_gigabytes": "1000,", "backups": "10,", "gigabytes": "1000,", "groups": "10,", "per_volume_gigabytes": "-1,", "snapshots": "10,", "volumes": "10,"}}}

compute

dictionary

Квоты службы Compute

Возвращается: при успехе

cores

integer

Максимальное количество процессоров на проект.

Возвращается: при успехе

injected_file_content_bytes

integer

Максимальный размер файла в байтах.

Возвращается: при успехе

injected_file_path_bytes

integer

Максимальный размер пути.

Возвращается: при успехе

injected_files

integer

Количество разрешённых внедряемых файлов.

Возвращается: при успехе

instances

integer

Максимальное количество разрешённых экземпляров.

Возвращается: при успехе

key_pairs

integer

Количество разрешённых пар ключей.

Возвращается: при успехе

metadata_items

integer

Количество элементов метаданных, разрешённых для одного экземпляра.

Возвращается: при успехе

ram

integer

Максимальный объём оперативной памяти в МБ.

Возвращается: при успехе

server_group_members

integer

Количество разрешённых участников группы серверов.

Возвращается: при успехе

server_groups

integer

Количество разрешённых групп серверов.

Возвращается: при успехе

load_balancer

dictionary

Квоты службы балансировки нагрузки

Возвращается: при успехе

health_monitors

integer

Максимальное количество создаваемых мониторов работоспособности.

Возвращается: при успехе

l7_policies

integer

Максимальное количество создаваемых политик L7.

Возвращается: при успехе

listeners

integer

Максимальное количество создаваемых прослушивателей

Возвращается: при успехе

load_balancers

integer

Максимальное количество создаваемых балансировщиков нагрузки

Возвращается: при успехе

members

integer

Максимальное количество участников для балансировщика нагрузки.

Возвращается: при успехе

pools

integer

Максимальное количество создаваемых пулов.

Возвращается: при успехе

network

dictionary

Квоты сетевой службы

Возвращается: при успехе

floating_ips

integer

Количество разрешённых плавающих IP-адресов.

Возвращается: при успехе

networks

integer

Количество разрешённых сетей.

Возвращается: при успехе

ports

integer

Количество разрешённых сетевых портов; оно должно быть больше лимита экземпляров.

Возвращается: при успехе

rbac_policies

integer

Количество разрешённых политик.

Возвращается: при успехе

routers

integer

Количество разрешённых маршрутизаторов.

Возвращается: при успехе

security_group_rules

integer

Количество разрешённых правил для каждой группы безопасности.

Возвращается: при успехе

security_groups

integer

Количество разрешённых групп безопасности.

Возвращается: при успехе

subnet_pools

integer

Количество разрешённых пулов подсетей.

Возвращается: при успехе

subnets

integer

Количество разрешённых подсетей.

Возвращается: при успехе

volume

dictionary

Квоты службы блочного хранилища

Возвращается: при успехе

backup_gigabytes

integer

Максимальный размер резервных копий в ГБ.

Возвращается: при успехе

backups

integer

Максимальное количество разрешённых резервных копий.

Возвращается: при успехе

gigabytes

integer

Максимальный объём хранилища томов, разрешённый для проекта.

Возвращается: при успехе

groups

integer

Количество групп, разрешённых для проекта

Возвращается: при успехе

per_volume_gigabytes

integer

Максимальный размер отдельных томов в ГБ.

Возвращается: при успехе

snapshots

integer

Количество разрешённых снимков.

Возвращается: при успехе

volumes

integer

Количество разрешённых томов.

Возвращается: при успехе

Авторы

  • OpenStack Ansible SIG

Ссылки на коллекцию

  • Отслеживание ошибок
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/openstack/cloud/quota_module.html

Spec-Zone.ru

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