cloudscale_volume – Управляет томами на облачном сервисе cloudscale.ch IaaS
Новая версия с 2.8.
Обзор
- Создание, подключение/отключение, обновление и удаление томов на облачном сервисе cloudscale.ch IaaS.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
|
api_timeout
-
|
Значение по умолчанию: 30
|
Время ожидания в секундах для вызовов API cloudscale.ch.
|
|
api_token
-
|
Токен API cloudscale.ch.
Также может быть передан в переменной среды
CLOUDSCALE_API_TOKEN.
|
|
|
name
строка
|
Имя тома. Для изменения существующего тома необходимо указать либо имя, либо UUID.
|
|
|
server_uuids
список
|
UUID серверов, к которым подключен этот том. Установите значение
[] для отключения тома. В настоящее время том может быть подключен только к одному серверу.псевдонимы: server_uuid |
|
|
size_gb
целое число
|
Размер тома в ГБ. |
|
|
state
строка
|
|
Состояние тома. |
|
tags
словарь
добавлено в 2.9
|
Теги, связанные с томом. Установите значение {} для удаления всех тегов. |
|
|
type
строка
|
|
Тип тома. Не может быть изменён после создания тома. По умолчанию ssd при создании тома. |
|
uuid
строка
|
UUID тома. Для изменения существующего тома необходимо указать либо имя, либо UUID. |
Примечания
Примечание
- Для создания нового тома необходимо указать как минимум параметры name и size_gb.
- Можно создать том и подключить его к серверу в рамках одной задачи.
- Вместо параметра api_token можно использовать переменную среды
CLOUDSCALE_API_TOKEN. - Все операции выполняются с использованием общедоступного API cloudscale.ch v1.
- Полную документацию API см. по адресу: https://www.cloudscale.ch/ru/api/v1.
- Для всех операций требуется действительный токен API. Вы можете создать любое количество токенов с помощью панели управления cloudscale.ch по адресу https://control.cloudscale.ch.
Примеры
# Create a new SSD volume
- name: Create an SSD volume
cloudscale_volume:
name: my_ssd_volume
size_gb: 50
api_token: xxxxxx
register: my_ssd_volume
# Attach an existing volume to a server
- name: Attach volume to server
cloudscale_volume:
uuid: my_ssd_volume.uuid
server_uuids:
- ea3b39a3-77a8-4d0b-881d-0bb00a1e7f48
api_token: xxxxxx
# Create and attach a volume to a server
- name: Create and attach volume to server
cloudscale_volume:
name: my_ssd_volume
size_gb: 50
server_uuids:
- ea3b39a3-77a8-4d0b-881d-0bb00a1e7f48
api_token: xxxxxx
# Detach volume from server
- name: Detach volume from server
cloudscale_volume:
uuid: my_ssd_volume.uuid
server_uuids: []
api_token: xxxxxx
# Delete a volume
- name: Delete volume
cloudscale_volume:
name: my_ssd_volume
state: absent
api_token: xxxxxx
Возвращаемые значения
Общие возвращаемые значения описаны здесь. Следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
|
href
строка
|
state == present |
URL API для получения подробностей о томе.
Пример:
https://api.cloudscale.ch/v1/volumes/2db69ba3-1864-4608-853a-0771b6885a3a
|
|
name
строка
|
state == present | Отображаемое имя тома.
Пример:
my_ssd_volume
|
|
server_uuids
список
|
state == present | UUID серверов, к которым подключен этот том.
Пример:
['47cec963-fcd2-482f-bdb6-24461b2d47b1']
|
|
size_gb
строка
|
state == present | Размер тома в ГБ.
Пример:
50
|
|
state
строка
|
success | Текущее состояние тома.
Пример:
present
|
|
tags
словарь
добавлено в 2.9
|
state == present | Теги, связанные с томом.
Пример:
{'project': 'my project'}
|
|
type
строка
|
state == present | Тип тома.
Пример:
bulk
|
|
uuid
строка
|
state == present | Уникальный идентификатор тома.
Пример:
2db69ba3-1864-4608-853a-0771b6885a3a
|
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Gaudenz Steinlin (@gaudenz)
- René Moser (@resmo)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/cloudscale_volume_module.html
