Spec-Zone.ru › Ansible

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

Примечание

Этот модуль входит в коллекцию openstack.cloud (версия 2.2.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. Если этот параметр опущен, ничего не будет передано в библиотеку запросов.

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

aliases: cacert

string

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

client_cert

aliases: cert

string

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

client_key

aliases: key

string

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

cloud

any

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

cores

integer

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

fixed_ips

integer

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

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

floating_ips

aliases: compute_floating_ips, floatingip, network_floating_ips

integer

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

gigabytes

integer

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

groups

integer

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

injected_file_content_bytes

aliases: injected_file_size

integer

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

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

injected_file_path_bytes

aliases: injected_path_size

integer

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

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

injected_files

integer

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

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

instances

integer

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

interface

aliases: endpoint_type

string

Тип URL конечной точки для извлечения из каталога служб.

Варианты:

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

key_pairs

integer

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

load_balancers

aliases: loadbalancer

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

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

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

validate_certs

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

boolean

Проверять ли запросы SSL API.

До 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,"}, "network": {"floating_ips": "50,", "load_balancers": "10,", "networks": "10,", "pools": "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

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

Возвращается: успешно

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

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

Возвращается: успешно

network

dictionary

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

Возвращается: успешно

floating_ips

integer

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

Возвращается: успешно

load_balancers

integer

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

Возвращается: успешно

networks

integer

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

Возвращается: успешно

pools

integer

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

Возвращается: успешно

ports

integer

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

Возвращается: успешно

rbac_policies

integer

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

Возвращается: успешно

routers

integer

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

Возвращается: успешно

security_group_rules

integer

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

Возвращается: успешно

security_groups

integer

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

Возвращается: успешно

subnet_pools

integer

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

Возвращаемое значение: success

subnets

integer

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

Возвращаемое значение: success

volume

dictionary

Квоты сервиса блочного хранения.

Возвращаемое значение: success

backup_gigabytes

integer

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

Возвращаемое значение: success

backups

integer

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

Возвращаемое значение: success

gigabytes

integer

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

Возвращаемое значение: success

groups

integer

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

Возвращаемое значение: success

per_volume_gigabytes

integer

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

Возвращаемое значение: success

snapshots

integer

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

Возвращаемое значение: success

volumes

integer

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

Возвращаемое значение: success

Авторы

  • OpenStack Ansible SIG

Ссылки на сборки

  • Система отслеживания задач
  • Репозиторий (исходные коды)

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

Spec-Zone.ru

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