pulumi-alicloud-kotlin/com.pulumi.alicloud.ecs.kotlin/EipAddress

EipAddress

Provides a EIP Address resource. For information about EIP Address and how to use it, see What is EIP Address.

NOTE: Available in v1.126.0+. NOTE: BGP (Multi-ISP) lines are supported in all regions. BGP (Multi-ISP) Pro lines are supported only in the China (Hong Kong) region. NOTE: The resource only supports to create PayAsYouGo PayByTraffic or Subscription PayByBandwidth elastic IP for international account. Otherwise, you will happened error COMMODITY.INVALID_COMPONENT. Your account is international if you can use it to login in International Web Console.

Example Usage

Basic Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.ecs.EipAddress;
import com.pulumi.alicloud.ecs.EipAddressArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var example = new EipAddress("example", EipAddressArgs.builder()
            .addressName("tf-testAcc1234")
            .internetChargeType("PayByBandwidth")
            .isp("BGP")
            .paymentType("PayAsYouGo")
            .build());
    }
}

Import

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

$ pulumi import alicloud:ecs/eipAddress:EipAddress example <id>

Properties

activityId

val activityId: Output<String>?

The activity id.

addressName

val addressName: Output<String>

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://.

autoPay

val autoPay: Output<Boolean>?

Whether to pay automatically. Valid values: true and false. Default value: true. When auto_pay is true, The order will be automatically paid. When auto_pay is false, The order needs to go to the order center to complete the payment. NOTE: When payment_type is Subscription, this parameter is valid.

bandwidth

val bandwidth: Output<String>

The maximum bandwidth of the EIP. Valid values: 1 to 200. Unit: Mbit/s. Default value: 5.

deletionProtection

val deletionProtection: Output<Boolean>

Whether enable the deletion protection or not. Default value: false.

description

val description: Output<String>?

The description of the EIP.

val id: Output<String>

instanceChargeType

val ~~instanceChargeType~~: Output<String>

Field instance_charge_type has been deprecated from provider version 1.126.0, and it will be removed in the future version. Please use the new attribute payment_type instead.

internetChargeType

val internetChargeType: Output<String>

The metering method of the EIP. Valid values: PayByDominantTraffic, PayByBandwidth and PayByTraffic. Default to PayByBandwidth. NOTE: It must be set to "PayByBandwidth" when payment_type is "Subscription".

ipAddress

val ipAddress: Output<String>

The address of the EIP.

isp

val isp: Output<String>

The line type. You can set this parameter only when you create a PayAsYouGo EIP. Valid values: BGP: BGP (Multi-ISP) lines.Up to 89 high-quality BGP lines are available worldwide. Direct connections with multiple Internet Service Providers (ISPs), including Telecom, Unicom, Mobile, Railcom, Netcom, CERNET, China Broadcast Network, Dr. Peng, and Founder, can be established in all regions in mainland China. BGP_PRO: BGP (Multi-ISP) Pro lines optimize data transmission to mainland China and improve connection quality for international services. Compared with BGP (Multi-ISP), when BGP (Multi-ISP) Pro provides services to clients in mainland China (excluding data centers), cross-border connections are established without using international ISP services. This reduces network latency.

name

val ~~name~~: Output<String>

Field name has been deprecated from provider version 1.126.0, and it will be removed in the future version. Please use the new attribute address_name instead.

netmode

val netmode: Output<String>?

The type of the network. Valid value is public (Internet).

paymentType

val paymentType: Output<String>

The billing method of the EIP. Valid values: Subscription and PayAsYouGo. Default value is PayAsYouGo.

period

val period: Output<Int>?

The duration that you will buy the resource, in month. It is valid when payment_type is Subscription. Valid values: 1-9, 12, 24, 36. At present, the provider does not support modify "period" and you can do that via web console.

publicIpAddressPoolId

val publicIpAddressPoolId: Output<String>?

The ID of the IP address pool. The EIP is allocated from the IP address pool. NOTE: The feature is available only to users whose accounts are included in the whitelist. If you want to use the feature,submit a ticket.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

resourceGroupId

val resourceGroupId: Output<String>

The ID of the resource group.

securityProtectionTypes

val securityProtectionTypes: Output<List<String>>?

The edition of Anti-DDoS. If you do not set this parameter, Anti-DDoS Origin Basic is used. If you set the value to AntiDDoS_Enhanced, Anti-DDoS Pro(Premium) is used.

status

val status: Output<String>

The status of the EIP. Valid values: Associating: The EIP is being associated. Unassociating: The EIP is being disassociated. InUse: The EIP is allocated. Available:The EIP is available.