zenlayercloud

Overview ¶

Use this data source to query instances types.

Example Usage ¶

```hcl data "zenlayercloud_bmc_instance_types" "foo" {

}

data "zenlayercloud_bmc_instance_types" "sel" {
  availability_zone    = "SEL-A"
  instance_charge_type = "PREPAID"
  exclude_sold_out     = true
}

```

Use this data source to query DDoS IP instances.

Example Usage ¶

```hcl

data "zenlayercloud_bmc_ddos_ips" "foo" {
	availability_zone = "SEL-A"
}

```

Use this data source to query eip instances.

Example Usage ¶

```hcl

data "zenlayercloud_bmc_eips" "foo" {
	availability_zone = "SEL-A"
}

```

Use this data source to query images.

Example Usage ¶

```hcl

data "zenlayercloud_bmc_images" "foo" {
	catalog = "centos"
    instance_type_id = "S9I"
}

```

Use this data source to query bmc instances.

Example Usage ¶

```hcl

data "zenlayercloud_bmc_instances" "foo" {
  availability_zone = "SEL-A"
}

```

Use this data source to query vpc subnets information.

Example Usage ¶

```hcl

variable "availability_zone" {
  default = "SEL-A"
}

resource "zenlayercloud_bmc_subnet" "foo" {
  availability_zone = var.availability_zone
  name       		= "subnet_test"
  cidr_block 		= "10.0.0.0/16"
}

data "zenlayercloud_bmc_subnets" "id_subnets" {
  subnet_id = zenlayercloud_bmc_subnet.foo.id
}

data "zenlayercloud_bmc_subnets" "name_subnets" {
  subnet_name = zenlayercloud_bmc_subnet.foo.name
}

Use this data source to get the available regions for vpc.

Example Usage ¶

```hcl

data "zenlayercloud_bmc_vpc_regions" "sel-region" {
  availability_zone = "SEL-A"
}

```

Use this data source to query vpc information.

Example Usage ¶

```hcl data "zenlayercloud_bmc_vpc_regions" "region" { }

resource "zenlayercloud_bmc_vpc" "foo" {
  region     = data.zenlayercloud_bmc_vpc_regions.region.vpc_regions.0.region
  name       = "test_vpc"
  cidr_block = "10.0.0.0/16"
}

data "zenlayercloud_bmc_vpcs" "foo" { } ```

Use this data source to get all bmc available zones.

Example Usage ¶

```hcl data "zenlayercloud_bmc_zones" "all" { }

data "zenlayercloud_bmc_zones" "sel" {
	name_regex = "SEL*"
}

```

Use this data source to query vm disk information.

Example Usage ¶

```hcl data "zenlayercloud_disks" "all" { }

filter system disk ¶

data "zenlayercloud_disks" "system_disk" {
  disk_type = "SYSTEM"
}

#filter with name regex

data "zenlayercloud_disks" "name_disk" {
  name_regex = "disk20*"
}

```

Use this data source to query images.

Example Usage ¶

```hcl

data "zenlayercloud_images" "foo" {
	availability_zone = "FRA-A"
    category = "CentOS"
	image_type = ["PUBLIC_IMAGE"]
}

```

Use this data source to query instances type.

Example Usage ¶

```hcl data "zenlayercloud_instance_types" "foo" {

}

data "zenlayercloud_instance_types" "sel1c1g" {
  availability_zone = "SEL-A"
  cpu_count   		= 1
  memory	        = 1
}

```

Use this data source to query detailed information of security groups.

Example Usage ¶

```hcl data "zenlayercloud_security_groups" "sg1" { }

data "zenlayercloud_security_groups" "sg2" {
  name = "example_name"
}

```

Use this data source to query subnets information.

Example Usage ¶

```hcl

variable "availability_zone" {
  default = "SEL-A"
}

