cloudscale_ch.cloud.server_group – Управляет группами серверов на службе cloudscale.ch IaaS

Примечание

Этот плагин входит в коллекцию cloudscale_ch.cloud (версия 2.0.0).

Для его установки используйте: ansible-galaxy collection install cloudscale_ch.cloud.

Для использования в книге задач укажите: cloudscale_ch.cloud.server_group.

Введено в версии 1.0.0: of cloudscale_ch.cloud

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

Описание

Создание, обновление и удаление групп серверов.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_timeout целое число	По умолчанию: 30	Время ожидания в секундах для вызовов API cloudscale.ch.
api_token строка / обязательно		Токен API cloudscale.ch. Также может быть передан в переменной среды `CLOUDSCALE_API_TOKEN`.
api_url строка добавлен в версии 1.3.0 cloudscale_ch.cloud	По умолчанию: "https://api.cloudscale.ch/v1"	URL API cloudscale.ch. Также может быть передан в переменной среды `CLOUDSCALE_API_URL`.
name строка		Имя группы серверов. Требуется либо name, либо uuid. Эти параметры взаимоисключающие.
state строка	Варианты: present ← отсутствует	Состояние группы серверов.
tags словарь		Теги, связанные с группами серверов. Установите значение `{}` для очистки любых тегов.
type строка	По умолчанию: "anti-affinity"	Тип группы серверов.
uuid строка		UUID группы серверов. Требуется либо name, либо uuid. Эти параметры взаимоисключающие.
zone строка		Zone slug группы серверов (например, `lgp1` или `rma1`).

Примечания

Примечание

Все операции выполняются с использованием публичного API v1 cloudscale.ch.
Для получения подробной информации см. полную документацию API: https://www.cloudscale.ch/ru/api/v1.
Для всех операций требуется действительный токен API. Вы можете создать любое количество токенов, используя панель управления cloudscale.ch по адресу https://control.cloudscale.ch.

Примеры

---
- name: Ensure server group exists
  cloudscale_ch.cloud.server_group:
    name: my-name
    type: anti-affinity
    api_token: xxxxxx

- name: Ensure server group in a specific zone
  cloudscale_ch.cloud.server_group:
    name: my-rma-group
    type: anti-affinity
    zone: lpg1
    api_token: xxxxxx

- name: Ensure a server group is absent
  cloudscale_ch.cloud.server_group:
    name: my-name
    state: absent
    api_token: xxxxxx

Возвращаемые значения

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

Ключ	Возвращаемое значение	Описание
href строка	если доступно	URL API для получения подробностей о данной группе серверов Пример: https://api.cloudscale.ch/v1/server-group/cfde831a-4e87-4a75-960f-89b0148aa2cc
name строка	всегда	Показное имя группы серверов Пример: балансировщики нагрузки
servers список / элементы=строка	если доступно	Список серверов, которые входят в группу серверов.
state строка	всегда	Состояние группы серверов. Пример: present
tags словарь	успешно	Теги, связанные с группой серверов. Пример: {'project': 'мой проект'}
type строка	если доступно	Тип группы серверов Пример: анти-аффинити
uuid строка	всегда	Уникальный идентификатор этого сервера Пример: cfde831a-4e87-4a75-960f-89b0148aa2cc
zone словарь	успешно	Зона группы серверов Пример: {'slug': 'rma1'}

Авторы

René Moser (@resmo)
Denis Krienbühl (@href)

© 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/cloudscale_ch/cloud/server_group_module.html