digital_ocean_block_storage - Создание/удаление или подключение/отключение томов Block Storage в DigitalOcean
Новая версия 2.2.
Описание
- Создание/удаление тома Block Storage в DigitalOcean или подключение/отключение тома Block Storage к виртуальной машине.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| block_size | Размер тома Block Storage в гигабайтах. Требуется при command=create и state=present. Если указан snapshot_id, этот параметр игнорируется. | |
| command обязательно |
| Операция, которую вы хотите выполнить. |
| description | Описание тома Block Storage. | |
| droplet_id | Идентификатор виртуальной машины, с которой вы хотите работать. Требуется при command=attach. | |
| oauth_token | Токен DigitalOcean OAuth. Можно использовать несколько переменных среды для указания этого значения. Например, - 'DO_API_TOKEN', 'DO_API_KEY', 'DO_OAUTH_TOKEN' и 'OAUTH_TOKEN' псевдонимы: api_token | |
| region обязательно | Идентификатор региона, в котором должен быть расположен том Block Storage. Если указан snapshot_id, этот параметр игнорируется. | |
| snapshot_id (добавлено в 2.5) | Идентификатор снимка, который вы хотите использовать для создания тома Block Storage. Если указан, параметры region и block_size будут проигнорированы и установлены в null. | |
| state обязательно |
| Указывает желаемое состояние целевого объекта. |
| timeout | Значение по умолчанию: 30 | Таймаут в секундах для ожидания ответа API DigitalOcean. |
| validate_certs bool |
| Если установлено в no, сертификаты SSL не будут проверены.Это следует устанавливать только в no на сайтах, управляемых вами и использующих самозаверяющие сертификаты. |
| volume_name обязательно | Имя тома Block Storage. |
Примечания
Примечание
- Можно использовать две переменные среды: 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 строка | изменено | Уникальный идентификатор тома Block Storage, возвращенный при создании. Пример: 69b25d9a-494c-12e6-a5af-001f53126b44 |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Техническое обслуживание
Этот модуль помечен как community, что означает, что его поддерживает сообщество Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом 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.6/modules/digital_ocean_block_storage_module.html
