digital_ocean_block_storage - Создание/удаление или подключение/отключение блочных хранилищ в DigitalOcean
Новое в версии 2.2.
Описание
- Создание/удаление блочного хранилища в DigitalOcean или подключение/отключение блочного хранилища к дроплету.
Параметры
| параметр | обязательно | по умолчанию | значения | комментарии |
|---|---|---|---|---|
| api_token | да | Токен API DigitalOcean. | ||
| block_size | нет | Размер блочного хранилища в гигабайтах. Требуется, когда command=create и state=present. | ||
| command | да |
| Операция, которую нужно выполнить. | |
| description | нет | Описание блочного хранилища. | ||
| droplet_id | нет | ID дроплету, с которым нужно выполнить операцию. Требуется, когда command=attach. | ||
| region | да | Идентификатор региона, в котором должно располагаться блочное хранилище. | ||
| state | да |
| Указывает желаемое состояние объекта. | |
| timeout | нет | 10 | Таймаут в секундах, используемый для опроса API DigitalOcean. | |
| volume_name | да | Имя блочного хранилища. |
Примеры
# Create new Block Storage
- digital_ocean_block_storage:
state: present
command: create
api_token: <TOKEN>
region: nyc1
block_size: 10
volume_name: nyc1-block-storage
# Delete Block Storage
- digital_ocean_block_storage:
state: absent
command: create
api_token: <TOKEN>
region: nyc1
volume_name: nyc1-block-storage
# Attach Block Storage to a Droplet
- digital_ocean_block_storage:
state: present
command: attach
api_token: <TOKEN>
volume_name: nyc1-block-storage
region: nyc1
droplet_id: <ID>
# Detach Block Storage from a Droplet
- digital_ocean_block_storage:
state: absent
command: attach
api_token: <TOKEN>
volume_name: nyc1-block-storage
region: nyc1
droplet_id: <ID>
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| id | Уникальный идентификатор блочного хранилища, возвращаемый при создании. | изменён | строка | 69b25d9a-494c-12e6-a5af-001f53126b44 |
Примечания
Примечание
- Можно использовать две переменные среды: DO_API_KEY и DO_API_TOKEN. Обе они относятся к токену v2.
Статус
Этот модуль помечен как превью, что означает, что интерфейс не гарантирует обратную совместимость.
Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, ознакомьтесь с Информацией о сообществе и участии, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/digital_ocean_block_storage_module.html