terraform/website/source/docs/providers/alicloud/r/eip_association.html.markdown

layout	page_title	sidebar_current	description
alicloud	Alicloud: alicloud_eip_association	docs-alicloud-resource-eip-association	Provides a ECS EIP Association resource.

alicloud_eip_association

Provides an Alicloud EIP Association resource, to associate and disassociate Elastic IPs from ECS Instances.

~> NOTE: alicloud_eip_association is useful in scenarios where EIPs are either pre-existing or distributed to customers or users and therefore cannot be changed. In addition, it only supports ECS-VPC.

Example Usage

# Create a new EIP association and use it to associate a EIP form a instance.

resource "alicloud_vpc" "vpc" {
  cidr_block = "10.1.0.0/21"
}

resource "alicloud_vswitch" "vsw" {
  vpc_id            = "${alicloud_vpc.vpc.id}"
  cidr_block        = "10.1.1.0/24"
  availability_zone = "cn-beijing-a"

  depends_on = [
    "alicloud_vpc.vpc",
  ]
}

resource "alicloud_instance" "ecs_instance" {
  image_id              = "ubuntu_140405_64_40G_cloudinit_20161115.vhd"
  instance_type         = "ecs.s1.small"
  availability_zone     = "cn-beijing-a"
  security_groups       = ["${alicloud_security_group.group.id}"]
  vswitch_id            = "${alicloud_vswitch.vsw.id}"
  instance_name         = "hello"
  instance_network_type = "vpc"

  tags {
    Name = "TerraformTest-instance"
  }
}

resource "alicloud_eip" "eip" {}

resource "alicloud_eip_association" "eip_asso" {
  allocation_id = "${alicloud_eip.eip.id}"
  instance_id   = "${alicloud_instance.ecs_instance.id}"
}

resource "alicloud_security_group" "group" {
  name        = "terraform-test-group"
  description = "New security group"
  vpc_id      = "${alicloud_vpc.vpc.id}"
}

Argument Reference

The following arguments are supported:

• allocation_id - (Optional, Forces new resource) The allocation EIP ID.
• instance_id - (Optional, Forces new resource) The ID of the instance.

Attributes Reference

The following attributes are exported:

• allocation_id - As above.
• instance_id - As above.