Модуль hetzner.hcloud.volume_attachment — управление подключением томов Hetzner Cloud

Примечание

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

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

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

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

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

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

Подключение и отключение томов от серверов Hetzner Cloud.

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

Требования

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

python-dateutil >= 2.7.5
requests >=2.20

Параметры

Параметр	Комментарии
api_endpoint псевдонимы: endpoint строка	Адрес конечной точки API Hetzner Cloud. Этот параметр также можно задать с помощью переменной окружения `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_endpoint_hetzner строка	Адрес конечной точки API Hetzner. Этот параметр также можно задать с помощью переменной окружения `HETZNER_ENDPOINT`. По умолчанию: `"https://api.hetzner.com/v1"`
api_token строка / обязательный	Токен для API Hetzner Cloud. Этот параметр также можно задать с помощью переменной окружения `HCLOUD_TOKEN`.
automount логическое значение	Автоматически подключать том к серверу. Варианты: `false` `true`
server строка	Имя или идентификатор сервера Hetzner Cloud, к которому нужно подключить том. Обязательно, если `state=present`.
state строка	Состояние тома. Варианты: `"present"` ← (по умолчанию) `"absent"`
volume строка / обязательный	Имя или идентификатор тома Hetzner Cloud, который нужно подключить или отключить.

См. также

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

Примеры

- name: Attach my-volume to my-server
  hetzner.hcloud.volume_attachment:
    volume: my-volume
    server: my-server

- name: Detach my-volume from my-server
  hetzner.hcloud.volume_attachment:
    volume: my-volume
    state: absent

- name: Attach my-volume using id to my-server with automount enabled
  hetzner.hcloud.volume_attachment:
    volume: 123456
    server: my-server
    automount: true
    state: present

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

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

Ключ	Описание
hcloud_volume_attachment словарь	Связь между сервером и томом Возвращается: всегда
server строка	Имя подключённого сервера Возвращается: всегда Пример: `"my-server"`
volume строка	Имя тома Возвращается: всегда Пример: `"my-volume"`

Авторы

Amirhossein Shaerpour (@shaerpour)

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

© 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/volume_attachment_module.html