cs_resourcelimit - Управляет ограничениями ресурсов на облаках на основе Apache CloudStack.
Новое в версии 2.1.
Обзор
- Управляет ограничениями ресурсов для доменов, учетных записей и проектов.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- 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" | Имя раздела ini в файле cloustack.ini. Если не указано, используется переменная среды CLOUDSTACK_REGION. |
| api_secret | Секретный ключ 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 |
Примечания
Примечание
- Если учетные данные не предоставлены в аргументах
api_url,api_key,api_secret, Ansible использует метод конфигурации библиотекиcs. Конфигурация считывается из нескольких мест в указанном ниже порядке. Переменные средыCLOUDSTACK_ENDPOINT,CLOUDSTACK_KEY,CLOUDSTACK_SECRETиCLOUDSTACK_METHOD.CLOUDSTACK_TIMEOUTПеременная среды, указывающая на файл конфигурации.ini. Файлcloudstack.iniв текущем каталоге. Файл.cloudstack.iniв домашнем каталоге пользователя. Допускается задание нескольких учетных данных и конечных точек с использованием разделов ini вcloudstack.ini. Используйте аргументapi_regionдля выбора имени раздела, по умолчанию используется разделcloudstack. Более подробную информацию см. на странице https://github.com/exoscale/cs. - Подробное руководство по модулям cloudstack можно найти в руководстве по облакам CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
# Update a resource limit for instances of a domain
- local_action:
module: cs_resourcelimit
type: instance
limit: 10
domain: customers
# Update a resource limit for instances of an account
- local_action:
module: cs_resourcelimit
type: instance
limit: 12
account: moserre
domain: customers
Значения возврата
Общие значения возврата описаны в этом разделе, ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| account строка | success | Учетная запись, к которой относится ресурс. Пример: example account |
| domain строка | success | Домен, к которому относится ресурс. Пример: example domain |
| limit целое число | success | Максимальное количество ресурсов. Пример: -1 |
| project строка | success | Проект, к которому относится ресурс. Пример: example project |
| recource_type строка | success | Тип ресурса Пример: instance |
Статус
Этот модуль помечен как stableinterface, что означает, что авторы этого модуля гарантируют, что не будут внесены несовместимые с обратной совместимостью изменения интерфейса.
Техническое обслуживание
Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/cs_resourcelimit_module.html