hetzner.hcloud.hcloud_volume – Создание и управление блочным томом на Hetzner Cloud.

Примечание

Этот плагин входит в состав коллекции hetzner.hcloud (версия 1.2.1).

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

Для использования в плейбуке укажите: hetzner.hcloud.hcloud_volume

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

Обзор

Создание, обновление и подключение/отключение блочного тома на Hetzner Cloud.

Требования

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

hcloud-python >= 1.0.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_token строка / обязательно		Токен API для Hetzner Cloud.
automount логическое значение	Варианты: нет ← да	Автоматически монтировать том.
delete_protection логическое значение	Варианты: нет да	Защитить том от удаления.
endpoint строка	Значение по умолчанию: "https://api.hetzner.cloud/v1"	Конечная точка API для Hetzner Cloud.
format строка	Варианты: xfs ext4	Автоматически отформатировать том при создании. Можно использовать только в случае, если том еще не существует.
id целое число		ID блочного тома Hetzner Cloud для управления. Требуется только если не указано имя тома.
labels словарь		Пользовательские пары ключ-значение.
location строка		Расположение тома Hetzner Cloud. Требуется, если не указан сервер и том еще не существует.
name строка		Имя блочного тома Hetzner Cloud для управления. Требуется только если не указан ID тома или том еще не существует.
server строка		Имя сервера, к которому должен быть прикреплен том. Требуется, если не указано расположение и том еще не существует.
size целое число		Размер блочного тома в ГБ. Требуется, если том еще не существует.
state строка	Варианты: отсутствует наличие ←	Состояние тома.

См. также

Документация API Hetzner Cloud: Полное описание API Hetzner Cloud.

Примеры

- name: Create a Volume
  hcloud_volume:
    name: my-volume
    location: fsn1
    size: 100
    state: present
- name: Create a Volume and format it with ext4
  hcloud_volume:
    name: my-volume
    location: fsn
    format: ext4
    size: 100
    state: present
- name: Mount a existing Volume and automount
  hcloud_volume:
    name: my-volume
    server: my-server
    automount: yes
    state: present
- name: Mount a existing Volume and automount
  hcloud_volume:
    name: my-volume
    server: my-server
    automount: yes
    state: present
- name: Ensure the Volume is absent (remove if needed)
  hcloud_volume:
    name: my-volume
    state: absent

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

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

Ключ		Возвращается	Описание
hcloud_volume сложный тип		Всегда	Блочный том
	delete_protection логическое значение добавлен в 0.1.0 hetzner.hcloud	всегда	Истина, если том защищен от удаления
	id целое число	Всегда	ID тома Пример: 12345
	labels словарь	Всегда	Пользовательские метки (пары ключ-значение) Пример: {'ключ': 'значение', 'мояметка': 123}
	linux_device строка добавлен в 0.1.0 hetzner.hcloud	всегда	Путь к устройству, содержащему том. Пример: /dev/disk/by-id/scsi-0HC_Volume_12345
	location строка	Всегда	Имя расположения, где находится том Пример: fsn1
	name строка	Всегда	Имя тома Пример: мой-том
	server строка	Всегда	Имя сервера, к которому подключен том Пример: мой-сервер
	size целое число	Всегда	Размер тома в ГБ Пример: 1337

Авторы

Christopher Schmitt (@cschmitt-hcloud)

© 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/hetzner/hcloud/hcloud_volume_module.html