Up-to-date reference of API arguments for Image management you can get at documentation portal
opentelekomcloud_images_image_v2¶
Manages a V2 Image resource within OpenTelekomCloud Glance.
Example Usage¶
resource "opentelekomcloud_images_image_v2" "rancheros" {
name = "RancherOS"
image_source_url = "https://releases.rancher.com/os/latest/rancheros-openstack.img"
container_format = "bare"
disk_format = "qcow2"
tags = ["foo.bar", "tag.value"]
}
Argument Reference¶
The following arguments are supported:
container_format
- (Required) The container format. Must be one ofami
,ari
,aki
,bare
,ovf
.disk_format
- (Required) The disk format. Must be one ofami
,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 withimage_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 theimage_cache_path
before being uploaded to Glance. Glance is able to download image from internet but thegophercloud
library does not yet provide a way to do so. Conflicts withlocal_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.protected
- (Optional) If true, image will not be deletable. Defaults to false.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.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 OpenTelekomCloud cloud.
-> Note: The properties
attribute handling in the gophercloud library is currently buggy
and needs to be fixed before being implemented in this resource.
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 opentelekomcloud user who owns the image.protected
- See Argument Reference above.schema
- The path to the JSON-schema that represent the image or imagesize_bytes
- The size in bytes of the data associated with the image.status
- The status of the image. It can bequeued
,active
orsaving
.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 opentelekomcloud_images_image_v2.rancheros 89c60255-9bd6-460c-822a-e2b959ede9d2