» ucloud_instance

Provides an UHost Instance resource.

Note The instance will reboot automatically to make the change take effect when update instance_type, root_password, boot_disk_size, data_disk_size.

» Example Usage

# Query default security group
data "ucloud_security_groups" "default" {
    type = "recommend_web"
}

# Query image
data "ucloud_images" "default" {
  availability_zone = "cn-bj2-04"
  name_regex        = "^CentOS 6.5 64"
  image_type        = "base"
}

# Create web instance 
resource "ucloud_instance" "web" {
    name              = "tf-example-instance"
    tag               = "tf-example"
    availability_zone = "cn-bj2-04"
    image_id          = "${data.ucloud_images.default.images.0.id}"
    instance_type     = "n-standard-1"

    # use local disk as data disk
    data_disk_size     = 50
    data_disk_type     = "local_normal"
    root_password      = "wA1234567"

    # the default Web Security Group that UCloud recommend to users
    security_group = "${data.ucloud_security_groups.default.security_groups.0.id}"
}

» Argument Reference

The following arguments are supported:

availability_zone - (Required) Availability zone where instance is located. such as: cn-bj2-02. You may refer to list of availability zone
image_id - (Required) The ID for the image to use for the instance.
instance_type - (Required) The type of instance. There are two types, one is defined by UCloud provider: n-Type-CPU(eg:n-highcpu-2), thereinto, Type can be highcpu, basic, standard, highmem which represent the ratio of CPU and memory respectively (1:1, 1:2, 1:4, 1:8). The other is defined Customized: n-customized-CPU-Memory(eg:n-customized-1-3). Be attention, if the type can be defined by n-Type-CPU, another type will not be allowed. In addition, range of CPU in core: 1-32, range of memory in MB: 1-256. When it is changed, the instance will reboot automatically to make the change take effect.
root_password - (Optional) The password for the instance, which contains 8-30 characters, and at least 2 items of capital letters, lower case letters, numbers and special characters. The special characters include `()~!@#$%^{&*-+=_|{}[]:;'<>,.?/}. If not specified, terraform will autogenerate a password. Note: When it is changed, the instance will reboot automatically to make the change take effect.
boot_disk_size - (Optional) The size of the boot disk, measured in GB (GigaByte). Range: 20-100. The value set of disk size must be larger or equal to 20(default: 20) for Linux and 40 (default: 40) for Windows. The responsive time is a bit longer if the value set is larger than default for local boot disk, and further settings may be required on host instance if the value set is larger than default for cloud boot disk. The disk volume adjustment must be a multiple of 10 GB. When it is changed, the instance will reboot automatically to make the change take effect and need to go to the instance for configuration. In addition, any reduction of boot disk size is not supported.
boot_disk_type - (Optional) The type of boot disk. Possible values are: local_normal and local_ssd for local boot disk, cloud_normal and cloud_ssd for cloud boot disk. (Default: local_normal). The local_ssd, cloud_normal and cloud_ssd are not fully support by all regions as boot disk type, please proceed to UCloud console for more details.
data_disk_type - (Optional) The type of local data disk. Possible values are: local_normal and local_ssd for local data disk. (Default: local_normal). The local_ssd is not supported in all regions as data disk type, please proceed to UCloud console for more details.
data_disk_size - (Optional) The size of data disk, measured in GB (GigaByte), range: 0-8000 (Default: 20), 0-8000 for cloud disk, 0-2000 for local sata disk and 100-1000 for local ssd disk (all the GPU type instances are included). The volume adjustment must be a multiple of 10 GB. When it is changed, the instance will reboot automatically to make the change take effect and need to go to the instance for configuration. In addition, any reduction of data disk size is not supported.
charge_type - (Optional) The charge type of instance, possible values are: year, month and dynamic as pay by hour (specific permission required). (Default: month).
duration - (Optional) The duration that you will buy the instance (Default: 1). The value is 0 when pay by month and the instance will be vaild till the last day of that month. It is not required when dynamic (pay by hour).
name - (Optional) The name of instance, which contains 1-63 characters and only support Chinese, English, numbers, '-', '_', '.'. If not specified, terraform will autogenerate a name beginning with tf-instance.
remark - (Optional) The remarks of instance. (Default: "").
security_group - (Optional) The ID of the associated security group.
subnet_id - (Optional) The ID of subnet. If defined vpc_id, the subnet_id is Required. If not defined vpc_id and subnet_id, the instance will use the default subnet in the current region.
tag - (Optional) A tag assigned to instance, which contains at most 63 characters and only support Chinese, English, numbers, '-', '_', and '.'. If it is not filled in or a empty string is filled in, then default tag will be assigned. (Default: Default).
vpc_id - (Optional) The ID of VPC linked to the instance. If not defined vpc_id, the instance will use the default VPC in the current region.

» Attributes Reference

In addition to all arguments above, the following attributes are exported:

auto_renew - Whether to renew an instance automatically or not.
cpu - The number of cores of virtual CPU, measureed in core.
memory - The size of memory, measured in MB (Megabyte).
create_time - The time of creation for instance, formatted in RFC3339 time string.
expire_time - The expiration time for instance, formatted in RFC3339 time string.
status - Instance current status. Possible values are Initializing, Starting, Running, Stopping, Stopped, Install Fail, ResizeFail and Rebooting.
ip_set - It is a nested type which documented below.
disk_set - It is a nested type which documented below.

The attribute (disk_set) supports the following:

id - The ID of disk.
size - The size of disk, measured in GB (Gigabyte).
type - The type of disk.
is_boot - Specifies whether boot disk or not.

The attribute (ip_set) supports the following:

internet_type - Type of Elastic IP routes. Possible values are: International as internaltional BGP IP, BGP as china BGP IP and Private as private IP.
ip - Elastic IP address.

» Import

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

$ terraform import ucloud_instance.example uhost-abcdefg