profitbricks_volume – Create or destroy a volume
profitbricks_volume – Create or destroy a volume
Synopsis
- Allows you to create or remove a volume from a ProfitBricks datacenter. This module has a dependency on profitbricks >= 1.0.0
Requirements
The below requirements are needed on the host that executes this module.
- profitbricks
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
auto_increment boolean |
|
Whether or not to increment a single number in the name for created virtual machines. |
bus - |
|
The bus type. |
count - |
Default: 1 |
The number of volumes you wish to create. |
datacenter - / required |
The datacenter in which to create the volumes. | |
disk_type - |
|
The disk type of the volume. |
image - / required |
The system image ID for the volume, e.g. a3eae284-a2fe-11e4-b187-5f1f641608c8. This can also be a snapshot image ID. | |
image_password - |
Password set for the administrative user. | |
instance_ids - |
list of instance ids, currently only used when state='absent' to remove instances. | |
licence_type - |
|
The licence type for the volume. This is used when the image is non-standard. |
name - / required |
The name of the volumes. You can enumerate the names using auto_increment. | |
size - |
Default: 10 |
The size of the volume. |
ssh_keys - |
Public SSH keys allowing access to the virtual machine. | |
state - |
|
create or terminate datacenters |
subscription_password - |
THe ProfitBricks password. Overrides the PB_PASSWORD environment variable. | |
subscription_user - |
The ProfitBricks username. Overrides the PB_SUBSCRIPTION_ID environment variable. | |
wait boolean |
|
wait for the datacenter to be created before returning |
wait_timeout - |
Default: 600 |
how long before wait gives up, in seconds |
Examples
# Create Multiple Volumes
- profitbricks_volume:
datacenter: Tardis One
name: vol%02d
count: 5
auto_increment: yes
wait_timeout: 500
state: present
# Remove Volumes
- profitbricks_volume:
datacenter: Tardis One
instance_ids:
- 'vol01'
- 'vol02'
wait_timeout: 500
state: absent
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Matt Baldwin (@baldwinSPC) <[email protected]>
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/profitbricks_volume_module.html