cs_zone - Управляет зонами на облаках Apache CloudStack.
Новая версия 2.1.
- Обзор
- Требования (для хоста, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Создание, обновление и удаление зон.
Требования (для хоста, на котором выполняется модуль)
- python >= 2.6
- cs >= 0.6.10
Параметры
| параметр | обязателен | по умолчанию | возможные значения | комментарии |
|---|---|---|---|---|
| api_http_method |
нет | get |
|
Используемый HTTP-метод. |
| api_key |
нет | Ключ API CloudStack. |
||
| 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. |
||
| 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 для зоны. |
||
| name |
да | Название зоны. |
||
| network_domain |
нет | Домен сети для зоны. |
||
| network_type |
нет | basic |
|
Тип сети зоны. |
| state |
нет | present |
|
Состояние зоны. |
Примеры
# Ensure a zone is present
- local_action:
module: cs_zone
name: ch-zrh-ix-01
dns1: 8.8.8.8
dns2: 8.8.4.4
network_type: basic
# Ensure a zone is disabled
- local_action:
module: cs_zone
name: ch-zrh-ix-01
state: disabled
# Ensure a zone is enabled
- local_action:
module: cs_zone
name: ch-zrh-ix-01
state: enabled
# Ensure a zone is absent
- local_action:
module: cs_zone
name: ch-zrh-ix-01
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| название | описание | возвращается | тип | пример |
|---|---|---|---|---|
| allocation_state | Состояние зоны. |
успех | строка | Enabled |
| dhcp_provider | DHCP-провайдер для зоны |
успех | строка | VirtualRouter |
| dns1 | Первый DNS для зоны. |
успех | строка | 8.8.8.8 |
| dns1_ipv6 | Первый IPv6 DNS для зоны. |
успех | строка | 2001:4860:4860::8888 |
| dns2 | Второй DNS для зоны. |
успех | строка | 8.8.4.4 |
| dns2_ipv6 | Второй IPv6 DNS для зоны. |
успех | строка | 2001:4860:4860::8844 |
| domain | Домен, к которому относится зона. |
успех | строка | ROOT |
| guest_cidr_address | Guest CIDR-адрес для зоны |
успех | строка | 10.1.1.0/24 |
| id | UUID зоны. |
успех | строка | 04589590-ac63-4ffc-93f5-b698b8ac38b6 |
| internal_dns1 | Первый внутренний DNS для зоны. |
успех | строка | 8.8.8.8 |
| internal_dns2 | Второй внутренний DNS для зоны. |
успех | строка | 8.8.4.4 |
| local_storage_enabled | Включена локальная служба хранения. |
успех | булево | False |
| name | Название зоны. |
успех | строка | zone01 |
| network_domain | Домен сети для зоны. |
успех | строка | example.com |
| network_type | Тип сети для зоны. |
успех | строка | basic |
| securitygroups_enabled | Поддержка Security groups включена. |
успех | булево | False |
| tags | Список тегов ресурсов, связанных с зоной. |
успех | словарь | [{'key': 'foo', 'value': 'bar'}] |
| zone_token | Токен зоны |
успех | строка | ccb0a60c-79c8-3230-ab8b-8bdbe8c45bb7 |
Примечания
Примечание
- 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_zone_module.html
