ngine_io.cloudstack.cs_zone модуль — Управление зонами в облаках на базе Apache CloudStack.

Примечание

Этот модуль входит в коллекцию ngine_io.cloudstack (версия 2.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробностей.

Для использования в playbook укажите: ngine_io.cloudstack.cs_zone.

Добавлена в ngine_io.cloudstack 0.1.0

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Создание, обновление и удаление зон.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Комментарии
api_http_method string	HTTP-метод, используемый для запроса к конечной точке API. Если не указан, используется переменная окружения `CLOUDSTACK_METHOD`. Варианты: `"get"` ← (default) `"post"`
api_key string / required	API ключ CloudStack API. Если не указан, используется переменная окружения `CLOUDSTACK_KEY`.
api_secret string / required	Секретный ключ CloudStack API. Если не указан, используется переменная окружения `CLOUDSTACK_SECRET`.
api_timeout integer	Таймаут HTTP в секундах. Если не указан, используется переменная окружения `CLOUDSTACK_TIMEOUT`. По умолчанию: `10`
api_url string / required	URL CloudStack API, например https://cloud.example.com/client/api. Если не указан, используется переменная окружения `CLOUDSTACK_ENDPOINT`.
api_verify_ssl_cert string	Проверка файла сертификата центра сертификации. Если не указан, используется переменная окружения `CLOUDSTACK_VERIFY`.
dhcp_provider string	Провайдер DHCP для зоны.
dns1 string	Первый DNS для зоны. Обязательно, если state=present
dns1_ipv6 string	Первый DNS для IPv6 для зоны.
dns2 string	Второй DNS для зоны.
dns2_ipv6 string	Второй DNS для IPv6 для зоны.
domain string	Домен, к которому относится зона. Зона является общедоступной, если не установлено.
guest_cidr_address string	Гостевой CIDR-адрес для зоны.
id string	UUID существующей зоны.
internal_dns1 string	Первый внутренний DNS для зоны. Если не установлен, будет использоваться dns1 при state=present.
internal_dns2 string	Второй внутренний DNS для зоны.
local_storage_enabled boolean	Включить или отключить локальное хранилище для зоны. Варианты: `false` `true`
name string / required	Название зоны.
network_domain string	Домен сети для зоны.
network_type string	Тип сети зоны. Варианты: `"Basic"` ← (default) `"Advanced"`
securitygroups_enabled boolean	Включена ли в зоне поддержка групп безопасности. Варианты: `false` `true`
state string	Состояние зоны. Варианты: `"present"` ← (default) `"enabled"` `"disabled"` `"absent"`

validate_certs

boolean

added in ngine_io.cloudstack 2.4.0

If false, SSL certificates will not be validated.

If not given, the CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY env variable is considered.

This should only be used on personally controlled sites using self-signed certificates.

Choices:

false
true ← (default)

Notes

Note

A detailed guide about cloudstack modules can be found in the CloudStack Cloud Guide.
This module supports check mode.

Examples

- 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 string	Состояние зоны. Возвращается: success Пример: `"Enabled"`
dhcp_provider string	Провайдер DHCP для зоны Возвращается: success Пример: `"VirtualRouter"`
dns1 string	Первый DNS для зоны. Возвращается: success Пример: `"8.8.8.8"`
dns1_ipv6 string	Первый IPv6 DNS для зоны. Возвращается: success Пример: `"2001:4860:4860::8888"`
dns2 string	Второй DNS для зоны. Возвращается: success Пример: `"8.8.4.4"`
dns2_ipv6 string	Второй IPv6 DNS для зоны. Возвращается: success Пример: `"2001:4860:4860::8844"`
domain string	Домен, к которому относится зона. Возвращается: success Пример: `"ROOT"`
guest_cidr_address string	Гостевой CIDR-адрес для зоны Возвращается: success Пример: `"10.1.1.0/24"`
id string	UUID зоны. Возвращается: success Пример: `"04589590-ac63-4ffc-93f5-b698b8ac38b6"`
internal_dns1 string	Первый внутренний DNS для зоны. Возвращается: success Пример: `"8.8.8.8"`
internal_dns2 string	Второй внутренний DNS для зоны. Возвращается: success Пример: `"8.8.4.4"`
local_storage_enabled boolean	Включено предложение локального хранилища. Возвращается: success Пример: `false`
name string	Название зоны. Возвращается: success Пример: `"zone01"`
network_domain string	сетевой домен для зоны. Возвращается: success Пример: `"example.com"`
network_type string	Тип сети для зоны. Возвращается: success Пример: `"basic"`
securitygroups_enabled boolean	Включена поддержка групп безопасности. Возвращается: success Пример: `false`
tags list / elements=string	Список тегов ресурсов, связанных с зоной. Возвращается: success Пример: `[{"key": "foo", "value": "bar"}]`
zone_token string	Токен зоны Возвращается: success Пример: `"ccb0a60c-79c8-3230-ab8b-8bdbe8c45bb7"`

Авторы

René Moser (@resmo)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ngine_io/cloudstack/cs_zone_module.html