resource "zenlayercloud_subnet" "foo" {
  availability_zone = var.availability_zone
  name       		= "subnet_test"
  cidr_block 		= "10.0.0.0/24"
}

filter by subnet id ¶

data "zenlayercloud_subnets" "id_subnets" {
  subnet_id = zenlayercloud_subnet.foo.id
}

filter by subnet name ¶

data "zenlayercloud_subnets" "name_subnets" {
  subnet_name = zenlayercloud_subnet.foo.name
}

```

Use this data source to get all vm available zones.

Example Usage ¶

```hcl data "zenlayercloud_zones" "all" { }

data "zenlayercloud_zones" "sel" {
	name_regex = "SEL*"
}

```

The ZenlayerCloud provider is used to interact with many resources supported by [ZenlayerCloud](https://console.zenlayer.com). The provider needs to be configured with the proper credentials before it can be used.

Use the navigation on the left to read about the available resources.

Example Usage ¶

```hcl

terraform {
  required_providers {
    zenlayercloud = {
      source = "zenlayer/zenlayercloud"
    }
  }
}

Configure the Zenlayer Cloud Provider ¶

provider "zenlayercloud" {
  access_key_id       =  var.access_key_id
  access_key_password =  var.access_key_password
}

```

Resources List ¶

Provider Data Sources ¶

Zenlayer Virtual Machine(VM)

  Data Source
	zenlayercloud_zones
	zenlayercloud_images
	zenlayercloud_instance_types
	zenlayercloud_security_groups
	zenlayercloud_instance_types
	zenlayercloud_disks
	zenlayercloud_subnets

  Resource
	zenlayercloud_image
	zenlayercloud_security_group
	zenlayercloud_security_group_attachment
	zenlayercloud_security_group_rule
	zenlayercloud_instance
	zenlayercloud_disk
	zenlayercloud_disk_attachment
	zenlayercloud_subnet

Bare Metal Cloud(BMC)

  Data Source
	zenlayercloud_bmc_zones
	zenlayercloud_bmc_instance_types
    zenlayercloud_bmc_images
	zenlayercloud_bmc_instances
	zenlayercloud_bmc_eips
	zenlayercloud_bmc_ddos_ips
	zenlayercloud_bmc_vpc_regions
	zenlayercloud_bmc_vpcs
	zenlayercloud_bmc_subnets

  Resource
	zenlayercloud_bmc_instance
	zenlayercloud_bmc_ddos_ip
	zenlayercloud_bmc_ddos_ip_association
	zenlayercloud_bmc_eip
	zenlayercloud_bmc_eip_association
	zenlayercloud_bmc_vpc
	zenlayercloud_bmc_subnet

Provides an DDoS IP resource.

Example Usage ¶

```hcl

variable "availability_zone" {
  default = "SEL-A"
}

resource "zenlayercloud_bmc_ddos_ip" "foo" {
  availability_zone = var.availability_zone
}

```

Import ¶

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

``` $ terraform import zenlayercloud_bmc_ddos_ip.foo 123123xxxx ```

Provides an DDoS IP resource associated with BMC instance.

Example Usage ¶

```hcl

resource "zenlayercloud_bmc_ddos_ip_association" "foo" {
  ddos_ip_id      = "ddosIpIdxxxxxx"
  instance_id = "instanceIdxxxxxx"
}

```

Import ¶

DDoS IP association can be imported using the id, e.g.

``` $ terraform import zenlayercloud_bmc_ddos_ip_association.bar ddosIpIdxxxxxx:instanceIdxxxxxxx ```

Provides an EIP resource.

Example Usage ¶

```hcl

variable "availability_zone" {
  default = "SEL-A"
}

resource "zenlayercloud_bmc_eip" "foo" {
  availability_zone = var.availability_zone
}

```

Import ¶

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

``` $ terraform import zenlayercloud_bmc_eip.foo 123123xxxx ```

Provides an eip resource associated with BMC instance.

Example Usage ¶

```hcl

