5.6 KiB
5.6 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
alicloud | Alicloud: alicloud_instance | docs-alicloud-resource-instance | Provides a ECS instance resource. |
alicloud_ecs
Provides a ECS instance resource.
Example Usage
# Create a new ECS instance for classic
resource "alicloud_security_group" "classic" {
name = "tf_test_foo"
description = "foo"
}
resource "alicloud_instance" "classic" {
# cn-beijing
availability_zone = "cn-beijing-b"
security_group_id = "${alicloud_security_group.classic.id}"
allocate_public_ip = "true"
# series II
instance_type = "ecs.n1.medium"
io_optimized = "optimized"
system_disk_category = "cloud_efficiency"
image_id = "ubuntu_140405_64_40G_cloudinit_20161115.vhd"
instance_name = "test_foo"
}
# Create a new ECS instance for VPC
resource "alicloud_vpc" "default" {
# Other parameters...
}
resource "alicloud_vswitch" "default" {
# Other parameters...
}
resource "alicloud_slb" "vpc" {
name = "test-slb-tf"
vpc_id = "${alicloud_vpc.default.id}"
vswitch_id = "${alicloud_vswitch.default.id}"
}
Argument Reference
The following arguments are supported:
availability_zone
- (Required) The Zone to start the instance in.image_id
- (Required) The Image to use for the instance.instance_type
- (Required) The type of instance to start.security_group_ids
- (Required) A list of security group ids to associate with. If you are creating Instances in a VPC, usevpc_security_group_ids
instead.security_group_ids
instead.instance_name
- (Optional) The name of the ECS. This instance_name can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. If not specified, Terraform will autogenerate a name beginning withtf-ecs
.allocate_public_ip
- (Optional) Associate a public ip address with an instance in a VPC or Classic. Boolean value, Default is false.io_optimized
- (Optional) Valid values arenone
,optimized
, Ifoptimized
, the launched ECS instance will be I/O optimized. Default isoptimized
.system_disk_category
- (Optional) Valid values arecloud
,cloud_efficiency
,cloud_ssd
, For I/O optimized instance type,cloud_ssd
andcloud_efficiency
disks are supported. For non I/O Optimized instance type,cloud
disk are supported.system_disk_size
- (Optional) Size of the system disk, value range: 40GB ~ 500GB. Default is 40GB.description
- (Optional) Description of the instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.internet_charge_type
- (Optional) Internet charge type of the instance, Valid values arePayByBandwidth
,PayByTraffic
. Default isPayByBandwidth
.internet_max_bandwidth_in
- (Optional) Maximum incoming bandwidth from the public network, measured in Mbps (Mega bit per second). Value range: [1, 200]. If this value is not specified, then automatically sets it to 200 Mbps.internet_max_bandwidth_out
- (Optional) Maximum outgoing bandwidth to the public network, measured in Mbps (Mega bit per second). Value range:internet_charge_type
isPayByBandwidth
: this value range [0, 100], If this value is not specified, then automatically sets it to 0 Mbps; Ifinternet_charge_type
isPayByTraffic
: this value range [1, 100]. this value must be set value, such as 5.host_name
- (Optional) Host name of the ECS, which is a string of at least two characters. “hostname” cannot start or end with “.” or “-“. In addition, two or more consecutive “.” or “-“ symbols are not allowed. On Windows, the host name can contain a maximum of 15 characters, which can be a combination of uppercase/lowercase letters, numerals, and “-“. The host name cannot contain dots (“.”) or contain only numeric characters. On other OSs such as Linux, the host name can contain a maximum of 30 characters, which can be segments separated by dots (“.”), where each segment can contain uppercase/lowercase letters, numerals, or “_“.password
- (Optional) Password to an instance is a string of 8 to 30 characters. It must contain uppercase/lowercase letters and numerals, but cannot contain special symbols.vswitch_id
- (Optional) The virtual switch ID to launch in VPC. If you want to create instances in VPC network, this parameter must be set.instance_charge_type
- (Optional) Valid values arePrePaid
,PostPaid
, The default isPostPaid
.period
- (Optional) The time that you have bought the resource, in month. Only valid when instance_charge_type is set asPrePaid
. Value range [1, 12].private_ip
- (Optional) Private IP address to associate with the instance in a VPC.tags
- (Optional) A mapping of tags to assign to the resource.
Attributes Reference
The following attributes are exported:
id
- The instance ID.availability_zone
- The Zone to start the instance in.instance_name
- The instance name.host_name
- The instance host name.description
- The instance description.status
- The instance status.image_id
- The instance Image Id.instance_type
- The instance type.instance_network_type
- The instance network type and it has two values:vpc
andclassic
.io_optimized
- The instance whether I/O optimized.private_ip
- The instance private ip.public_ip
- The instance public ip.vswitch_id
- If the instance created in VPC, then this value is virtual switch ID.tags
- The instance tags, use jsonencode(item) to display the value.