Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. Alibaba Cloud Provider
  3. API Docs
  4. ess
  5. Attachment
Alibaba Cloud v3.80.0 published on Wednesday, Jun 11, 2025 by Pulumi
pulumi/pulumi-alicloud

alicloud.ess.Attachment

Explore with Pulumi AI

alicloud logo
Alibaba Cloud v3.80.0 published on Wednesday, Jun 11, 2025 by Pulumi
pulumi/pulumi-alicloud

    Attaches several ECS instances to a specified scaling group or remove them from it.

    NOTE: ECS instances can be attached or remove only when the scaling group is active, and it has no scaling activity in progress.

    NOTE: There are two types ECS instances in a scaling group: “AutoCreated” and “Attached”. The total number of them can not larger than the scaling group “MaxSize”.

    NOTE: Available since v1.6.0.

    Example Usage

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

const config = new pulumi.Config();
const name = config.get("name") || "terraform-example";
const defaultInteger = new random.index.Integer("default", {
    min: 10000,
    max: 99999,
});
const myName = `${name}-${defaultInteger.result}`;
const _default = alicloud.getZones({
    availableDiskCategory: "cloud_efficiency",
    availableResourceCreation: "VSwitch",
});
const defaultGetInstanceTypes = _default.then(_default => alicloud.ecs.getInstanceTypes({
    availabilityZone: _default.zones?.[0]?.id,
    cpuCoreCount: 2,
    memorySize: 4,
}));
const defaultGetImages = alicloud.ecs.getImages({
    nameRegex: "^ubuntu_18.*64",
    mostRecent: true,
    owners: "system",
});
const defaultGetNetworks = alicloud.vpc.getNetworks({
    nameRegex: "^default-NODELETING$",
    cidrBlock: "10.4.0.0/16",
});
const defaultGetSwitches = Promise.all([defaultGetNetworks, _default]).then(([defaultGetNetworks, _default]) => alicloud.vpc.getSwitches({
    cidrBlock: "10.4.0.0/24",
    vpcId: defaultGetNetworks.ids?.[0],
    zoneId: _default.zones?.[0]?.id,
}));
const defaultSecurityGroup = new alicloud.ecs.SecurityGroup("default", {vpcId: defaultGetNetworks.then(defaultGetNetworks => defaultGetNetworks.ids?.[0])});
const defaultSecurityGroupRule = new alicloud.ecs.SecurityGroupRule("default", {
    type: "ingress",
    ipProtocol: "tcp",
    nicType: "intranet",
    policy: "accept",
    portRange: "22/22",
    priority: 1,
    securityGroupId: defaultSecurityGroup.id,
    cidrIp: "172.16.0.0/24",
});
const defaultScalingGroup = new alicloud.ess.ScalingGroup("default", {
    minSize: 0,
    maxSize: 2,
    scalingGroupName: myName,
    removalPolicies: [
        "OldestInstance",
        "NewestInstance",
    ],
    vswitchIds: [defaultGetSwitches.then(defaultGetSwitches => defaultGetSwitches.ids?.[0])],
});
const defaultScalingConfiguration = new alicloud.ess.ScalingConfiguration("default", {
    scalingGroupId: defaultScalingGroup.id,
    imageId: defaultGetImages.then(defaultGetImages => defaultGetImages.images?.[0]?.id),
    instanceType: defaultGetInstanceTypes.then(defaultGetInstanceTypes => defaultGetInstanceTypes.instanceTypes?.[0]?.id),
    securityGroupId: defaultSecurityGroup.id,
    forceDelete: true,
    active: true,
    enable: true,
});
const defaultInstance: alicloud.ecs.Instance[] = [];
for (const range = {value: 0}; range.value < 2; range.value++) {
    defaultInstance.push(new alicloud.ecs.Instance(`default-${range.value}`, {
        imageId: defaultGetImages.then(defaultGetImages => defaultGetImages.images?.[0]?.id),
        instanceType: defaultGetInstanceTypes.then(defaultGetInstanceTypes => defaultGetInstanceTypes.instanceTypes?.[0]?.id),
        securityGroups: [defaultSecurityGroup.id],
        internetChargeType: "PayByTraffic",
        internetMaxBandwidthOut: 10,
        instanceChargeType: "PostPaid",
        systemDiskCategory: "cloud_efficiency",
        vswitchId: defaultGetSwitches.then(defaultGetSwitches => defaultGetSwitches.ids?.[0]),
        instanceName: name,
    }));
}
const defaultAttachment = new alicloud.ess.Attachment("default", {
    scalingGroupId: defaultScalingGroup.id,
    instanceIds: [
        defaultInstance[0].id,
        defaultInstance[1].id,
    ],
    force: true,
});

    import pulumi
