Skip to main content

dtcloud_image_versions (Data Source)

Reads the platform's own image catalogue.

This is not the same list as dtcloud_images. That one is what the image service holds; this one is the curated set the platform offers, and it is the only place that says which flavors an image may be built on.

Example Usage​

# The platform's curated catalogue -- not the same list as dtcloud_images, and
# the only place that says which flavors an image may be built on.
data "dtcloud_image_versions" "ubuntu" {
  type = "ubuntu"
}

Schema​

Optional​

  • type (String) Only return entries in this family, e.g. ubuntu. Applied by the provider; the endpoint takes no parameters.

Read-Only​

  • id (String) The ID of this resource.
  • versions (List of Object) Catalogue entries, sorted by family and then by version. (see below for nested schema)

Nested Schema for versions​

Read-Only:

  • id (String)
  • image_type (String)
  • min_volume_size (Number)
  • type (String)
  • valid_flavor_ids (List of String)
  • version (String)

Behaviour worth knowing​

  • A sorted list, not a map. The endpoint groups entries by family. They are flattened into one list and sorted by family and then by version, so a new catalogue entry does not reshuffle a plan. A new family can still shift the indexes after it, so filter with type and match on version rather than indexing into the full list.
  • type is applied by the provider and ignores case; the endpoint takes no parameters.
  • An empty valid_flavor_ids means no restriction. The catalogue field is untyped, and a list, a comma-separated string or a single value are all read back as a list.