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

Новое в версии 2.8.

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

Обзор

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

Требования

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

hcloud-python >= 1.0.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_token строка / обязательно		Токен API для Hetzner Cloud.
automount логическое значение	Варианты: нет да	Автоматически монтировать том.
endpoint строка	По умолчанию: "https://api.hetzner.cloud/v1"	Адрес API для Hetzner Cloud.
format строка	Варианты: xfs ext4	Автоматически форматировать том при создании Можно использовать только в том случае, если том не существует.
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 сложное		Всегда	Блочный том
	id целое число	Всегда	Идентификатор тома Пример: 12345
	labels словарь	Всегда	Пользовательские метки (пары ключ-значение) Пример: {'key': 'value', 'mylabel': 123}
	location строка	Всегда	Имя расположения, где находится том Пример: fsn1
	name строка	Всегда	Имя тома Пример: my-volume
	server строка	Всегда	Имя сервера, к которому прикреплен том Пример: my-server
	size целое число	Всегда	Размер тома в ГБ Пример: 1337

Статус

Этот модуль не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Christopher Schmitt (@cschmitt-hcloud)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/hcloud_volume_module.html