» digitalocean_volume

Provides a DigitalOcean Block Storage volume which can be attached to a Droplet in order to provide expanded storage.

» Example Usage

resource "digitalocean_volume" "foobar" {
  region                  = "nyc1"
  name                    = "baz"
  size                    = 100
  initial_filesystem_type = "ext4"
  description             = "an example volume"
}

resource "digitalocean_droplet" "foobar" {
  name       = "baz"
  size       = "s-1vcpu-1gb"
  image      = "ubuntu-18-04-x64"
  region     = "nyc1"
}

resource "digitalocean_volume_attachment" "foobar" {
  droplet_id = "${digitalocean_droplet.foobar.id}"
  volume_id  = "${digitalocean_volume.foobar.id}"
}

You can also create a volume from an existing snapshot.

data "digitalocean_volume_snapshot" "foobar" {
  name = "baz"
}

resource "digitalocean_volume" "foobar" {
  region      = "lon1"
  name        = "foo"
  size        = "${data.digitalocean_volume_snapshot.foobar.min_disk_size}"
  snapshot_id = "${data.digitalocean_volume_snapshot.foobar.id}"
}

» Argument Reference

The following arguments are supported:

  • region - (Required) The region that the block storage volume will be created in.
  • name - (Required) A name for the block storage volume. Must be lowercase and be composed only of numbers, letters and "-", up to a limit of 64 characters.
  • size - (Required) The size of the block storage volume in GiB. If updated, can only be expanded.
  • description - (Optional) A free-form text field up to a limit of 1024 bytes to describe a block storage volume.
  • snapshot_id - (Optional) The ID of an existing volume snapshot from which the new volume will be created. If supplied, the region and size will be limitied on creation to that of the referenced snapshot
  • initial_filesystem_type - (Optional) Initial filesystem type (xfs or ext4) for the block storage volume.
  • initial_filesystem_label - (Optional) Initial filesystem label for the block storage volume.

» Attributes Reference

The following attributes are exported:

  • id - The unique identifier for the block storage volume.
  • urn: The uniform resource name for the storage volume.
  • filesystem_type - Filesystem type (xfs or ext4) for the block storage volume.
  • filesystem_label - Filesystem label for the block storage volume.
  • droplet_ids - A list of associated droplet ids.

» Import

Volumes can be imported using the volume id, e.g.

terraform import digitalocean_volume.volume 506f78a4-e098-11e5-ad9f-000f53306ae1