ngine_io.cloudstack.cs_zone – Управляет зонами в облаках на основе Apache CloudStack.
Примечание
Этот плагин является частью коллекции ngine_io.cloudstack (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack.
Для использования в книге задач укажите: ngine_io.cloudstack.cs_zone.
Новый в версии 0.1.0: из ngine_io.cloudstack
Обзор
- Создание, обновление и удаление зон.
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_http_method строка |
| HTTP-метод, используемый для запроса к API-точке входа. Если не указано, используется переменная среды CLOUDSTACK_METHOD. |
| api_key строка / обязательно | API-ключ API CloudStack. Если не указано, используется переменная среды CLOUDSTACK_KEY. | |
| api_secret строка / обязательно | Секретный ключ API CloudStack. Если не указано, используется переменная среды CLOUDSTACK_SECRET. | |
| api_timeout целое число | По умолчанию: 10 | Таймаут HTTP в секундах. Если не указано, используется переменная среды CLOUDSTACK_TIMEOUT. |
| api_url строка / обязательно | URL API CloudStack, например, https://cloud.example.com/client/api. Если не указано, используется переменная среды CLOUDSTACK_ENDPOINT. | |
| api_verify_ssl_cert строка | Проверка сертификата авторитета CA. Если не указано, используется переменная среды CLOUDSTACK_VERIFY. | |
| dhcp_provider строка | DHCP-провайдер для зоны. | |
| dns1 строка | Первый DNS для зоны. Требуется, если state=present
| |
| dns1_ipv6 строка | Первый DNS для IPv6 зоны. | |
| dns2 строка | Второй DNS для зоны. | |
| dns2_ipv6 строка | Второй DNS для IPv6 зоны. | |
| domain строка | Домен, к которому относится зона. Зона является публичной, если не задано. | |
| guest_cidr_address строка | Адрес Guest CIDR для зоны. | |
| id строка | uuid существующей зоны. | |
| internal_dns1 строка | Первый внутренний DNS для зоны. Если не задано, используется dns1 в state=present. | |
| internal_dns2 строка | Второй внутренний DNS для зоны. | |
| local_storage_enabled булево |
| Включить или нет локальное хранилище для зоны. |
| name строка / обязательно | Имя зоны. | |
| network_domain строка | Домен сети для зоны. | |
| network_type строка |
| Тип сети зоны. |
| securitygroups_enabled булево |
| Включена ли поддержка групп безопасности для зоны. |
| state строка |
| Состояние зоны. |
Примечания
Примечание
- Подробное руководство по модулям cloudstack можно найти в руководстве по облаку CloudStack.
- Данный модуль поддерживает режим проверки.
Примеры
- name: Ensure a zone is present
ngine_io.cloudstack.cs_zone:
name: ch-zrh-ix-01
dns1: 8.8.8.8
dns2: 8.8.4.4
network_type: basic
- name: Ensure a zone is disabled
ngine_io.cloudstack.cs_zone:
name: ch-zrh-ix-01
state: disabled
- name: Ensure a zone is enabled
ngine_io.cloudstack.cs_zone:
name: ch-zrh-ix-01
state: enabled
- name: Ensure a zone is absent
ngine_io.cloudstack.cs_zone:
name: ch-zrh-ix-01
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| allocation_state строка | success | Состояние зоны. Пример: Включено |
| dhcp_provider строка | success | DHCP-провайдер для зоны Пример: VirtualRouter |
| dns1 строка | success | Первый DNS для зоны. Пример: 8.8.8.8 |
| dns1_ipv6 строка | success | Первый DNS IPv6 для зоны. Пример: 2001:4860:4860::8888 |
| dns2 строка | success | Второй DNS для зоны. Пример: 8.8.4.4 |
| dns2_ipv6 строка | success | Второй DNS IPv6 для зоны. Пример: 2001:4860:4860::8844 |
| domain строка | success | Домен, к которому относится зона. Пример: ROOT |
| guest_cidr_address строка | success | Адрес Guest 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 |
Авторы
- René Moser (@resmo)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ngine_io/cloudstack/cs_zone_module.html
