community.digitalocean.digital_ocean_block_storage – Создание/удаление или подключение/отключение томов блочного хранилища в DigitalOcean
Примечание
Этот плагин является частью коллекции community.digitalocean (версия 1.0.0).
Для его установки используйте: ansible-galaxy collection install community.digitalocean
Для использования в книге задач укажите: community.digitalocean.digital_ocean_block_storage
Обзор
- Создание/удаление тома блочного хранилища в DigitalOcean или подключение/отключение тома блочного хранилища к дроплету.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| block_size целое число | Размер тома блочного хранилища в гигабайтах. Требуется при command=create и state=present. Если указан snapshot_id, этот параметр будет проигнорирован. | |
| command строка / обязательный |
| Какой операцию нужно выполнить. |
| description строка | Описание тома блочного хранилища. | |
| droplet_id целое число | 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 строка | Идентификатор снимка, который вы хотите использовать для создания тома блочного хранилища. Если указан, region и block_size будут проигнорированы и изменены на null | |
| state строка / обязательный |
| Указывает желаемое состояние цели. |
| timeout целое число | По умолчанию: 30 | Время ожидания в секундах для опроса API DigitalOcean. |
| validate_certs логическое значение |
| Если установлено значение no, сертификаты SSL не будут проверены.Это значение следует устанавливать только при работе с лично контролируемыми сайтами, использующими самоподписанные сертификаты. |
| volume_name строка / обязательный | Название тома блочного хранилища. |
Примечания
Примечание
- Можно использовать две переменные среды: DO_API_KEY и DO_API_TOKEN. Обе они ссылаются на токен v2.
- Если используется snapshot_id, region и block_size будут проигнорированы и изменены на null.
Примеры
- name: Create new Block Storage
community.digitalocean.digital_ocean_block_storage:
state: present
command: create
api_token: <TOKEN>
region: nyc1
block_size: 10
volume_name: nyc1-block-storage
- name: Delete Block Storage
community.digitalocean.digital_ocean_block_storage:
state: absent
command: create
api_token: <TOKEN>
region: nyc1
volume_name: nyc1-block-storage
- name: Attach Block Storage to a Droplet
community.digitalocean.digital_ocean_block_storage:
state: present
command: attach
api_token: <TOKEN>
volume_name: nyc1-block-storage
region: nyc1
droplet_id: <ID>
- name: Detach Block Storage from a Droplet
community.digitalocean.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 |
Авторы
- Harnek Sidhu (@harneksidhu)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/digitalocean/digital_ocean_block_storage_module.html
