Docs Packages
  1. Packages
  2. Alibaba Cloud
  3. API Docs
  4. ecs
  5. EipAssociation
Alibaba Cloud v3.44.0 published on Thursday, Sep 28, 2023 by Pulumi
pulumi/pulumi-alicloud

alicloud.ecs.EipAssociation

Explore with Pulumi AI

alicloud logo
Alibaba Cloud v3.44.0 published on Thursday, Sep 28, 2023 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.

    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.

    Example Usage

    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 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
	})
}

    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());

    }
}

    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)

    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,
});

    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

    Create EipAssociation Resource

    new EipAssociation(name: string, args: EipAssociationArgs, opts?: CustomResourceOptions);
    @overload
def EipAssociation(resource_name: str,
                   opts: Optional[ResourceOptions] = None,
                   allocation_id: Optional[str] = None,
                   force: Optional[bool] = None,
                   instance_id: Optional[str] = None,
                   instance_type: Optional[str] = None,
                   private_ip_address: Optional[str] = None,
                   vpc_id: Optional[str] = None)
@overload
def EipAssociation(resource_name: str,
                   args: EipAssociationArgs,
                   opts: Optional[ResourceOptions] = 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.
    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.

    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 allocation EIP ID.

    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 to false.

    InstanceType string

    The type of cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    PrivateIpAddress string

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    AllocationId string

    The allocation EIP ID.

    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 to false.

    InstanceType string

    The type of cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    PrivateIpAddress string

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    allocationId String

    The allocation EIP ID.

    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 to false.

    instanceType String

    The type of cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    privateIpAddress String

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    allocationId string

    The allocation EIP ID.

    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 to false.

    instanceType string

    The type of cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    privateIpAddress string

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    allocation_id str

    The allocation EIP ID.

    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 to false.

    instance_type str

    The type of cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    private_ip_address str

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    allocationId String

    The allocation EIP ID.

    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 to false.

    instanceType String

    The type of cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    privateIpAddress String

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    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,
        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 allocation EIP ID.

    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 to false.

    InstanceId string

    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.

    InstanceType string

    The type of cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    PrivateIpAddress string

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    AllocationId string

    The allocation EIP ID.

    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 to false.

    InstanceId string

    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.

    InstanceType string

    The type of cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    PrivateIpAddress string

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    allocationId String

    The allocation EIP ID.

    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 to false.

    instanceId String

    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.

    instanceType String

    The type of cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    privateIpAddress String

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    allocationId string

    The allocation EIP ID.

    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 to false.

    instanceId string

    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.

    instanceType string

    The type of cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    privateIpAddress string

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    allocation_id str

    The allocation EIP ID.

    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 to 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 cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    private_ip_address str

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    allocationId String

    The allocation EIP ID.

    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 to false.

    instanceId String

    The ID of the ECS or SLB instance or Nat Gateway or NetworkInterface or HaVip.

    instanceType String

    The type of cloud product that the eip instance to bind. Valid values: EcsInstance, SlbInstance, Nat, NetworkInterface, HaVip and IpAddress.

    privateIpAddress String

    The private IP address in the network segment of the vswitch which has been assigned.

    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. In this case, the EIP is associated with an IP address.

    Import

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

     $ pulumi import alicloud:ecs/eipAssociation:EipAssociation example eip-abc12345678:i-abc12355

    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.44.0 published on Thursday, Sep 28, 2023 by Pulumi
    pulumi/pulumi-alicloud