Модуль ngine_io.cloudstack.cs_region – Управление регионами в облаках на основе 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_region.

Новое в ngine_io.cloudstack 0.1.0

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

Краткое описание

Добавление, обновление и удаление регионов.

Требования

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

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Комментарии
api_http_method строка	HTTP-метод, используемый для запроса к конечной точке API. Если не указано, учитывается переменная окружения `CLOUDSTACK_METHOD`. Варианты: `"get"` ← (по умолчанию) `"post"`
api_key строка / обязательно	API-ключ API CloudStack. Если не указано, учитывается переменная окружения `CLOUDSTACK_KEY`.
api_secret строка / обязательно	Секретный ключ API CloudStack. Если не указано, учитывается переменная окружения `CLOUDSTACK_SECRET`.
api_timeout целое число	Таймаут HTTP в секундах. Если не указано, учитывается переменная окружения `CLOUDSTACK_TIMEOUT`. По умолчанию: `10`
api_url строка / обязательно	URL API CloudStack, например https://cloud.example.com/client/api. Если не указано, учитывается переменная окружения `CLOUDSTACK_ENDPOINT`.
api_verify_ssl_cert строка	Проверка файла сертификата центра сертификации. Если не указано, учитывается переменная окружения `CLOUDSTACK_VERIFY`.
endpoint строка	URL конечной точки региона. Обязательно, если state=present
id целое число / обязательно	ID региона. Должно быть числом (int).
name строка	Имя региона. Обязательно, если state=present
state строка	Состояние региона. Варианты: `"present"` ← (по умолчанию) `"absent"`
validate_certs булево добавлено в ngine_io.cloudstack 2.4.0	Если `false`, SSL-сертификаты проверяться не будут. Если не указано, учитывается переменная окружения `CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY`. Это следует использовать только на лично контролируемых сайтах, использующих самозаверяющие сертификаты. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Подробное руководство по модулям cloudstack можно найти в Руководстве по облаку CloudStack.
Этот модуль поддерживает режим проверки.

Примеры

- name: create a region
  ngine_io.cloudstack.cs_region:
    id: 2
    name: geneva
    endpoint: https://cloud.gva.example.com

- name: remove a region with ID 2
  ngine_io.cloudstack.cs_region:
    id: 2
    state: absent

Значения возврата

Общие значения возврата документированы здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Описание
endpoint строка	Конечная точка региона. Возвращается: успех Пример: `"http://cloud.example.com"`
gslb_service_enabled логическое	Включен ли сервис GSLB. Возвращается: успех Пример: `true`
id целое число	ID региона. Возвращается: успех Пример: `1`
name строка	Название региона. Возвращается: успех Пример: `"local"`
portable_ip_service_enabled логическое	Включен ли сервис переноса IP. Возвращается: успех Пример: `true`

Авторы

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_region_module.html