cs_resourcelimit – Управление лимитами ресурсов в облаках на базе Apache CloudStack
Обзор
- Управление лимитами ресурсов для доменов, учётных записей и проектов.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.6.10
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
|
account
строка
|
Учётная запись, к которой относится ресурс.
|
|
|
api_http_method
строка
|
|
HTTP-метод, используемый для запроса к API-точке.
Если не указан, используется переменная среды
CLOUDSTACK_METHOD. В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания.
Значение по умолчанию —
get, если не указано. |
|
api_key
строка
|
Ключ API для CloudStack API.
Если не указан, используется переменная среды
CLOUDSTACK_KEY. В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания.
|
|
|
api_region
строка
|
Значение по умолчанию: "cloudstack"
|
Имя раздела в файле конфигурации
cloustack.ini. Если не указан, используется переменная среды
CLOUDSTACK_REGION. |
|
api_secret
строка
|
Секретный ключ API для CloudStack API.
Если не указан, используется переменная среды
CLOUDSTACK_SECRET. В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания.
|
|
|
api_timeout
целое число
|
Таймаут HTTP в секундах.
Если не указан, используется переменная среды
CLOUDSTACK_TIMEOUT. В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания.
Значение по умолчанию — 10 секунд, если не указано.
|
|
|
api_url
строка
|
URL CloudStack API, например, https://cloud.example.com/client/api.
Если не указан, используется переменная среды
CLOUDSTACK_ENDPOINT. В качестве последней опции значение берётся из файла конфигурации ini, см. также примечания.
|
|
|
domain
строка
|
Домен, к которому относится ресурс.
|
|
|
limit
целое число
|
Значение по умолчанию: -1
|
Максимальное количество ресурсов.
По умолчанию — без ограничений
-1. псевдонимы: max |
|
project
строка
|
Имя проекта, к которому относится ресурс.
|
|
|
resource_type
строка / обязательно
|
|
Тип ресурса.
псевдонимы: type |
Примечания
Примечание
- Модуль Ansible использует метод конфигурации библиотеки
cs, если учетные данные не предоставлены аргументамиapi_url,api_key,api_secret. Конфигурация считывается из нескольких источников в указанном порядке.CLOUDSTACK_ENDPOINT,CLOUDSTACK_KEY,CLOUDSTACK_SECRETиCLOUDSTACK_METHOD. Переменные средыCLOUDSTACK_TIMEOUT. Переменная средыCLOUDSTACK_CONFIG, указывающая на файл.ini. Файлcloudstack.iniв текущем рабочем каталоге. Файл.cloudstack.iniв домашнем каталоге пользователя. Допускается указание нескольких учетных данных и конечных точек с использованием разделов ini вcloudstack.ini. Используйте аргументapi_regionдля выбора имени раздела, по умолчанию —cloudstack. Дополнительную информацию см. на странице https://github.com/exoscale/cs. - Подробное руководство по модулям CloudStack можно найти в Руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Update a resource limit for instances of a domain
cs_resourcelimit:
type: instance
limit: 10
domain: customers
delegate_to: localhost
- name: Update a resource limit for instances of an account
cs_resourcelimit:
type: instance
limit: 12
account: moserre
domain: customers
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь. Ниже приведены поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
|
account
строка
|
success |
Учётная запись, к которой относится ресурс.
Пример:
пример учётной записи
|
|
domain
строка
|
success |
Домен, к которому относится ресурс.
Пример:
пример домена
|
|
limit
целое число
|
success |
Максимальное количество ресурсов.
Пример:
-1
|
|
project
строка
|
success |
Проект, к которому относится ресурс.
Пример:
пример проекта
|
|
recource_type
строка
|
success |
Тип ресурса
Пример:
instance
|
Статус
- Этот модуль гарантирует обратную совместимость изменений интерфейса в будущем. [stableinterface]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- René Moser (@resmo)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/cs_resourcelimit_module.html