import pulumi_alicloud as alicloud
import pulumi_random as random

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "terraform-example"
default_integer = random.index.Integer("default",
    min=10000,
    max=99999)
my_name = f"{name}-{default_integer['result']}"
default = alicloud.get_zones(available_disk_category="cloud_efficiency",
    available_resource_creation="VSwitch")
default_get_instance_types = alicloud.ecs.get_instance_types(availability_zone=default.zones[0].id,
    cpu_core_count=2,
    memory_size=4)
default_get_images = alicloud.ecs.get_images(name_regex="^ubuntu_18.*64",
    most_recent=True,
    owners="system")
default_get_networks = alicloud.vpc.get_networks(name_regex="^default-NODELETING$",
    cidr_block="10.4.0.0/16")
default_get_switches = alicloud.vpc.get_switches(cidr_block="10.4.0.0/24",
    vpc_id=default_get_networks.ids[0],
    zone_id=default.zones[0].id)
default_security_group = alicloud.ecs.SecurityGroup("default", vpc_id=default_get_networks.ids[0])
default_security_group_rule = alicloud.ecs.SecurityGroupRule("default",
    type="ingress",
    ip_protocol="tcp",
    nic_type="intranet",
    policy="accept",
    port_range="22/22",
    priority=1,
    security_group_id=default_security_group.id,
    cidr_ip="172.16.0.0/24")
default_scaling_group = alicloud.ess.ScalingGroup("default",
    min_size=0,
    max_size=2,
    scaling_group_name=my_name,
    removal_policies=[
        "OldestInstance",
        "NewestInstance",
    ],
    vswitch_ids=[default_get_switches.ids[0]])
default_scaling_configuration = alicloud.ess.ScalingConfiguration("default",
    scaling_group_id=default_scaling_group.id,
    image_id=default_get_images.images[0].id,
    instance_type=default_get_instance_types.instance_types[0].id,
    security_group_id=default_security_group.id,
    force_delete=True,
    active=True,
    enable=True)
default_instance = []
for range in [{"value": i} for i in range(0, 2)]:
    default_instance.append(alicloud.ecs.Instance(f"default-{range['value']}",
        image_id=default_get_images.images[0].id,
        instance_type=default_get_instance_types.instance_types[0].id,
        security_groups=[default_security_group.id],
        internet_charge_type="PayByTraffic",
        internet_max_bandwidth_out=10,
        instance_charge_type="PostPaid",
        system_disk_category="cloud_efficiency",
        vswitch_id=default_get_switches.ids[0],
        instance_name=name))
default_attachment = alicloud.ess.Attachment("default",
    scaling_group_id=default_scaling_group.id,
    instance_ids=[
        default_instance[0].id,
        default_instance[1].id,
    ],
    force=True)

    package main

