How to use the API to create a droplet with attached block storage?

You can specify Volume ID(s) when you create a Droplet. I am sorry, I have discovered that the documentation is missing that field, I will get that fixed. Also, the power state of the Droplet should not matter when attaching/detaching a Volume. If you run into a problem with this, please contact DO Support with the Droplet and Volume name. https://pkg.go.dev/github.com/digitalocean/godo#DropletCreateRequest https://pkg.go.dev/github.com/digitalocean/godo#DropletCreateVolume

Hi there,

I believe that pre-formatted volumes created via the API will be automatically mounted to the Droplet. So the key thing is to specify the initial_filesystem_type when creating the volume.

For example if you are using Terraform, this would look as follows:

resource "digitalocean_droplet" "foo" {
  name       = "foo"
  size       = "s-1vcpu-1gb"
  image      = "ubuntu-22-04-x64"
  region     = "nyc1"
}

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

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

The resulting volume will be mounted and available at /mnt/bar/ on the Droplet.

If you do not specify the initial_filesystem_type the volume will appear as a raw block device that must be manually formatted and mounted.