Up-to-date reference of API arguments for IMS image you can get at documentation portal
opentelekomcloud_ims_image_v2¶
Manages a V2 Image resource within OpenTelekomCloud IMS.
Example Usage¶
Creating an image using an ECS¶
resource "opentelekomcloud_ims_image_v2" "ims_test" {
name = "imt_test"
instance_id = "54a6c3a4-8511-4d01-818f-3fe5177cbb06"
description = "Create an image using an ECS."
tags = {
foo = "bar"
key = "value"
}
}
Creating an image in the OBS bucket¶
resource "opentelekomcloud_ims_image_v2" "ims_test_file" {
name = "ims_test_file"
image_url = "ims-image:centos70.qcow2"
min_disk = 40
description = "Create an image using a file in the OBS bucket."
tags = {
foo = "bar1"
key = "value"
}
}
Creating an image using an Volume¶
resource "opentelekomcloud_ims_image_v2" "image_volume" {
name = "image_volume"
volume_id = "54a6c3a4-8511-4d01-818f-3fe5177cbb07"
os_version = "Debian GNU/Linux 10.0.0 64bit"
description = "created by Terraform"
tags = {
foo = "bar"
key = "value"
}
}
Argument Reference¶
The following arguments are supported:
name- (Required) The name of the image.description- (Optional) A description of the image. Changing this creates a new image.min_ram- (Optional) The minimum memory of the image in the unit of MB. The default value is 0, indicating that the memory is not restricted. Changing this creates a new image.max_ram- (Optional) The maximum memory of the image in the unit of MB. Changing this creates a new image.tags- (Optional) The tags of the image.instance_id- (Optional) The ID of the ECS that needs to be converted into an image. This parameter is mandatory when you create a private image from an ECS. Changing this creates a new image.volume_id- (Optional) Specifies the data disk ID. This parameter is mandatory when you create a private image from a volume. Changing this creates a new image.image_url- (Optional) The URL of the external image file in the OBS bucket. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The format is OBS bucket name:Image file name. Changing this creates a new image.min_disk- (Optional) The minimum size of the system disk in the unit of GB. This parameter is mandatory when you create a private image from an external file uploaded to an OBS bucket. The value ranges from 1 GB to 1024 GB. Changing this creates a new image.os_version- (Optional) The OS version. This parameter is valid when you create a private image from an external file. This parameter is mandatory when you create a private image from a volume. uploaded to an OBS bucket. Changing this creates a new image.is_config- (Optional) If automatic configuration is required, set the value to true. Otherwise, set the value to false. Changing this creates a new image.cmk_id- (Optional) The master key used for encrypting an image. Changing this creates a new image.type- (Optional) The image type. Must be one ofECS,FusionCompute,BMS,IronicorIsoImage. Changing this creates a new image.
Attributes Reference¶
The following attributes are exported:
id- A unique ID assigned by IMS.name- See Argument Reference above.description- See Argument Reference above.min_ram- See Argument Reference above.max_ram- See Argument Reference above.tags- See Argument Reference above.instance_id- See Argument Reference above.image_url- See Argument Reference above.min_disk- See Argument Reference above.os_version- See Argument Reference above.is_config- See Argument Reference above.cmk_id- See Argument Reference above.type- See Argument Reference above.visibility- Whether the image is visible to other tenants.data_origin- The image resource. The pattern can be 'instance,instance_id' or 'file,image_url'.disk_format- The image file format. The value can bevhd,zvhd,raw,zvhd2, orqcow2.image_size- The size(bytes) of the image file format.file- The URL for uploading and downloading the image file.
Import¶
Images can be imported using the id, e.g.
terraform import opentelekomcloud_ims_image_v2.my_image 7886e623-f1b3-473e-b882-67ba1c35887f