digital_ocean_block_storage – Создание/удаление или подключение/отключение блочных хранилищ в DigitalOcean
Новое в версии 2.2.
Обзор
- Создание/удаление блочного хранилища в DigitalOcean или подключение/отключение блочного хранилища к дроплету.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| block_size - | Размер блочного хранилища в гигабайтах. Требуется при command=create и state=present. Если указан snapshot_id, это значение будет проигнорировано. | |
| command - / обязательно |
| Какой операцию выполнить. |
| description - | Описание блочного хранилища. | |
| droplet_id - | Идентификатор дроплету, к которому нужно выполнить операцию. Требуется при command=attach. | |
| oauth_token - | Токен DigitalOcean OAuth. Можно использовать несколько переменных среды для его предоставления. Например, - 'DO_API_TOKEN', 'DO_API_KEY', 'DO_OAUTH_TOKEN' и 'OAUTH_TOKEN' Псевдонимы: api_token | |
| region - / обязательно | Код региона, в котором должно располагаться ваше блочное хранилище. Если указан snapshot_id, это значение будет проигнорировано. | |
| snapshot_id - добавлено в 2.5 | Идентификатор снимка, с которым нужно создать блочное хранилище. Если указан, region и block_size будут проигнорированы и изменены на null. | |
| state - / обязательно |
| Указывает желаемое состояние цели. |
| timeout - | По умолчанию: 30 | Время ожидания в секундах при опросе API DigitalOcean. |
| validate_certs boolean |
| Если установлено в no, сертификаты SSL не будут проверены.Это следует устанавливать только в no случае использования на собственных сайтах с самозаверенными сертификатами. |
| 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 |
Статус
- Этот модуль не гарантирует обратной совместимости. [предварительный просмотр]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.7/modules/digital_ocean_block_storage_module.html