Links
Comment on page

volume

Type representing a IonosCloud storage volume.

Parameters:

Name
Required
Description
name
true
The name of the volume.
image_password
The image password for the "root" or "Administrator" account.
ssh_keys
One or more SSH keys to allow access to the volume via SSH.

Properties:

Name
Required
Description
ensure
No
The basic property that the resource should be in. Valid values are present, absent.
size
No
The size of the volume in GB.
image_id
No
The image or snapshot ID.
availability_zone
No
The availability zone of where the volume will reside.
bus
No
The bus type of the volume. Valid values are VIRTIO, IDE.
volume_type
No
The volume type. Valid values are HDD.
user_data
No
The cloud-init configuration for the volume as base64 encoded string. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' that has cloud-init compatibility in conjunction with this property.
licence_type
No
The license type of the volume. Valid values are LINUX, WINDOWS, WINDOWS2016, UNKNOWN, OTHER.
device_number
No
The LUN ID of the storage volume. Null for volumes not mounted to any VM
pci_slot
No
The PCI slot number of the storage volume. Null for volumes not mounted to any VM
backupunit_id
No
The uuid of the Backup Unit that user has access to. The property is immutable and is only allowed to be set on a new volume creation. It is mandatory to provide either 'public image' or 'imageAlias' in conjunction with this property.
cpu_hot_plug
No
Indicates CPU hot plug capability.
ram_hot_plug
No
Indicates memory hot plug capability.
nic_hot_plug
No
Indicates NIC hot plug capability.
nic_hot_unplug
No
Indicates NIC hot unplug capability.
disc_virtio_hot_plug
No
Indicates VirtIO drive hot plug capability.
disc_virtio_hot_unplug
No
Indicates VirtIO drive hot unplug capability.
datacenter_id
No
The ID of the virtual data center where the volume will reside.
datacenter_name
No
The name of the virtual data center where the volume will reside.
id
No
The volume ID.
***

Changeable properties:

  • size

Examples

To list resources:

puppet resource volume
NOTE: If two resources have the same name only one of them will be shown.

To create, update or delete a resource:

$datacenter_name = 'TestDataCenter'
datacenter { $datacenter_name :
ensure => present,
location => 'us/las'
}
-> volume { 'testvolume' :
ensure => present,
datacenter_name => $datacenter_name,
licence_type => 'LINUX',
size => 50,
volume_type => 'SSD',
availability_zone => 'AUTO',
bus => 'IDE',
cpu_hot_plug => true,
}
NOTE: If two resources with the same name ar found an error will be thrown, this only applies to cases where the resource cannot be identified. Example: an error is thrown for two servers with the same name in the same datacenter, not for two servers with the same name, but in different datacenters.