os_quota - Управление квотами OpenStack
Новая версия 2.3.
- Описание
- Требования (для хоста, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Описание
- Управление квотами OpenStack. С помощью этого модуля можно создавать, обновлять или удалять квоты. Квота будет обновлена, если найдена соответствующая запись для проекта.
Требования (для хоста, на котором выполняется модуль)
- python >= 2.6
- python >= 2.7
- shade
- shade > 1.9.0
Параметры
| параметр | обязательно | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| api_timeout | нет | None | Время ожидания сокета при вызове API. Если параметр опущен, ничего не будет передано в библиотеку requests. | |
| auth | нет | Словарь, содержащий информацию об авторизации, необходимую стратегии плагина авторизации облака. Для плагина по умолчанию password, он должен содержать auth_url, username, password, project_name и любую информацию о доменных именах, если облако их поддерживает. Для других плагинов этот параметр должен содержать необходимые параметры плагина авторизации. Этот параметр не требуется, если указано имя облака или присутствуют переменные окружения OpenStack OS_*. | ||
| auth_type | нет | password | Имя плагина авторизации для использования. Если облако использует что-то кроме парольной аутентификации, имя плагина должно быть указано здесь, и содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone | нет | Игнорируется. Присутствует для обратной совместимости | ||
| backup_gigabytes | нет | None | Максимальный размер резервных копий в ГБ. | |
| backups | нет | None | Максимальное количество разрешенных резервных копий. | |
| cacert | нет | None | Путь к пакету сертификатов CA, который может использоваться для проверки запросов API SSL. | |
| cert | нет | None | Путь к клиенту сертификату, используемому в рамках транзакции SSL. | |
| cloud | нет | Имя облака для работы. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не требуется, если указан параметр auth или переменные окружения OpenStack OS_*. | ||
| cores | нет | None | Максимальное количество процессоров на проект. | |
| endpoint_type | нет | public |
| Тип URL конечной точки для извлечения из каталога служб. |
| fixed_ips | нет | None | Количество фиксированных IP-адресов для разрешения. | |
| floating_ips | нет | None | Количество плавающих IP-адресов для разрешения в вычислениях. псевдонимы: compute_floating_ips | |
| floatingip | нет | None | Количество плавающих IP-адресов для разрешения в сети. псевдонимы: network_floating_ips | |
| gigabytes | нет | None | Максимальное хранилище томов в ГБ для проекта. | |
| gigabytes_lvm | нет | None | Максимальный размер отдельных томов lvm в ГБ. | |
| injected_file_size | нет | None | Максимальный размер файла в байтах. | |
| injected_files | нет | None | Количество разрешенных инжектированных файлов. | |
| injected_path_size | нет | None | Максимальный размер пути. | |
| instances | нет | None | Максимальное количество разрешенных виртуальных машин. | |
| key | нет | None | Путь к клиенту ключу для использования в рамках транзакции 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 для запрошенного ресурса. | |
| validate_certs | нет | Следует ли проверять запросы API SSL. До версии 2.3 значение по умолчанию было True. псевдонимы: verify | ||
| volumes | нет | None | Количество разрешенных томов. | |
| volumes_lvm | нет | None | Количество разрешенных томов LVM. | |
| wait | нет | yes |
| Должен ли Ansible ждать завершения запрошенного ресурса. |
Примеры
# 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, такие как
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
Статус
Этот модуль помечен как предварительный, что означает, что его интерфейс не гарантируется обратной совместимостью.
Для получения помощи в разработке модулей обратитесь к Информация о сообществе и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/os_quota_module.html