Docs Packages
  1. Packages
  2. Alibaba Cloud
  3. API Docs
  4. ecs
  5. EipAssociation
Alibaba Cloud v3.53.0 published on Wednesday, Apr 17, 2024 by Pulumi
pulumi/pulumi-alicloud

alicloud.ecs.EipAssociation

Explore with Pulumi AI

alicloud logo
Alibaba Cloud v3.53.0 published on Wednesday, Apr 17, 2024 by Pulumi
pulumi/pulumi-alicloud

    Provides an Alicloud EIP Association resource for associating Elastic IP to ECS Instance, SLB Instance or Nat Gateway.

    NOTE: alicloud.ecs.EipAssociation is useful in scenarios where EIPs are either pre-existing or distributed to customers or users and therefore cannot be changed.

    NOTE: From version 1.7.1, the resource support to associate EIP to SLB Instance or Nat Gateway.

    NOTE: One EIP can only be associated with ECS or SLB instance which in the VPC.

    NOTE: Available since v1.117.0.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";

const config = new pulumi.Config();
const name = config.get("name") || "tf-example";
const exampleZones = alicloud.getZones({
    availableResourceCreation: "Instance",
});
const exampleInstanceTypes = exampleZones.then(exampleZones => alicloud.ecs.getInstanceTypes({
    availabilityZone: exampleZones.zones?.[0]?.id,
    cpuCoreCount: 1,
    memorySize: 2,
}));
const exampleImages = alicloud.ecs.getImages({
    nameRegex: "^ubuntu_[0-9]+_[0-9]+_x64*",
    owners: "system",
});
const exampleNetwork = new alicloud.vpc.Network("exampleNetwork", {
    vpcName: name,
    cidrBlock: "10.4.0.0/16",
});
const exampleSwitch = new alicloud.vpc.Switch("exampleSwitch", {
    vswitchName: name,
    cidrBlock: "10.4.0.0/24",
    vpcId: exampleNetwork.id,
    zoneId: exampleZones.then(exampleZones => exampleZones.zones?.[0]?.id),
});
const exampleSecurityGroup = new alicloud.ecs.SecurityGroup("exampleSecurityGroup", {vpcId: exampleNetwork.id});
const exampleInstance = new alicloud.ecs.Instance("exampleInstance", {
    availabilityZone: exampleZones.then(exampleZones => exampleZones.zones?.[0]?.id),
    instanceName: name,
    imageId: exampleImages.then(exampleImages => exampleImages.images?.[0]?.id),
    instanceType: exampleInstanceTypes.then(exampleInstanceTypes => exampleInstanceTypes.instanceTypes?.[0]?.id),
    securityGroups: [exampleSecurityGroup.id],
    vswitchId: exampleSwitch.id,
    tags: {
        Created: "TF",
        For: "example",
    },
});
const exampleEipAddress = new alicloud.ecs.EipAddress("exampleEipAddress", {addressName: name});
const exampleEipAssociation = new alicloud.ecs.EipAssociation("exampleEipAssociation", {
    allocationId: exampleEipAddress.id,
    instanceId: exampleInstance.id,
});

    import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "tf-example"
example_zones = alicloud.get_zones(available_resource_creation="Instance")
example_instance_types = alicloud.ecs.get_instance_types(availability_zone=example_zones.zones[0].id,
    cpu_core_count=1,
    memory_size=2)
example_images = alicloud.ecs.get_images(name_regex="^ubuntu_[0-9]+_[0-9]+_x64*",
    owners="system")
example_network = alicloud.vpc.Network("exampleNetwork",
    vpc_name=name,
    cidr_block="10.4.0.0/16")
example_switch = alicloud.vpc.Switch("exampleSwitch",
    vswitch_name=name,
    cidr_block="10.4.0.0/24",
    vpc_id=example_network.id,
    zone_id=example_zones.zones[0].id)
