cs_instance_facts - Сбор фактов об экземплярах из облаков на основе Apache CloudStack.
Новая версия 2.1.
- Обзор
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Сбор фактов об экземпляре из API.
Требования (к хосту, на котором выполняется модуль)
- python >= 2.6
- cs >= 0.6.10
Параметры
| параметр | обязательно | по умолчанию | возможные значения | комментарии |
|---|---|---|---|---|
| account | нет | Аккаунт, к которому относится экземпляр. | ||
| api_http_method | нет | get |
| Используемый HTTP-метод. |
| api_key | нет | Ключ API CloudStack API. | ||
| api_region | нет | cloudstack | Имя раздела ini в файле cloustack.ini. | |
| api_secret | нет | Секретный ключ CloudStack API. | ||
| api_timeout | нет | 10 | Таймаут HTTP. | |
| api_url | нет | URL CloudStack API, например, https://cloud.example.com/client/api. | ||
| domain | нет | Домен, к которому относится экземпляр. | ||
| name | да | Имя или отображаемое имя экземпляра. | ||
| project | нет | Проект, к которому относится экземпляр. |
Примеры
- cs_instance_facts:
name: web-vm-1
delegate_to: localhost
- debug:
var: cloudstack_instance
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| cloudstack_instance.account | Аккаунт, к которому относится экземпляр. | успешно | строка | пример аккаунта |
| cloudstack_instance.affinity_groups | Группы аффинити, в которых находится экземпляр. | успешно | список | [ "webservers" ] |
| cloudstack_instance.default_ip | Основной IP-адрес экземпляра. | успешно | строка | 10.23.37.42 |
| cloudstack_instance.display_name | Отображаемое имя экземпляра. | успешно | строка | web-01 |
| cloudstack_instance.domain | Домен, к которому относится экземпляр. | успешно | строка | пример домена |
| cloudstack_instance.group | Имя группы, к которой относится экземпляр. | успешно | строка | web |
| cloudstack_instance.hypervisor | Гипервизор, связанный с этим экземпляром. | успешно | строка | KVM |
| cloudstack_instance.id | UUID экземпляра. | успешно | строка | 04589590-ac63-4ffc-93f5-b698b8ac38b6 |
| cloudstack_instance.instance_name | Внутреннее имя экземпляра (только для администратора ROOT). | успешно | строка | i-44-3992-VM |
| cloudstack_instance.iso | Имя ISO, с которым был развернут экземпляр. | успешно | строка | Debian-8-64bit |
| cloudstack_instance.name | Имя экземпляра. | успешно | строка | web-01 |
| cloudstack_instance.password | Пароль экземпляра, если он существует. | успешно | строка | Ge2oe7Do |
| cloudstack_instance.password_enabled | Истинно, если настройка пароля включена. | успешно | булево | Истина |
| cloudstack_instance.project | Имя проекта, к которому относится экземпляр. | успешно | строка | Производство |
| cloudstack_instance.public_ip | Общедоступный IP-адрес экземпляра через правило статической NAT. | успешно | строка | 1.2.3.4 |
| cloudstack_instance.security_groups | Группы безопасности, в которых находится экземпляр. | успешно | список | [ "default" ] |
| cloudstack_instance.service_offering | Имя предложения сервиса, которое имеет экземпляр. | успешно | строка | 2cpu_2gb |
| cloudstack_instance.ssh_key | Имя SSH-ключа, развернутого на экземпляре. | успешно | строка | key@work |
| cloudstack_instance.state | Состояние экземпляра. | успешно | строка | Работает |
| cloudstack_instance.tags | Список тегов ресурсов, связанных с экземпляром. | успешно | словарь | [ { "ключ": "foo", "значение": "bar" } ] |
| cloudstack_instance.template | Имя шаблона, с которым был развернут экземпляр. | успешно | строка | Debian-8-64bit |
| cloudstack_instance.volumes | Список словарей томов, подключенных к экземпляру. | успешно | список | [ { name: "ROOT-1369", type: "ROOT", size: 10737418240 }, { name: "data01, type: "DATADISK", size: 10737418240 } ] |
| cloudstack_instance.zone | Имя зоны, в которой находится экземпляр. | успешно | строка | ch-gva-2 |
| created | Дата создания экземпляра. | успешно | строка | 2014-12-01T14:57:57+0100 |
Примечания
Примечание
- 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 можно найти на http://docs.ansible.com/ansible/guide_cloudstack.html
- Этот модуль поддерживает режим проверки.
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будут вносить несовместимые изменения в интерфейс.
Для помощи в разработке модулей, если вы заинтересованы, ознакомьтесь с Информацией о сообществе и участии в разработке, Тестирование 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/cs_instance_facts_module.html