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 целое число		ID блока тома Hetzner Cloud для управления. Требуется только если не задано имя тома.
labels словарь		Пользовательские пары ключ-значение.
location строка		Местоположение тома Hetzner Cloud. Требуется, если не задан сервер и том не существует.
name строка		Имя блока тома Hetzner Cloud для управления. Требуется, если не задан id тома или том не существует.
server строка		Имя сервера, к которому должен быть привязан том. Требуется, если не задано location и том не существует.
size целое число		Размер блочного тома. Требуется, если том еще не существует.
state строка	Варианты: absent present ←	Состояние тома.

См. также

Документация 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 целое число	Всегда	ID тома Пример: 12345
	labels словарь	Всегда	Пользовательские метки (пары ключ-значение) Пример: {'key': 'value', 'mylabel': 123}
	location строка	Всегда	Имя расположения, где находится том Пример: fsn1
	name строка	Всегда	Имя тома Пример: мой-том
	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.8/modules/hcloud_volume_module.html