openstack_images_image_v2
These instructions are a copy of the official OpenStack Terraform provider documentation in the Terraform Registry.
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 witha compute instance. If omitted, theregion
argument of the provideris used. -
most_recent
— (Optional) If more than one result is returned, use the mostrecent image. -
name
— (Optional) The name of the image. Cannot be used simultaneouslywithname_regex
. -
name_regex
— (Optional) The regular expressian of the name of the image.Cannot be used simultaneously withname
. Unlike filtering byname
thename_regex
filtering does by client on the result of OpenStack searchquery. -
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. Unlike other options filteringbyproperties
does by client on the result of OpenStack search query.Filtering is applied if server response contains at least 2 images. Incase there is only one image theproperties
ignores. -
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 eitherasc
ordesc
. -
sort_key
— (Optional) Sort images based on a certain key. Defaults toname
. -
tag
— (Optional) Search for images with a specific tag. -
tags
— (Optional) A list of tags required to be set on the image (all specified tags must be in the images tag list for it to be matched). -
visibility
— (Optional) The visibility of the image. Must be one of "public", "private", "community", or "shared". Defaults to "private". -
hidden
— (Optional) Whether or not the image is hidden from public list. -
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 attributesare 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 represents 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 propertiesand tags. See here.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 representsthe image or imagesize_bytes
— The size of the image (in bytes).tags
— The tags list of the image.updated_at
— The date the image was last updated.