example_security_group = alicloud.ecs.SecurityGroup("exampleSecurityGroup", vpc_id=example_network.id)
example_instance = alicloud.ecs.Instance("exampleInstance",
    availability_zone=example_zones.zones[0].id,
    instance_name=name,
    image_id=example_images.images[0].id,
    instance_type=example_instance_types.instance_types[0].id,
    security_groups=[example_security_group.id],
    vswitch_id=example_switch.id,
    tags={
        "Created": "TF",
        "For": "example",
    })
example_eip_address = alicloud.ecs.EipAddress("exampleEipAddress", address_name=name)
example_eip_association = alicloud.ecs.EipAssociation("exampleEipAssociation",
    allocation_id=example_eip_address.id,
    instance_id=example_instance.id)

    package main

import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/ecs"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		cfg := config.New(ctx, "")
		name := "tf-example"
		if param := cfg.Get("name"); param != "" {
			name = param
		}
		exampleZones, err := alicloud.GetZones(ctx, &alicloud.GetZonesArgs{
			AvailableResourceCreation: pulumi.StringRef("Instance"),
		}, nil)
		if err != nil {
			return err
		}
		exampleInstanceTypes, err := ecs.GetInstanceTypes(ctx, &ecs.GetInstanceTypesArgs{
			AvailabilityZone: pulumi.StringRef(exampleZones.Zones[0].Id),
			CpuCoreCount:     pulumi.IntRef(1),
			MemorySize:       pulumi.Float64Ref(2),
		}, nil)
		if err != nil {
			return err
		}
		exampleImages, err := ecs.GetImages(ctx, &ecs.GetImagesArgs{
			NameRegex: pulumi.StringRef("^ubuntu_[0-9]+_[0-9]+_x64*"),
			Owners:    pulumi.StringRef("system"),
		}, nil)
		if err != nil {
			return err
		}
		exampleNetwork, err := vpc.NewNetwork(ctx, "exampleNetwork", &vpc.NetworkArgs{
			VpcName:   pulumi.String(name),
			CidrBlock: pulumi.String("10.4.0.0/16"),
		})
		if err != nil {
			return err
		}
		exampleSwitch, err := vpc.NewSwitch(ctx, "exampleSwitch", &vpc.SwitchArgs{
			VswitchName: pulumi.String(name),
			CidrBlock:   pulumi.String("10.4.0.0/24"),
			VpcId:       exampleNetwork.ID(),
			ZoneId:      pulumi.String(exampleZones.Zones[0].Id),
		})
		if err != nil {
			return err
		}
		exampleSecurityGroup, err := ecs.NewSecurityGroup(ctx, "exampleSecurityGroup", &ecs.SecurityGroupArgs{
			VpcId: exampleNetwork.ID(),
		})
		if err != nil {
			return err
		}
		exampleInstance, err := ecs.NewInstance(ctx, "exampleInstance", &ecs.InstanceArgs{
			AvailabilityZone: pulumi.String(exampleZones.Zones[0].Id),
			InstanceName:     pulumi.String(name),
			ImageId:          pulumi.String(exampleImages.Images[0].Id),
			InstanceType:     pulumi.String(exampleInstanceTypes.InstanceTypes[0].Id),
			SecurityGroups: pulumi.StringArray{
				exampleSecurityGroup.ID(),
			},
			VswitchId: exampleSwitch.ID(),
			Tags: pulumi.StringMap{
				"Created": pulumi.String("TF"),
				"For":     pulumi.String("example"),
			},
		})
		if err != nil {
			return err
		}
		exampleEipAddress, err := ecs.NewEipAddress(ctx, "exampleEipAddress", &ecs.EipAddressArgs{
			AddressName: pulumi.String(name),
		})
		if err != nil {
			return err
		}
		_, err = ecs.NewEipAssociation(ctx, "exampleEipAssociation", &ecs.EipAssociationArgs{
			AllocationId: exampleEipAddress.ID(),
			InstanceId:   exampleInstance.ID(),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;

return await Deployment.RunAsync(() => 
{
    var config = new Config();
    var name = config.Get("name") ?? "tf-example";
    var exampleZones = AliCloud.GetZones.Invoke(new()
    {
        AvailableResourceCreation = "Instance",
    });

    var exampleInstanceTypes = AliCloud.Ecs.GetInstanceTypes.Invoke(new()
    {
        AvailabilityZone = exampleZones.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
        CpuCoreCount = 1,
        MemorySize = 2,
    });

    var exampleImages = AliCloud.Ecs.GetImages.Invoke(new()
    {
        NameRegex = "^ubuntu_[0-9]+_[0-9]+_x64*",
        Owners = "system",
    });

    var exampleNetwork = new AliCloud.Vpc.Network("exampleNetwork", new()
    {
        VpcName = name,
        CidrBlock = "10.4.0.0/16",
    });

    var exampleSwitch = new AliCloud.Vpc.Switch("exampleSwitch", new()
    {
        VswitchName = name,
        CidrBlock = "10.4.0.0/24",
        VpcId = exampleNetwork.Id,
        ZoneId = exampleZones.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
    });

    var exampleSecurityGroup = new AliCloud.Ecs.SecurityGroup("exampleSecurityGroup", new()
    {
        VpcId = exampleNetwork.Id,
    });

    var exampleInstance = new AliCloud.Ecs.Instance("exampleInstance", new()
    {
        AvailabilityZone = exampleZones.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
        InstanceName = name,
        ImageId = exampleImages.Apply(getImagesResult => getImagesResult.Images[0]?.Id),
        InstanceType = exampleInstanceTypes.Apply(getInstanceTypesResult => getInstanceTypesResult.InstanceTypes[0]?.Id),
        SecurityGroups = new[]
        {
            exampleSecurityGroup.Id,
        },
        VswitchId = exampleSwitch.Id,
        Tags = 
        {
            { "Created", "TF" },
            { "For", "example" },
        },
    });

    var exampleEipAddress = new AliCloud.Ecs.EipAddress("exampleEipAddress", new()
    {
        AddressName = name,
    });

    var exampleEipAssociation = new AliCloud.Ecs.EipAssociation("exampleEipAssociation", new()
    {
        AllocationId = exampleEipAddress.Id,
        InstanceId = exampleInstance.Id,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.AlicloudFunctions;
import com.pulumi.alicloud.inputs.GetZonesArgs;
import com.pulumi.alicloud.ecs.EcsFunctions;
import com.pulumi.alicloud.ecs.inputs.GetInstanceTypesArgs;
import com.pulumi.alicloud.ecs.inputs.GetImagesArgs;
import com.pulumi.alicloud.vpc.Network;
import com.pulumi.alicloud.vpc.NetworkArgs;
import com.pulumi.alicloud.vpc.Switch;
import com.pulumi.alicloud.vpc.SwitchArgs;
import com.pulumi.alicloud.ecs.SecurityGroup;
import com.pulumi.alicloud.ecs.SecurityGroupArgs;
import com.pulumi.alicloud.ecs.Instance;
import com.pulumi.alicloud.ecs.InstanceArgs;
import com.pulumi.alicloud.ecs.EipAddress;
import com.pulumi.alicloud.ecs.EipAddressArgs;
import com.pulumi.alicloud.ecs.EipAssociation;
import com.pulumi.alicloud.ecs.EipAssociationArgs;
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) {
        final var config = ctx.config();
        final var name = config.get("name").orElse("tf-example");
        final var exampleZones = AlicloudFunctions.getZones(GetZonesArgs.builder()
            .availableResourceCreation("Instance")
            .build());

        final var exampleInstanceTypes = EcsFunctions.getInstanceTypes(GetInstanceTypesArgs.builder()
            .availabilityZone(exampleZones.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
            .cpuCoreCount(1)
            .memorySize(2)
            .build());

        final var exampleImages = EcsFunctions.getImages(GetImagesArgs.builder()
            .nameRegex("^ubuntu_[0-9]+_[0-9]+_x64*")
            .owners("system")
            .build());

        var exampleNetwork = new Network("exampleNetwork", NetworkArgs.builder()        
            .vpcName(name)
            .cidrBlock("10.4.0.0/16")
            .build());

        var exampleSwitch = new Switch("exampleSwitch", SwitchArgs.builder()        
            .vswitchName(name)
            .cidrBlock("10.4.0.0/24")
            .vpcId(exampleNetwork.id())
            .zoneId(exampleZones.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
            .build());

        var exampleSecurityGroup = new SecurityGroup("exampleSecurityGroup", SecurityGroupArgs.builder()        
            .vpcId(exampleNetwork.id())
            .build());

        var exampleInstance = new Instance("exampleInstance", InstanceArgs.builder()        
            .availabilityZone(exampleZones.applyValue(getZonesResult -> getZonesResult.zones()[0].id()))
            .instanceName(name)
            .imageId(exampleImages.applyValue(getImagesResult -> getImagesResult.images()[0].id()))
            .instanceType(exampleInstanceTypes.applyValue(getInstanceTypesResult -> getInstanceTypesResult.instanceTypes()[0].id()))
            .securityGroups(exampleSecurityGroup.id())
            .vswitchId(exampleSwitch.id())
            .tags(Map.ofEntries(
                Map.entry("Created", "TF"),
                Map.entry("For", "example")
            ))
            .build());

        var exampleEipAddress = new EipAddress("exampleEipAddress", EipAddressArgs.builder()        
            .addressName(name)
            .build());

        var exampleEipAssociation = new EipAssociation("exampleEipAssociation", EipAssociationArgs.builder()        
            .allocationId(exampleEipAddress.id())
            .instanceId(exampleInstance.id())
            .build());

    }
}

    configuration:
  name:
    type: string
    default: tf-example
resources:
  exampleNetwork:
    type: alicloud:vpc:Network
    properties:
      vpcName: ${name}
      cidrBlock: 10.4.0.0/16
  exampleSwitch:
    type: alicloud:vpc:Switch
    properties:
      vswitchName: ${name}
      cidrBlock: 10.4.0.0/24
      vpcId: ${exampleNetwork.id}
      zoneId: ${exampleZones.zones[0].id}
  exampleSecurityGroup:
    type: alicloud:ecs:SecurityGroup
    properties:
      vpcId: ${exampleNetwork.id}
  exampleInstance:
    type: alicloud:ecs:Instance
    properties:
      availabilityZone: ${exampleZones.zones[0].id}
      instanceName: ${name}
      imageId: ${exampleImages.images[0].id}
      instanceType: ${exampleInstanceTypes.instanceTypes[0].id}
      securityGroups:
        - ${exampleSecurityGroup.id}
      vswitchId: ${exampleSwitch.id}
      tags:
        Created: TF
        For: example
  exampleEipAddress:
    type: alicloud:ecs:EipAddress
    properties:
      addressName: ${name}
  exampleEipAssociation:
    type: alicloud:ecs:EipAssociation
    properties:
      allocationId: ${exampleEipAddress.id}
      instanceId: ${exampleInstance.id}
variables:
  exampleZones:
    fn::invoke:
      Function: alicloud:getZones
      Arguments:
        availableResourceCreation: Instance
  exampleInstanceTypes:
    fn::invoke:
      Function: alicloud:ecs:getInstanceTypes
      Arguments:
        availabilityZone: ${exampleZones.zones[0].id}
        cpuCoreCount: 1
        memorySize: 2
  exampleImages:
    fn::invoke:
      Function: alicloud:ecs:getImages
      Arguments:
        nameRegex: ^ubuntu_[0-9]+_[0-9]+_x64*
        owners: system

    Module Support

    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.

    Create EipAssociation Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new EipAssociation(name: string, args: EipAssociationArgs, opts?: CustomResourceOptions);
    @overload
def EipAssociation(resource_name: str,
                   args: EipAssociationArgs,
                   opts: Optional[ResourceOptions] = None)

@overload
def EipAssociation(resource_name: str,
                   opts: Optional[ResourceOptions] = None,
                   allocation_id: Optional[str] = None,
                   instance_id: Optional[str] = None,
                   force: Optional[bool] = None,
                   instance_type: Optional[str] = None,
                   mode: Optional[str] = None,
                   private_ip_address: Optional[str] = None,
                   vpc_id: Optional[str] = None)
    func NewEipAssociation(ctx *Context, name string, args EipAssociationArgs, opts ...ResourceOption) (*EipAssociation, error)
    public EipAssociation(string name, EipAssociationArgs args, CustomResourceOptions? opts = null)
    public EipAssociation(String name, EipAssociationArgs args)
public EipAssociation(String name, EipAssociationArgs args, CustomResourceOptions options)

    type: alicloud:ecs:EipAssociation
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args EipAssociationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args EipAssociationArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args EipAssociationArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args EipAssociationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args EipAssociationArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Example

    The following reference example uses placeholder values for all input properties.

    var eipAssociationResource = new AliCloud.Ecs.EipAssociation("eipAssociationResource", new()
{
    AllocationId = "string",
    InstanceId = "string",
    Force = false,
    InstanceType = "string",
    Mode = "string",
    PrivateIpAddress = "string",
    VpcId = "string",
});

    example, err := ecs.NewEipAssociation(ctx, "eipAssociationResource", &ecs.EipAssociationArgs{
	AllocationId:     pulumi.String("string"),
	InstanceId:       pulumi.String("string"),
	Force:            pulumi.Bool(false),
	InstanceType:     pulumi.String("string"),
	Mode:             pulumi.String("string"),
	PrivateIpAddress: pulumi.String("string"),
	VpcId:            pulumi.String("string"),
})

    var eipAssociationResource = new EipAssociation("eipAssociationResource", EipAssociationArgs.builder()        
    .allocationId("string")
    .instanceId("string")
    .force(false)
    .instanceType("string")
    .mode("string")
    .privateIpAddress("string")
    .vpcId("string")
    .build());

    eip_association_resource = alicloud.ecs.EipAssociation("eipAssociationResource",
    allocation_id="string",
    instance_id="string",
    force=False,
    instance_type="string",
    mode="string",
    private_ip_address="string",
    vpc_id="string")

    const eipAssociationResource = new alicloud.ecs.EipAssociation("eipAssociationResource", {
    allocationId: "string",
    instanceId: "string",
    force: false,
    instanceType: "string",
    mode: "string",
    privateIpAddress: "string",
    vpcId: "string",
});

    type: alicloud:ecs:EipAssociation
properties:
    allocationId: string
    force: false
    instanceId: string
    instanceType: string
    mode: string
    privateIpAddress: string
    vpcId: string

    EipAssociation Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The EipAssociation resource accepts the following input properties:

    AllocationId string
    The ID of the EIP that you want to associate with an instance.
    InstanceId string
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    Force bool
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    InstanceType string
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    Mode string
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    PrivateIpAddress string
    The IP address in the CIDR block of the vSwitch.
    VpcId string
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.
    AllocationId string
    The ID of the EIP that you want to associate with an instance.
    InstanceId string
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    Force bool
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    InstanceType string
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    Mode string
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    PrivateIpAddress string
    The IP address in the CIDR block of the vSwitch.
    VpcId string
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.
    allocationId String
    The ID of the EIP that you want to associate with an instance.
    instanceId String
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    force Boolean
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    instanceType String
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    mode String
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    privateIpAddress String
    The IP address in the CIDR block of the vSwitch.
    vpcId String
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.
    allocationId string
    The ID of the EIP that you want to associate with an instance.
    instanceId string
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    force boolean
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    instanceType string
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    mode string
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    privateIpAddress string
    The IP address in the CIDR block of the vSwitch.
    vpcId string
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.
    allocation_id str
    The ID of the EIP that you want to associate with an instance.
    instance_id str
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    force bool
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    instance_type str
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    mode str
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    private_ip_address str
    The IP address in the CIDR block of the vSwitch.
    vpc_id str
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.
    allocationId String
    The ID of the EIP that you want to associate with an instance.
    instanceId String
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    force Boolean
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    instanceType String
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    mode String
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    privateIpAddress String
    The IP address in the CIDR block of the vSwitch.
    vpcId String
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the EipAssociation resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing EipAssociation Resource

    Get an existing EipAssociation resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: EipAssociationState, opts?: CustomResourceOptions): EipAssociation
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        allocation_id: Optional[str] = None,
        force: Optional[bool] = None,
        instance_id: Optional[str] = None,
        instance_type: Optional[str] = None,
        mode: Optional[str] = None,
        private_ip_address: Optional[str] = None,
        vpc_id: Optional[str] = None) -> EipAssociation
    func GetEipAssociation(ctx *Context, name string, id IDInput, state *EipAssociationState, opts ...ResourceOption) (*EipAssociation, error)
    public static EipAssociation Get(string name, Input<string> id, EipAssociationState? state, CustomResourceOptions? opts = null)
    public static EipAssociation get(String name, Output<String> id, EipAssociationState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AllocationId string
    The ID of the EIP that you want to associate with an instance.
    Force bool
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    InstanceId string
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    InstanceType string
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    Mode string
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    PrivateIpAddress string
    The IP address in the CIDR block of the vSwitch.
    VpcId string
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.
    AllocationId string
    The ID of the EIP that you want to associate with an instance.
    Force bool
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    InstanceId string
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    InstanceType string
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    Mode string
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    PrivateIpAddress string
    The IP address in the CIDR block of the vSwitch.
    VpcId string
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.
    allocationId String
    The ID of the EIP that you want to associate with an instance.
    force Boolean
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    instanceId String
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    instanceType String
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    mode String
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    privateIpAddress String
    The IP address in the CIDR block of the vSwitch.
    vpcId String
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.
    allocationId string
    The ID of the EIP that you want to associate with an instance.
    force boolean
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    instanceId string
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    instanceType string
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    mode string
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    privateIpAddress string
    The IP address in the CIDR block of the vSwitch.
    vpcId string
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.
    allocation_id str
    The ID of the EIP that you want to associate with an instance.
    force bool
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    instance_id str
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    instance_type str
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    mode str
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    private_ip_address str
    The IP address in the CIDR block of the vSwitch.
    vpc_id str
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.
    allocationId String
    The ID of the EIP that you want to associate with an instance.
    force Boolean
    When EIP is bound to a NAT gateway, and the NAT gateway adds a DNAT or SNAT entry, set it for true can unassociation any way. Default value: false. Valid values: true, false.
    instanceId String
    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.
    instanceType String
    The type of the instance with which you want to associate the EIP. Valid values: Nat, SlbInstance, EcsInstance, NetworkInterface, HaVip and IpAddress.
    mode String
    The association mode. Default value: NAT. Valid values: NAT, BINDED, MULTI_BINDED. Note: This parameter is required only when instance_type is set to NetworkInterface.
    privateIpAddress String
    The IP address in the CIDR block of the vSwitch.
    vpcId String
    The ID of the VPC that has IPv4 gateways enabled and that is deployed in the same region as the EIP. When you associate an EIP with an IP address, the system can enable the IP address to access the Internet based on VPC route configurations. Note: This parameter is required if instance_type is set to IpAddress.

    Import

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

    $ pulumi import alicloud:ecs/eipAssociation:EipAssociation example <allocation_id>:<instance_id>

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    Alibaba Cloud pulumi/pulumi-alicloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the alicloud Terraform Provider.
    alicloud logo
    Alibaba Cloud v3.53.0 published on Wednesday, Apr 17, 2024 by Pulumi
    pulumi/pulumi-alicloud