digitalocean_images

Get information on images for use in other resources (e.g. creating a Droplet based on a snapshot), with the ability to filter and sort the results. If no filters are specified, all images will be returned.

This data source is useful if the image in question is not managed by Terraform or you need to utilize any of the image's data.

Note: You can use the digitalocean_image data source to obtain metadata about a single image if you already know the slug, unique name, or id to retrieve.

Example Usage

Use the filter block with a key string and values list to filter images.

For example to find all Ubuntu images:

data "digitalocean_images" "ubuntu" {
  filter {
    key    = "distribution"
    values = ["Ubuntu"]
  }
}

You can filter on multiple fields and sort the results as well:

data "digitalocean_images" "available" {
  filter {
    key    = "distribution"
    values = ["Ubuntu"]
  }
  filter {
    key    = "regions"
    values = ["nyc3"]
  }
  sort {
    key       = "created"
    direction = "desc"
  }
}

Argument Reference

filter supports the following arguments:

sort supports the following arguments:

Attributes Reference