openstack_images_image_v2

Use this data source to get the ID of an available OpenStack image.

Example Usage

data "openstack_images_image_v2" "ubuntu" {
  name = "Ubuntu 16.04"
  most_recent = true

  properties {
    key = "value"
  }
}

Argument Reference

  • region - (Optional) The region in which to obtain the V2 Glance client. A Glance client is needed to create an Image that can be used with a compute instance. If omitted, the region argument of the provider is used.

  • most_recent - (Optional) If more than one result is returned, use the most recent image.

  • name - (Optional) The name of the image.

  • owner - (Optional) The owner (UUID) of the image.

  • properties - (Optional) a map of key/value pairs to match an image with. All specified properties must be matched.

  • size_min - (Optional) The minimum size (in bytes) of the image to return.

  • size_max - (Optional) The maximum size (in bytes) of the image to return.

  • sort_direction - (Optional) Order the results in either asc or desc.

  • sort_key - (Optional) Sort images based on a certain key. Defaults to name.

  • tag - (Optional) Search for images with a specific tag.

  • visibility - (Optional) The visibility of the image. Must be one of "public", "private", "community", or "shared". Defaults to "private".

  • member_status - (Optional) The status of the image. Must be one of "accepted", "pending", "rejected", or "all".

Attributes Reference

id is set to the ID of the found image. In addition, the following attributes are exported:

  • checksum - The checksum of the data associated with the image.
  • created_at - The date the image was created.
  • container_format: The format of the image's container.
  • disk_format: The format of the image's disk.
  • file - the trailing path after the glance endpoint that represent the location of the image or the path to retrieve it.
  • metadata - The metadata associated with the image. Image metadata allow for meaningfully define the image properties and tags. See http://docs.openstack.org/developer/glance/metadefs-concepts.html.
  • min_disk_gb - The minimum amount of disk space required to use the image.
  • min_ram_mb - The minimum amount of ram required to use the image.
  • properties - Freeform information about the image.
  • protected - Whether or not the image is protected.
  • schema - The path to the JSON-schema that represent the image or image
  • size_bytes - The size of the image (in bytes).
  • tags - See Argument Reference above.
  • update_at - The date the image was last updated.

© 2018 HashiCorp
Licensed under the MPL 2.0 License.
https://www.terraform.io/docs/providers/openstack/d/images_image_v2.html