---
title: "openstack_images_image_v2"
description: ""
sidebar_position: 2
---

# openstack\_images\_image\_v2

:::info

This instruction is a copy of the official documentation for the OpenStack Terraform provider in the [Terraform Registry](https://registry.terraform.io/providers/terraform-provider-openstack/openstack/latest/docs).

:::

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

## Example Usage \{#example-usage}

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

  properties = {
    key = "value"
  }
}
```

## Argument Reference \{#argument-reference}

* `region` - (Optional) The region in which to obtain the V2 Glance client. A Glance client is required 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. Cannot be used simultaneously with `name_regex`.

* `name_regex` - (Optional) The regular expression of the image name. Cannot be used simultaneously with `name`. Unlike filtering by `name`, the `name_regex` filtering is performed by the client on the results of the OpenStack search query.

* `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, filtering by `properties` is performed by the client on the results of the OpenStack search query. Filtering is applied if the server response contains at least 2 images. In case there is only one image, the `properties` are ignored.

* `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.

* `tags` - (Optional) A list of tags required to be set on the image (all specified tags must be in the image's 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 the public list.

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

## Attributes Reference \{#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 container format of the image.
* `disk_format`: The disk format of the image.
* `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 allows you to meaningfully define image properties and tags. See [here](https://docs.openstack.org/glance/latest/user/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 represents the image.
* `size_bytes` - The size of the image (in bytes).
* `tags` - The list of image tags.
* `updated_at` - The date the image was last updated.