import (
	"fmt"

	"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/ess"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
	"github.com/pulumi/pulumi-random/sdk/v4/go/random"
	"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 := "terraform-example"
		if param := cfg.Get("name"); param != "" {
			name = param
		}
		defaultInteger, err := random.NewInteger(ctx, "default", &random.IntegerArgs{
			Min: 10000,
			Max: 99999,
		})
		if err != nil {
			return err
		}
		myName := fmt.Sprintf("%v-%v", name, defaultInteger.Result)
		_default, err := alicloud.GetZones(ctx, &alicloud.GetZonesArgs{
			AvailableDiskCategory:     pulumi.StringRef("cloud_efficiency"),
			AvailableResourceCreation: pulumi.StringRef("VSwitch"),
		}, nil)
		if err != nil {
			return err
		}
		defaultGetInstanceTypes, err := ecs.GetInstanceTypes(ctx, &ecs.GetInstanceTypesArgs{
			AvailabilityZone: pulumi.StringRef(_default.Zones[0].Id),
			CpuCoreCount:     pulumi.IntRef(2),
			MemorySize:       pulumi.Float64Ref(4),
		}, nil)
		if err != nil {
			return err
		}
		defaultGetImages, err := ecs.GetImages(ctx, &ecs.GetImagesArgs{
			NameRegex:  pulumi.StringRef("^ubuntu_18.*64"),
			MostRecent: pulumi.BoolRef(true),
			Owners:     pulumi.StringRef("system"),
		}, nil)
		if err != nil {
			return err
		}
		defaultGetNetworks, err := vpc.GetNetworks(ctx, &vpc.GetNetworksArgs{
			NameRegex: pulumi.StringRef("^default-NODELETING$"),
			CidrBlock: pulumi.StringRef("10.4.0.0/16"),
		}, nil)
		if err != nil {
			return err
		}
		defaultGetSwitches, err := vpc.GetSwitches(ctx, &vpc.GetSwitchesArgs{
			CidrBlock: pulumi.StringRef("10.4.0.0/24"),
			VpcId:     pulumi.StringRef(defaultGetNetworks.Ids[0]),
			ZoneId:    pulumi.StringRef(_default.Zones[0].Id),
		}, nil)
		if err != nil {
			return err
		}
		defaultSecurityGroup, err := ecs.NewSecurityGroup(ctx, "default", &ecs.SecurityGroupArgs{
			VpcId: pulumi.String(defaultGetNetworks.Ids[0]),
		})
		if err != nil {
			return err
		}
		_, err = ecs.NewSecurityGroupRule(ctx, "default", &ecs.SecurityGroupRuleArgs{
			Type:            pulumi.String("ingress"),
			IpProtocol:      pulumi.String("tcp"),
			NicType:         pulumi.String("intranet"),
			Policy:          pulumi.String("accept"),
			PortRange:       pulumi.String("22/22"),
			Priority:        pulumi.Int(1),
			SecurityGroupId: defaultSecurityGroup.ID(),
			CidrIp:          pulumi.String("172.16.0.0/24"),
		})
		if err != nil {
			return err
		}
		defaultScalingGroup, err := ess.NewScalingGroup(ctx, "default", &ess.ScalingGroupArgs{
			MinSize:          pulumi.Int(0),
			MaxSize:          pulumi.Int(2),
			ScalingGroupName: pulumi.String(myName),
			RemovalPolicies: pulumi.StringArray{
				pulumi.String("OldestInstance"),
				pulumi.String("NewestInstance"),
			},
			VswitchIds: pulumi.StringArray{
				pulumi.String(defaultGetSwitches.Ids[0]),
			},
		})
		if err != nil {
			return err
		}
		_, err = ess.NewScalingConfiguration(ctx, "default", &ess.ScalingConfigurationArgs{
			ScalingGroupId:  defaultScalingGroup.ID(),
			ImageId:         pulumi.String(defaultGetImages.Images[0].Id),
			InstanceType:    pulumi.String(defaultGetInstanceTypes.InstanceTypes[0].Id),
			SecurityGroupId: defaultSecurityGroup.ID(),
			ForceDelete:     pulumi.Bool(true),
			Active:          pulumi.Bool(true),
			Enable:          pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		var defaultInstance []*ecs.Instance
		for index := 0; index < 2; index++ {
			key0 := index
			_ := index
			__res, err := ecs.NewInstance(ctx, fmt.Sprintf("default-%v", key0), &ecs.InstanceArgs{
				ImageId:      pulumi.String(defaultGetImages.Images[0].Id),
				InstanceType: pulumi.String(defaultGetInstanceTypes.InstanceTypes[0].Id),
				SecurityGroups: pulumi.StringArray{
					defaultSecurityGroup.ID(),
				},
				InternetChargeType:      pulumi.String("PayByTraffic"),
				InternetMaxBandwidthOut: pulumi.Int(10),
				InstanceChargeType:      pulumi.String("PostPaid"),
				SystemDiskCategory:      pulumi.String("cloud_efficiency"),
				VswitchId:               pulumi.String(defaultGetSwitches.Ids[0]),
				InstanceName:            pulumi.String(name),
			})
			if err != nil {
				return err
			}
			defaultInstance = append(defaultInstance, __res)
		}
		_, err = ess.NewAttachment(ctx, "default", &ess.AttachmentArgs{
			ScalingGroupId: defaultScalingGroup.ID(),
			InstanceIds: pulumi.StringArray{
				defaultInstance[0].ID(),
				defaultInstance[1].ID(),
			},
			Force: pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var config = new Config();
    var name = config.Get("name") ?? "terraform-example";
    var defaultInteger = new Random.Index.Integer("default", new()
    {
        Min = 10000,
        Max = 99999,
    });

    var myName = $"{name}-{defaultInteger.Result}";

    var @default = AliCloud.GetZones.Invoke(new()
    {
        AvailableDiskCategory = "cloud_efficiency",
        AvailableResourceCreation = "VSwitch",
    });

    var defaultGetInstanceTypes = AliCloud.Ecs.GetInstanceTypes.Invoke(new()
    {
        AvailabilityZone = @default.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
        CpuCoreCount = 2,
        MemorySize = 4,
    });

    var defaultGetImages = AliCloud.Ecs.GetImages.Invoke(new()
    {
        NameRegex = "^ubuntu_18.*64",
        MostRecent = true,
        Owners = "system",
    });

    var defaultGetNetworks = AliCloud.Vpc.GetNetworks.Invoke(new()
    {
        NameRegex = "^default-NODELETING$",
        CidrBlock = "10.4.0.0/16",
    });

    var defaultGetSwitches = AliCloud.Vpc.GetSwitches.Invoke(new()
    {
        CidrBlock = "10.4.0.0/24",
        VpcId = defaultGetNetworks.Apply(getNetworksResult => getNetworksResult.Ids[0]),
        ZoneId = @default.Apply(getZonesResult => getZonesResult.Zones[0]?.Id),
    });

    var defaultSecurityGroup = new AliCloud.Ecs.SecurityGroup("default", new()
    {
        VpcId = defaultGetNetworks.Apply(getNetworksResult => getNetworksResult.Ids[0]),
    });

    var defaultSecurityGroupRule = new AliCloud.Ecs.SecurityGroupRule("default", new()
    {
        Type = "ingress",
        IpProtocol = "tcp",
        NicType = "intranet",
        Policy = "accept",
        PortRange = "22/22",
        Priority = 1,
        SecurityGroupId = defaultSecurityGroup.Id,
        CidrIp = "172.16.0.0/24",
    });

    var defaultScalingGroup = new AliCloud.Ess.ScalingGroup("default", new()
    {
        MinSize = 0,
        MaxSize = 2,
        ScalingGroupName = myName,
        RemovalPolicies = new[]
        {
            "OldestInstance",
            "NewestInstance",
        },
        VswitchIds = new[]
        {
            defaultGetSwitches.Apply(getSwitchesResult => getSwitchesResult.Ids[0]),
        },
    });

    var defaultScalingConfiguration = new AliCloud.Ess.ScalingConfiguration("default", new()
    {
        ScalingGroupId = defaultScalingGroup.Id,
        ImageId = defaultGetImages.Apply(getImagesResult => getImagesResult.Images[0]?.Id),
        InstanceType = defaultGetInstanceTypes.Apply(getInstanceTypesResult => getInstanceTypesResult.InstanceTypes[0]?.Id),
        SecurityGroupId = defaultSecurityGroup.Id,
        ForceDelete = true,
        Active = true,
        Enable = true,
    });

    var defaultInstance = new List<AliCloud.Ecs.Instance>();
    for (var rangeIndex = 0; rangeIndex < 2; rangeIndex++)
    {
        var range = new { Value = rangeIndex };
        defaultInstance.Add(new AliCloud.Ecs.Instance($"default-{range.Value}", new()
        {
            ImageId = defaultGetImages.Apply(getImagesResult => getImagesResult.Images[0]?.Id),
            InstanceType = defaultGetInstanceTypes.Apply(getInstanceTypesResult => getInstanceTypesResult.InstanceTypes[0]?.Id),
            SecurityGroups = new[]
            {
                defaultSecurityGroup.Id,
            },
            InternetChargeType = "PayByTraffic",
            InternetMaxBandwidthOut = 10,
            InstanceChargeType = "PostPaid",
            SystemDiskCategory = "cloud_efficiency",
            VswitchId = defaultGetSwitches.Apply(getSwitchesResult => getSwitchesResult.Ids[0]),
            InstanceName = name,
        }));
    }
    var defaultAttachment = new AliCloud.Ess.Attachment("default", new()
    {
        ScalingGroupId = defaultScalingGroup.Id,
        InstanceIds = new[]
        {
            defaultInstance[0].Id,
            defaultInstance[1].Id,
        },
        Force = true,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.random.integer;
import com.pulumi.random.integerArgs;
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.VpcFunctions;
import com.pulumi.alicloud.vpc.inputs.GetNetworksArgs;
import com.pulumi.alicloud.vpc.inputs.GetSwitchesArgs;
import com.pulumi.alicloud.ecs.SecurityGroup;
import com.pulumi.alicloud.ecs.SecurityGroupArgs;
import com.pulumi.alicloud.ecs.SecurityGroupRule;
import com.pulumi.alicloud.ecs.SecurityGroupRuleArgs;
import com.pulumi.alicloud.ess.ScalingGroup;
import com.pulumi.alicloud.ess.ScalingGroupArgs;
import com.pulumi.alicloud.ess.ScalingConfiguration;
import com.pulumi.alicloud.ess.ScalingConfigurationArgs;
import com.pulumi.alicloud.ecs.Instance;
import com.pulumi.alicloud.ecs.InstanceArgs;
import com.pulumi.alicloud.ess.Attachment;
import com.pulumi.alicloud.ess.AttachmentArgs;
import com.pulumi.codegen.internal.KeyedValue;
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("terraform-example");
        var defaultInteger = new Integer("defaultInteger", IntegerArgs.builder()
            .min(10000)
            .max(99999)
            .build());

        final var myName = String.format("%s-%s", name,defaultInteger.result());

        final var default = AlicloudFunctions.getZones(GetZonesArgs.builder()
            .availableDiskCategory("cloud_efficiency")
            .availableResourceCreation("VSwitch")
            .build());

        final var defaultGetInstanceTypes = EcsFunctions.getInstanceTypes(GetInstanceTypesArgs.builder()
            .availabilityZone(default_.zones()[0].id())
            .cpuCoreCount(2)
            .memorySize(4)
            .build());

        final var defaultGetImages = EcsFunctions.getImages(GetImagesArgs.builder()
            .nameRegex("^ubuntu_18.*64")
            .mostRecent(true)
            .owners("system")
            .build());

        final var defaultGetNetworks = VpcFunctions.getNetworks(GetNetworksArgs.builder()
            .nameRegex("^default-NODELETING$")
            .cidrBlock("10.4.0.0/16")
            .build());

        final var defaultGetSwitches = VpcFunctions.getSwitches(GetSwitchesArgs.builder()
            .cidrBlock("10.4.0.0/24")
            .vpcId(defaultGetNetworks.ids()[0])
            .zoneId(default_.zones()[0].id())
            .build());

        var defaultSecurityGroup = new SecurityGroup("defaultSecurityGroup", SecurityGroupArgs.builder()
            .vpcId(defaultGetNetworks.ids()[0])
            .build());

        var defaultSecurityGroupRule = new SecurityGroupRule("defaultSecurityGroupRule", SecurityGroupRuleArgs.builder()
            .type("ingress")
            .ipProtocol("tcp")
            .nicType("intranet")
            .policy("accept")
            .portRange("22/22")
            .priority(1)
            .securityGroupId(defaultSecurityGroup.id())
            .cidrIp("172.16.0.0/24")
            .build());

        var defaultScalingGroup = new ScalingGroup("defaultScalingGroup", ScalingGroupArgs.builder()
            .minSize(0)
            .maxSize(2)
            .scalingGroupName(myName)
            .removalPolicies(            
                "OldestInstance",
                "NewestInstance")
            .vswitchIds(defaultGetSwitches.ids()[0])
            .build());

        var defaultScalingConfiguration = new ScalingConfiguration("defaultScalingConfiguration", ScalingConfigurationArgs.builder()
            .scalingGroupId(defaultScalingGroup.id())
            .imageId(defaultGetImages.images()[0].id())
            .instanceType(defaultGetInstanceTypes.instanceTypes()[0].id())
            .securityGroupId(defaultSecurityGroup.id())
            .forceDelete(true)
            .active(true)
            .enable(true)
            .build());

        for (var i = 0; i < 2; i++) {
            new Instance("defaultInstance-" + i, InstanceArgs.builder()
                .imageId(defaultGetImages.images()[0].id())
                .instanceType(defaultGetInstanceTypes.instanceTypes()[0].id())
                .securityGroups(defaultSecurityGroup.id())
                .internetChargeType("PayByTraffic")
                .internetMaxBandwidthOut(10)
                .instanceChargeType("PostPaid")
                .systemDiskCategory("cloud_efficiency")
                .vswitchId(defaultGetSwitches.ids()[0])
                .instanceName(name)
                .build());

        
}
        var defaultAttachment = new Attachment("defaultAttachment", AttachmentArgs.builder()
            .scalingGroupId(defaultScalingGroup.id())
            .instanceIds(            
                defaultInstance[0].id(),
                defaultInstance[1].id())
            .force(true)
            .build());

    }
}

    configuration:
  name:
    type: string
    default: terraform-example
resources:
  defaultInteger:
    type: random:integer
    name: default
    properties:
      min: 10000
      max: 99999
  defaultSecurityGroup:
    type: alicloud:ecs:SecurityGroup
    name: default
    properties:
      vpcId: ${defaultGetNetworks.ids[0]}
  defaultSecurityGroupRule:
    type: alicloud:ecs:SecurityGroupRule
    name: default
    properties:
      type: ingress
      ipProtocol: tcp
      nicType: intranet
      policy: accept
      portRange: 22/22
      priority: 1
      securityGroupId: ${defaultSecurityGroup.id}
      cidrIp: 172.16.0.0/24
  defaultScalingGroup:
    type: alicloud:ess:ScalingGroup
    name: default
    properties:
      minSize: 0
      maxSize: 2
      scalingGroupName: ${myName}
      removalPolicies:
        - OldestInstance
        - NewestInstance
      vswitchIds:
        - ${defaultGetSwitches.ids[0]}
  defaultScalingConfiguration:
    type: alicloud:ess:ScalingConfiguration
    name: default
    properties:
      scalingGroupId: ${defaultScalingGroup.id}
      imageId: ${defaultGetImages.images[0].id}
      instanceType: ${defaultGetInstanceTypes.instanceTypes[0].id}
      securityGroupId: ${defaultSecurityGroup.id}
      forceDelete: true
      active: true
      enable: true
  defaultInstance:
    type: alicloud:ecs:Instance
    name: default
    properties:
      imageId: ${defaultGetImages.images[0].id}
      instanceType: ${defaultGetInstanceTypes.instanceTypes[0].id}
      securityGroups:
        - ${defaultSecurityGroup.id}
      internetChargeType: PayByTraffic
      internetMaxBandwidthOut: '10'
      instanceChargeType: PostPaid
      systemDiskCategory: cloud_efficiency
      vswitchId: ${defaultGetSwitches.ids[0]}
      instanceName: ${name}
    options: {}
  defaultAttachment:
    type: alicloud:ess:Attachment
    name: default
    properties:
      scalingGroupId: ${defaultScalingGroup.id}
      instanceIds:
        - ${defaultInstance[0].id}
        - ${defaultInstance[1].id}
      force: true
variables:
  myName: ${name}-${defaultInteger.result}
  default:
    fn::invoke:
      function: alicloud:getZones
      arguments:
        availableDiskCategory: cloud_efficiency
        availableResourceCreation: VSwitch
  defaultGetInstanceTypes:
    fn::invoke:
      function: alicloud:ecs:getInstanceTypes
      arguments:
        availabilityZone: ${default.zones[0].id}
        cpuCoreCount: 2
        memorySize: 4
  defaultGetImages:
    fn::invoke:
      function: alicloud:ecs:getImages
      arguments:
        nameRegex: ^ubuntu_18.*64
        mostRecent: true
        owners: system
  defaultGetNetworks:
    fn::invoke:
      function: alicloud:vpc:getNetworks
      arguments:
        nameRegex: ^default-NODELETING$
        cidrBlock: 10.4.0.0/16
  defaultGetSwitches:
    fn::invoke:
      function: alicloud:vpc:getSwitches
      arguments:
        cidrBlock: 10.4.0.0/24
        vpcId: ${defaultGetNetworks.ids[0]}
        zoneId: ${default.zones[0].id}

    Create Attachment Resource

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

    Constructor syntax

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

@overload
def Attachment(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               instance_ids: Optional[Sequence[str]] = None,
               scaling_group_id: Optional[str] = None,
               entrusted: Optional[bool] = None,
               force: Optional[bool] = None,
               lifecycle_hook: Optional[bool] = None,
               load_balancer_weights: Optional[Sequence[int]] = None)
    func NewAttachment(ctx *Context, name string, args AttachmentArgs, opts ...ResourceOption) (*Attachment, error)
    public Attachment(string name, AttachmentArgs args, CustomResourceOptions? opts = null)
    public Attachment(String name, AttachmentArgs args)
public Attachment(String name, AttachmentArgs args, CustomResourceOptions options)

    type: alicloud:ess:Attachment
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 AttachmentArgs
    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 AttachmentArgs
    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 AttachmentArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args AttachmentArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args AttachmentArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

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

    var attachmentResource = new AliCloud.Ess.Attachment("attachmentResource", new()
{
    InstanceIds = new[]
    {
        "string",
    },
    ScalingGroupId = "string",
    Entrusted = false,
    Force = false,
    LifecycleHook = false,
    LoadBalancerWeights = new[]
    {
        0,
    },
});

    example, err := ess.NewAttachment(ctx, "attachmentResource", &ess.AttachmentArgs{
	InstanceIds: pulumi.StringArray{
		pulumi.String("string"),
	},
	ScalingGroupId: pulumi.String("string"),
	Entrusted:      pulumi.Bool(false),
	Force:          pulumi.Bool(false),
	LifecycleHook:  pulumi.Bool(false),
	LoadBalancerWeights: pulumi.IntArray{
		pulumi.Int(0),
	},
})

    var attachmentResource = new com.pulumi.alicloud.ess.Attachment("attachmentResource", com.pulumi.alicloud.ess.AttachmentArgs.builder()
    .instanceIds("string")
    .scalingGroupId("string")
    .entrusted(false)
    .force(false)
    .lifecycleHook(false)
    .loadBalancerWeights(0)
    .build());

    attachment_resource = alicloud.ess.Attachment("attachmentResource",
    instance_ids=["string"],
    scaling_group_id="string",
    entrusted=False,
    force=False,
    lifecycle_hook=False,
    load_balancer_weights=[0])

    const attachmentResource = new alicloud.ess.Attachment("attachmentResource", {
    instanceIds: ["string"],
    scalingGroupId: "string",
    entrusted: false,
    force: false,
    lifecycleHook: false,
    loadBalancerWeights: [0],
});

    type: alicloud:ess:Attachment
properties:
    entrusted: false
    force: false
    instanceIds:
        - string
    lifecycleHook: false
    loadBalancerWeights:
        - 0
    scalingGroupId: string

    Attachment Resource Properties

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

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Attachment resource accepts the following input properties:

    InstanceIds List<string>
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    ScalingGroupId string
    ID of the scaling group of a scaling configuration.
    Entrusted bool
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    Force bool
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    LifecycleHook bool
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    LoadBalancerWeights List<int>

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.
    InstanceIds []string
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    ScalingGroupId string
    ID of the scaling group of a scaling configuration.
    Entrusted bool
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    Force bool
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    LifecycleHook bool
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    LoadBalancerWeights []int

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.
    instanceIds List<String>
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    scalingGroupId String
    ID of the scaling group of a scaling configuration.
    entrusted Boolean
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    force Boolean
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    lifecycleHook Boolean
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    loadBalancerWeights List<Integer>

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.
    instanceIds string[]
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    scalingGroupId string
    ID of the scaling group of a scaling configuration.
    entrusted boolean
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    force boolean
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    lifecycleHook boolean
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    loadBalancerWeights number[]

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.
    instance_ids Sequence[str]
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    scaling_group_id str
    ID of the scaling group of a scaling configuration.
    entrusted bool
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    force bool
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    lifecycle_hook bool
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    load_balancer_weights Sequence[int]

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.
    instanceIds List<String>
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    scalingGroupId String
    ID of the scaling group of a scaling configuration.
    entrusted Boolean
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    force Boolean
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    lifecycleHook Boolean
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    loadBalancerWeights List<Number>

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Attachment 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 Attachment Resource

    Get an existing Attachment 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?: AttachmentState, opts?: CustomResourceOptions): Attachment
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        entrusted: Optional[bool] = None,
        force: Optional[bool] = None,
        instance_ids: Optional[Sequence[str]] = None,
        lifecycle_hook: Optional[bool] = None,
        load_balancer_weights: Optional[Sequence[int]] = None,
        scaling_group_id: Optional[str] = None) -> Attachment
    func GetAttachment(ctx *Context, name string, id IDInput, state *AttachmentState, opts ...ResourceOption) (*Attachment, error)
    public static Attachment Get(string name, Input<string> id, AttachmentState? state, CustomResourceOptions? opts = null)
    public static Attachment get(String name, Output<String> id, AttachmentState state, CustomResourceOptions options)
    resources:  _:    type: alicloud:ess:Attachment    get:      id: ${id}
    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:
    Entrusted bool
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    Force bool
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    InstanceIds List<string>
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    LifecycleHook bool
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    LoadBalancerWeights List<int>

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.
    ScalingGroupId string
    ID of the scaling group of a scaling configuration.
    Entrusted bool
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    Force bool
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    InstanceIds []string
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    LifecycleHook bool
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    LoadBalancerWeights []int

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.
    ScalingGroupId string
    ID of the scaling group of a scaling configuration.
    entrusted Boolean
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    force Boolean
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    instanceIds List<String>
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    lifecycleHook Boolean
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    loadBalancerWeights List<Integer>

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.
    scalingGroupId String
    ID of the scaling group of a scaling configuration.
    entrusted boolean
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    force boolean
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    instanceIds string[]
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    lifecycleHook boolean
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    loadBalancerWeights number[]

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.
    scalingGroupId string
    ID of the scaling group of a scaling configuration.
    entrusted bool
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    force bool
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    instance_ids Sequence[str]
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    lifecycle_hook bool
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    load_balancer_weights Sequence[int]

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.
    scaling_group_id str
    ID of the scaling group of a scaling configuration.
    entrusted Boolean
    Specifies whether the scaling group manages the lifecycles of the instances that are manually added to the scaling group.
    force Boolean
    Whether to remove forcibly "AutoCreated" ECS instances in order to release scaling group capacity "MaxSize" for attaching ECS instances. Default to false.
    instanceIds List<String>
    ID of the ECS instance to be attached to the scaling group. You can input up to 20 IDs.
    lifecycleHook Boolean
    Specifies whether to trigger a lifecycle hook for the scaling group to which instances are being added.
    loadBalancerWeights List<Number>

    The weight of ECS instance N or elastic container instance N as a backend server of the associated Server Load Balancer (SLB) instance. Valid values of N: 1 to 20. Valid values of this parameter: 1 to 100.

    NOTE: "AutoCreated" ECS instance will be deleted after it is removed from scaling group, but "Attached" will be not.

    NOTE: Restrictions on attaching ECS instances:

    • The attached ECS instances and the scaling group must have the same region and network type(Classic or VPC).
    • The attached ECS instances and the instance with active scaling configurations must have the same instance type.
    • The attached ECS instances must in the running state.
    • The attached ECS instances has not been attached to other scaling groups.
    • The attached ECS instances supports Subscription and Pay-As-You-Go payment methods.
    scalingGroupId String
    ID of the scaling group of a scaling configuration.

    Import

    ESS attachment can be imported using the id or scaling group id, e.g.

    $ pulumi import alicloud:ess/attachment:Attachment example asg-abc123456

    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.80.0 published on Wednesday, Jun 11, 2025 by Pulumi
    pulumi/pulumi-alicloud