Provides an elastic IP resource.
# Create a new EIP.
resource "alicloud_eip" "example" {
bandwidth = "10"
internet_charge_type = "PayByBandwidth"
}
You can use the existing eip module to create several EIP instances and associate them with other resources one-click, like ECS instances, SLB, Nat Gateway and so on.
The following arguments are supported:
name
- (Deprecated) It has been deprecated from version 1.126.0 and using new attribute address_name
instead.address_name
- (Optional) The name of the EIP instance. This 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://.description
- (Optional) Description of the EIP instance, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Default value is null.bandwidth
- (Optional) Maximum bandwidth to the elastic public network, measured in Mbps (Mega bit per second). If this value is not specified, then automatically sets it to 5 Mbps.internet_charge_type
- (Optional, ForceNew) Internet charge type of the EIP, Valid values are PayByBandwidth
, PayByTraffic
. Default to PayByBandwidth
. NOTE: From version 1.7.1
to 1.125.0
, it defaults to PayByTraffic
. It is only "PayByBandwidth" when instance_charge_type
is PrePaid.instance_charge_type
- (Depreacted, Optional, ForceNew) (It has been deprecated from version 1.126.0 and using new attribute payment_type
instead) Elastic IP instance charge type. Valid values are "PrePaid" and "PostPaid". Default to "PostPaid".payment_type
- (Optional, ForceNew) The billing method of the EIP. Valid values: Subscription
and PayAsYouGo
. Default value is PayAsYouGo
.period
- (Optional) The duration that you will buy the resource, in month. It is valid when instance_charge_type
is PrePaid
. Valid values: [1-9, 12, 24, 36]. At present, the provider does not support modify "period" and you can do that via web console.
NOTE: The attribute period
is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running terraform apply
will not effect the resource.isp
- (Optional, ForceNew, Available in 1.47.0+) The line type of the Elastic IP instance. Default to BGP
. Other type of the isp need to open a whitelist.tags
- (Optional, Available in v1.55.3+) A mapping of tags to assign to the resource.resource_group_id
- (Optional, Available in 1.58.0+, Modifiable in 1.115.0+) The Id of resource group which the eip belongs.deletion_protection
- (Optional, Available in v1.124.4+) Whether enable the deletion protection or not. Default value: false
.
The following attributes are exported:
id
- The EIP ID.status
- The EIP current status.ip_address
- The elastic ip addressElastic IP address can be imported using the id, e.g.
$ terraform import alicloud_eip_address.example eip-abc12345678