Модуль hetzner.hcloud.placement_group — создание групп размещения и управление ими в Hetzner Cloud.

Примечание

Этот модуль входит в коллекцию hetzner.hcloud (версия 6.9.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install hetzner.hcloud. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: hetzner.hcloud.placement_group.

Обзор
Требования
Параметры
См. также
Примеры
Возвращаемые значения

Обзор

Создание групп размещения в Hetzner Cloud, их обновление и управление ими.

Псевдонимы: hcloud_placement_group

Требования

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

python-dateutil >= 2.7.5
requests >=2.20

Параметры

Параметр	Комментарии
api_endpoint псевдонимы: endpoint string	Конечная точка API Hetzner Cloud. Этот параметр также можно задать с помощью переменной среды `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_endpoint_hetzner string	Конечная точка API Hetzner. Этот параметр также можно задать с помощью переменной среды `HETZNER_ENDPOINT`. По умолчанию: `"https://api.hetzner.com/v1"`
api_token string / обязательный	Токен API Hetzner Cloud. Этот параметр также можно задать с помощью переменной среды `HCLOUD_TOKEN`.
id integer	Идентификатор группы размещения Hetzner Cloud, которой нужно управлять. Обязателен, только если не указано имя группы размещения
labels dictionary	Метки, заданные пользователем (пары «ключ-значение»)
name string	Имя группы размещения Hetzner Cloud, которой нужно управлять. Обязательно, только если не указан идентификатор группы размещения или группа размещения не существует.
state string	Состояние группы размещения. Варианты: `"absent"` `"present"` ← (по умолчанию)
type string	Тип группы размещения Hetzner Cloud.

См. также

Документация по API Hetzner: Полный справочник по API Hetzner.

Примеры

- name: Create a basic placement group
  hetzner.hcloud.placement_group:
    name: my-placement-group
    state: present
    type: spread

- name: Create a placement group with labels
  hetzner.hcloud.placement_group:
    name: my-placement-group
    type: spread
    labels:
      key: value
      mylabel: 123
    state: present

- name: Ensure the placement group is absent (remove if needed)
  hetzner.hcloud.placement_group:
    name: my-placement-group
    state: absent

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

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

Ключ	Описание
hcloud_placement_group dictionary	Экземпляр группы размещения Возвращается: всегда
id integer	Числовой идентификатор группы размещения Возвращается: всегда Пример: `1937415`
labels dictionary	Метки, заданные пользователем (пары «ключ-значение») Возвращается: всегда
name string	Имя группы размещения Возвращается: всегда Пример: `"my placement group"`
servers list / элементы=integer	Идентификаторы серверов группы размещения Возвращается: всегда Пример: `[4711, 4712]`
type string	Тип группы размещения Возвращается: всегда Пример: `"spread"`

Авторы

Adrian Huber (@Adi146)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/hetzner/hcloud/placement_group_module.html