76 lines
2.0 KiB
Markdown
76 lines
2.0 KiB
Markdown
---
|
|
layout: "alicloud"
|
|
page_title: "Alicloud: alicloud_eip_association"
|
|
sidebar_current: "docs-alicloud-resource-eip-association"
|
|
description: |-
|
|
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. |