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

# openstack\_images\_image\_v2

:::info

Эта инструкция — копия официальной документации OpenStack Terraform-провайдера в [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 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. Cannot be used simultaneously
  with `name_regex`.

* `name_regex` - (Optional) The regular expressian of the name of the image.
  Cannot be used simultaneously with `name`. Unlike filtering by `name` the
  `name_regex` filtering does by client on the result of 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` does by client on the result of OpenStack search query.
  Filtering is applied if server responce contains at least 2 images. In
  case there is only one image the `properties` 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 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 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 \{#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 [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 represent
  the image or image
* `size_bytes` - The size of the image (in bytes).
* `tags` - The tags list of the image.
* `updated_at` - The date the image was last updated.