resource "zenlayercloud_bmc_eip_association" "foo" {
  eip_id      = "eipxxxxxx"
  instance_id = "instanceIdxxxxxx"
}

```

Import ¶

Eip association can be imported using the id, e.g.

``` $ terraform import zenlayercloud_bmc_eip_association.bar eipIdxxxxxx:instanceIdxxxxxxx ```

Provides a BMC instance resource.

~> **NOTE:** You can launch an BMC instance for a private network via specifying parameter `subnet_id`.

~> **NOTE:** At present, 'PREPAID' instance cannot be deleted and must wait it to be outdated and released automatically.

Example Usage ¶

```hcl

data "zenlayercloud_bmc_zones" "default" {

}

data "zenlayercloud_bmc_instance_types" "default" {
  availability_zone = data.zenlayercloud_bmc_zones.default.zones.0.id
}

Get a centos image which also supported to install on given instance type ¶

data "zenlayercloud_bmc_images" "default" {
  catalog          = "centos"
  instance_type_id = data.zenlayercloud_bmc_instance_types.default.instance_types.0.id
}

resource "zenlayercloud_bmc_subnet" "default" {
  availability_zone = data.zenlayercloud_bmc_zones.default.zones.0.id
  name              = "test-subnet"
  cidr_block        = "10.0.10.0/24"
}

Create a web server ¶

resource "zenlayercloud_bmc_instance" "web" {
  availability_zone    = data.zenlayercloud_bmc_zones.default.zones.0.id
  image_id             = data.zenlayercloud_bmc_images.default.images.0.image_id
  internet_charge_type = "ByBandwidth"
  instance_type_id     = data.zenlayercloud_bmc_instance_types.default.instance_types.0.id
  password             = "Example~123"
  instance_name        = "web"
  subnet_id            =  zenlayercloud_bmc_subnet.default.id
}

```

Import ¶

BMC instance can be imported using the id, e.g.

``` terraform import zenlayercloud_bmc_instance.foo 123123xxx ```

Provide a resource to create a VPC subnet.

Example Usage ¶

```hcl

variable "region" {
  default = "SEL1"
}

variable "availability_zone" {
  default = "SEL-A"
}

resource "zenlayercloud_bmc_vpc" "foo" {
  region	 = var.region
  name       = "test-vpc"
  cidr_block = "10.0.0.0/16"
}

resource "zenlayercloud_bmc_subnet" "subnet_with_vpc" {
  availability_zone = var.availability_zone
  name              = "test-subnet"
  vpc_id            = zenlayercloud_bmc_vpc.foo.id
  cidr_block        = "10.0.10.0/24"
}

resource "zenlayercloud_bmc_subnet" "subnet" {
  availability_zone = var.availability_zone
  name              = "test-subnet"
  cidr_block        = "10.0.10.0/24"
}

```

Import ¶

Vpc subnet instance can be imported, e.g.

``` $ terraform import zenlayercloud_bmc_subnet.subnet subnet_id ```

Provide a resource to create a VPC.

Example Usage ¶

```hcl data "zenlayercloud_bmc_vpc_regions" "default_region" {

}

resource "zenlayercloud_bmc_vpc" "foo" {
  region 	 = data.zenlayercloud_bmc_vpc_regions.default_region.regions.0.id
  cidr_block = "10.0.0.0/26"
}

```

Import ¶

Vpc instance can be imported, e.g.

``` $ terraform import zenlayercloud_bmc_vpc.test vpc-id ```

Provide a resource to create data disk.

Example Usage ¶

```hcl

resource "zenlayercloud_disk" "foo" {
  availability_zone 	 = "SEL-A"
  name  				 = "SEL-20G"
  disk_size				 = 20
}

```

Import ¶

Disk instance can be imported, e.g.

``` $ terraform import zenlayercloud_disk.test disk-id ```

Provide a resource to create data disk.

Example Usage ¶

```hcl

