---
title: "openstack_images_image_v2"
description: ""
sidebar_position: 3
---

# openstack\_images\_image\_v2

:::info

Эта инструкция — копия официальной документации OpenStack Terraform-провайдера в [Terraform Registry](https://registry.terraform.io/providers/terraform-provider-openstack/openstack/latest/docs).

:::

Manages a V2 Image resource within OpenStack Glance.

:::danger

All arguments including the source image URL password will be stored in the raw state as plain-text. [Read more about sensitive data in state](https://developer.hashicorp.com/terraformdocs/language/state/sensitive-data.html).

:::

## Example Usage \{#example-usage}

```hcl
resource "openstack_images_image_v2" "rancheros" {
  name             = "RancherOS"
  image_source_url = "https://releases.rancher.com/os/latest/rancheros-openstack.img"
  container_format = "bare"
  disk_format      = "qcow2"

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

## Argument Reference \{#argument-reference}

The following arguments are supported:

* `container_format` - (Required) The container format. Must be one of
  "ami", "ari", "aki", "bare", "ovf".

* `disk_format` - (Required) The disk format. Must be one of
  "ami", "ari", "aki", "vhd", "vmdk", "raw", "qcow2", "vdi", "iso".

* `local_file_path` - (Optional) This is the filepath of the raw image file
  that will be uploaded to Glance. Conflicts with `image_source_url` and
  `web_download`.

* `image_cache_path` - (Optional) This is the directory where the images will
  be downloaded. Images will be stored with a filename corresponding to
  the url's md5 hash. Defaults to "$HOME/.terraform/image\_cache"

* `image_source_url` - (Optional) This is the url of the raw image. If `web_download`
  is not used, then the image will be downloaded in the `image_cache_path` before being uploaded to Glance.
  Conflicts with `local_file_path`.

* `image_source_username` - (Optional) The username of basic auth to download `image_source_url`.

* `image_source_password` - (Optional) The password of basic auth to download `image_source_url`.

* `min_disk_gb` - (Optional) Amount of disk space (in GB) required to boot image.
  Defaults to 0.

* `min_ram_mb` - (Optional) Amount of ram (in MB) required to boot image.
  Defauts to 0.

* `name` - (Required) The name of the image.

* `image_id` - (Optional) Unique ID (valid UUID) of image to create. Changing
  this creates a new image.

* `properties` - (Optional) A map of key/value pairs to set freeform
  information about an image. See the "Notes" section for further
  information about properties.

* `protected` - (Optional) If true, image will not be deletable.
  Defaults to false.

* `hidden` - (Optional) If true, image will be hidden from public list.
  Defaults to false.

* `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. Changing this creates a new Image.

* `tags` - (Optional) The tags of the image. It must be a list of strings.
  At this time, it is not possible to delete all tags of an image.

* `verify_checksum` - (Optional) If false, the checksum will not be verified
  once the image is finished uploading. Conflicts with `web_download`.
  Defaults to true when not using `web_download`.

* `visibility` - (Optional) The visibility of the image. Must be one of
  "public", "private", "community", or "shared". The ability to set the
  visibility depends upon the configuration of the OpenStack cloud.

* `web_download` - (Optional) If true, the "web-download" import method will
  be used to let OpenStack download the image directly from the remote source.
  Conflicts with `local_file_path`. Defaults to false.

* `decompress` - (Optional) If true, this provider will decompress downloaded
  image before uploading it to OpenStack. Decompression algorithm is chosen by
  checking "Content-Type" header, supported algorithm are: gzip, bzip2 and xz.
  Defaults to false. Changing this creates a new Image.

## Attributes Reference \{#attributes-reference}

The following attributes are exported:

* `checksum` - The checksum of the data associated with the image.
* `container_format` - See Argument Reference above.
* `created_at` - The date the image was created.
* `disk_format` - See Argument Reference above.
* `file` - the trailing path after the glance
  endpoint that represent the location of the image
  or the path to retrieve it.
* `id` - A unique ID assigned by Glance.
* `metadata` - The metadata associated with the image.
  Image metadata allow for meaningfully define the image properties
  and tags. See https://docs.openstack.org/glance/latest/user/metadefs-concepts.html.
* `min_disk_gb` - See Argument Reference above.
* `min_ram_mb` - See Argument Reference above.
* `name` - See Argument Reference above.
* `owner` - The id of the openstack user who owns the image.
* `properties` - See Argument Reference above.
* `protected` - See Argument Reference above.
* `hidden` - See Argument Reference above.
* `region` - See Argument Reference above.
* `schema` - The path to the JSON-schema that represent
  the image or image
* `size_bytes` - The size in bytes of the data associated with the image.
* `status` - The status of the image. It can be "queued", "active"
  or "saving".
* `tags` - See Argument Reference above.
* `updated_at` - The date the image was last updated.
* `update_at` - (**Deprecated** - use `updated_at` instead)
* `visibility` - See Argument Reference above.

## Notes \{#notes}

### Properties \{#properties}

This resource supports the ability to add properties to a resource during
creation as well as add, update, and delete properties during an update of this
resource.

Newer versions of OpenStack are adding some read-only properties to each image.
These properties start with the prefix `os_`. If these properties are detected,
this resource will automatically reconcile these with the user-provided
properties.

In addition, the `direct_url` and `stores` properties are also automatically reconciled if the
Image Service set it.

## Import \{#import}

Images can be imported using the `id`, e.g.

```bash
$ terraform import openstack_images_image_v2.rancheros 89c60255-9bd6-460c-822a-e2b959ede9d2
```