openstack_images_image_v2

Manages a V2 Image resource within OpenStack Glance.

Example Usage

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

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.

• 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 that will be downloaded in the image_cache_path before being uploaded to Glance. Glance is able to download image from internet but the gophercloud library does not yet provide a way to do so. Conflicts with local_file_path.

• 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.

• properties - (Optional) A map of key/value pairs to set freeform information about an image.

• protected - (Optional) If true, image will not be deletable. 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. Defaults to true.

• 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.

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 http://docs.openstack.org/developer/glance/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.
• 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.
• update_at - The date the image was last updated.
• visibility - See Argument Reference above.

Import

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

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