resource "zenlayercloud_disk_attachment" "foo" {
  disk_id 	 	= "diskxxxx"
  instance_id  	= "instancexxxx"
}

```

Import ¶

Disk attachment can be imported, e.g.

``` $ terraform import zenlayercloud_disk_attachment.foo disk-id:instance-id ```

Provides a resource to manage image.

~> **NOTE:** You have to keep the instance power off if the image is created from instance.

Example Usage ¶

```hcl

resource "zenlayercloud_image" "foo" {
  image_name       	= "web-image-centos"
  instance_id    	= "xxxxxx"
  image_description	= "create a image by the web server"
}

```

Import ¶

Image can be imported, e.g.

``` $ terraform import zenlayercloud_image.foo img-xxxxxxx ```

Provides a instance resource.

~> **NOTE:** You can launch an instance for a private network via specifying parameter `subnet_id`.

~> **NOTE:** At present, 'PREPAID' instance cannot be deleted and must wait it to be outdated and released automatically.

Example Usage ¶

```hcl

data "zenlayercloud_zones" "default" {

}

data "zenlayercloud_instance_types" "default" {
  availability_zone = data.zenlayercloud_zones.default.zones.0.id
}

Get a centos image which also supported to install on given instance type ¶

data "zenlayercloud_images" "default" {
  availability_zone = data.zenlayercloud_zones.default.zones.0.id
  category          = "CentOS"
}

resource "zenlayercloud_subnet" "default" {
  name              = "test-subnet"
  cidr_block        = "10.0.10.0/24"
}

Create a web server ¶

resource "zenlayercloud_instance" "web" {
  availability_zone    = data.zenlayercloud_zones.default.zones.0.id
  image_id             = data.zenlayercloud_images.default.images.0.image_id
  internet_charge_type = "ByBandwidth"
  instance_type        = data.zenlayercloud_instance_types.default.instance_types.0.id
  password             = "Example~123"
  instance_name        = "web"
  subnet_id            = zenlayercloud_subnet.default.id
  system_disk_size     = 100
}

```

Import ¶

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

``` terraform import zenlayercloud_instance.foo 123123xxx ```

Provides a resource to create security group.

Example Usage ¶

```hcl

resource "zenlayercloud_security_group" "foo" {
  name       	= "example-name"
  description	= "example purpose"
}

```

Import ¶

Security group can be imported, e.g.

``` $ terraform import zenlayercloud_security_group.security_group security_group_id ```

Provides a resource to create a security group attachment ¶

Example Usage ¶

```hcl

resource "zenlayercloud_security_group_attachment" "foo" {
  security_group_id = "12364246"
  instance_id       = "62343412426423623"
}

```

Import ¶

Security group attachment can be imported using the id, e.g.

``` terraform import zenlayercloud_security_group_attachment.security_group_attachment securityGroupId:instanceId ```

Provides a resource to create security group rule.

~> **NOTE:** Single security rule is hardly ordered, use zenlayercloud_security_group_rule_set instead.

Example Usage ¶

```hcl

resource "zenlayercloud_security_group" "foo" {
  name        = "example-name"
  description = "example purpose"
}

resource "zenlayercloud_security_group_rule" "bar" {
  security_group_id = zenlayercloud_security_group.foo.id
  direction         = "ingress"
  policy            = "accept"
  cidr_ip    		= "10.0.0.0/16"
  ip_protocol       = "tcp"
  port_range        = "80"
  priority          = 50
}

```

Provide a resource to create a subnet.

Example Usage ¶

```hcl

variable "availability_zone" {
  default = "SEL-A"
}

resource "zenlayercloud_subnet" "foo" {
  availability_zone	 = var.availability_zone
  name       = "test-subnet"
  cidr_block = "10.0.0.0/24"
}

```

Import ¶

Subnet instance can be imported, e.g.

``` $ terraform import zenlayercloud_subnet.subnet subnet_id ```