Spec-Zone.ru › Ansible 2.4

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
  • public
  • internal
  • admin
Тип 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
  • yes
  • no
Должен ли 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_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

Spec-Zone.ru

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