cs_zone_facts – Сбор фактов о зонах из облаков на основе Apache CloudStack
УСТАРЕЛО
| Удалино в Ansible: | |
|---|---|
| версия: 2.13 | |
| Почему: | Преобразовано в модуль информации. |
| Альтернатива: | Используйте cs_zone_info вместо этого. |
Обзор
- Сбор фактов из API зоны.
- Устанавливает доступные в Ansible факты по ключу
cloudstack_zoneи с версии 2.6 также возвращает результаты.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.6.10
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_http_method строка |
| Метод HTTP, используемый для запроса к API-точке. Если не указано, используется переменная среды CLOUDSTACK_METHOD. В качестве последнего варианта используется значение из файла конфигурации ini, также см. примечания. Значение по умолчанию - get, если не указано. |
| api_key строка | API-ключ API CloudStack. Если не указано, используется переменная среды CLOUDSTACK_KEY. В качестве последнего варианта используется значение из файла конфигурации ini, также см. примечания. | |
| api_region строка | Значение по умолчанию: "cloudstack" | Имя раздела в файле конфигурации ini cloustack.ini.Если не указано, используется переменная среды CLOUDSTACK_REGION. |
| api_secret строка | Секретный ключ API CloudStack. Если не задано, используется переменная среды CLOUDSTACK_SECRET. В качестве последнего варианта используется значение из файла конфигурации ini, также см. примечания. | |
| api_timeout целое число | Таймаут HTTP в секундах. Если не указано, используется переменная среды CLOUDSTACK_TIMEOUT. В качестве последнего варианта используется значение из файла конфигурации ini, также см. примечания. Значение по умолчанию 10 секунд, если не указано. | |
| api_url строка | URL API CloudStack, например, https://cloud.example.com/client/api. Если не указано, используется переменная среды CLOUDSTACK_ENDPOINT. В качестве последнего варианта используется значение из файла конфигурации ini, также см. примечания. | |
| name строка / обязательно | Имя зоны. псевдонимы: zone |
Примечания
Примечание
- Ansible использует метод конфигурации библиотеки
cs, если учетные данные не предоставлены аргументамиapi_url,api_key,api_secret. Конфигурация считывается из нескольких мест в следующем порядке. Переменные средыCLOUDSTACK_ENDPOINT,CLOUDSTACK_KEY,CLOUDSTACK_SECRETиCLOUDSTACK_METHOD. Переменная средыCLOUDSTACK_TIMEOUTуказывающая на файлCLOUDSTACK_CONFIG. Файлcloudstack.iniв текущем рабочем каталоге. Файл.cloudstack.iniв домашнем каталоге пользователя. Допускается указание нескольких учетных данных и конечных точек с использованием разделов ini вcloudstack.ini. Используйте аргументapi_regionдля выбора имени раздела, по умолчанию используется разделcloudstack. Дополнительную информацию см. на https://github.com/exoscale/cs. - Подробное руководство по модулям cloudstack можно найти в Руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Gather facts from a zone
cs_zone_facts:
name: ch-gva-1
register: zone
delegate_to: localhost
- name: Show the returned results of the registered variable
debug:
var: zone
- name: Show the facts by the ansible_facts key cloudstack_zone
debug:
var: cloudstack_zone
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| allocation_state строка | success | Состояние зоны. Пример: Enabled |
| dhcp_provider строка | success | DHCP-провайдер для зоны Пример: VirtualRouter |
| dns1 строка | success | Первый DNS для зоны. Пример: 8.8.8.8 |
| dns1_ipv6 строка | success | Первый IPv6 DNS для зоны. Пример: 2001:4860:4860::8888 |
| dns2 строка | success | Второй DNS для зоны. Пример: 8.8.4.4 |
| dns2_ipv6 строка | success | Второй IPv6 DNS для зоны. Пример: 2001:4860:4860::8844 |
| domain строка | success | Домен, к которому относится зона. Пример: ROOT |
| guest_cidr_address строка | success | Адрес CIDR гостевого сетевого сегмента для зоны Пример: 10.1.1.0/24 |
| id строка | success | UUID зоны. Пример: 04589590-ac63-4ffc-93f5-b698b8ac38b6 |
| internal_dns1 строка | success | Первый внутренний DNS для зоны. Пример: 8.8.8.8 |
| internal_dns2 строка | success | Второй внутренний DNS для зоны. Пример: 8.8.4.4 |
| local_storage_enabled логическое значение | success | Включено предоставление локального хранилища. |
| name строка | success | Имя зоны. Пример: zone01 |
| network_domain строка | success | Сетевой домен для зоны. Пример: example.com |
| network_type строка | success | Тип сети для зоны. Пример: basic |
| securitygroups_enabled логическое значение | success | Поддержка групп безопасности включена. |
| tags словарь | success | Список тегов ресурсов, связанных с зоной. Пример: [{'key': 'foo', 'value': 'bar'}] |
| zone_token строка | success | Токен зоны Пример: ccb0a60c-79c8-3230-ab8b-8bdbe8c45bb7 |
Статус
- Этот модуль будет удалён в версии 2.13. [устаревший]
- Для получения дополнительной информации см. УСТАРЕВШИЙ.
Авторы
- 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_zone_facts_module.html