digital_ocean_block_storage — Создание/удаление или подключение/отключение томов блочного хранилища в DigitalOcean
Новое в версии 2.2.
Обзор
- Создание/удаление тома блочного хранилища в DigitalOcean или подключение/отключение тома блочного хранилища к виртуальной машине.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_token обязательно | Токен API DigitalOcean. | |
| block_size | Размер тома блочного хранилища в гигабайтах. Требуется при command=create и state=present. Если указан snapshot_id, этот параметр будет проигнорирован. | |
| command обязательно |
| Операция, которую вы хотите выполнить. |
| description | Описание тома блочного хранилища. | |
| droplet_id | Идентификатор виртуальной машины, с которой нужно выполнить операцию. Требуется при command=attach. | |
| region обязательно | Идентификатор региона, в котором должен быть расположен том блочного хранилища. Если указан snapshot_id, этот параметр будет проигнорирован. | |
| snapshot_id (добавлено в 2.5) | Идентификатор моментального снимка, с которым должен быть создан том блочного хранилища. Если указан, параметры region и block_size будут проигнорированы и установлены в null. | |
| state обязательно |
| Указывает желаемое состояние целевого объекта. |
| timeout | По умолчанию: 10 | Время ожидания в секундах для опроса API DigitalOcean. |
| volume_name обязательно | Имя тома блочного хранилища. |
Примечания
Примечание
- Можно использовать две переменные окружения: DO_API_KEY и DO_API_TOKEN. Обе они ссылаются на токен v2.
- Если используется snapshot_id, параметры region и block_size будут проигнорированы и установлены в null.
Примеры
# 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 |
Статус
Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- Harnek Sidhu (github: @harneksidhu)
Подсказка
Если вы заметили какие-либо проблемы в этом документе, вы можете отредактировать его, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/digital_ocean_block_storage_module.html
