Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. ecs
  5. CapacityProvider

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi
pulumi/pulumi-aws-native

aws-native.ecs.CapacityProvider

Explore with Pulumi AI

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi
pulumi/pulumi-aws-native

Resource Type definition for AWS::ECS::CapacityProvider.

Example Usage

Example

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

return await Deployment.RunAsync(() => 
{
    var myCapacityProvider = new AwsNative.Ecs.CapacityProvider("myCapacityProvider", new()
    {
        AutoScalingGroupProvider = new AwsNative.Ecs.Inputs.CapacityProviderAutoScalingGroupProviderArgs
        {
            AutoScalingGroupArn = "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup",
            ManagedScaling = new AwsNative.Ecs.Inputs.CapacityProviderManagedScalingArgs
            {
                MaximumScalingStepSize = 10,
                MinimumScalingStepSize = 1,
                Status = AwsNative.Ecs.CapacityProviderManagedScalingStatus.Enabled,
                TargetCapacity = 100,
            },
            ManagedTerminationProtection = AwsNative.Ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Enabled,
        },
        Tags = new[]
        {
            new AwsNative.Inputs.TagArgs
            {
                Key = "environment",
                Value = "production",
            },
        },
    });

});
Copy
package main

import (
	awsnative "github.com/pulumi/pulumi-aws-native/sdk/go/aws"
	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/ecs"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ecs.NewCapacityProvider(ctx, "myCapacityProvider", &ecs.CapacityProviderArgs{
			AutoScalingGroupProvider: &ecs.CapacityProviderAutoScalingGroupProviderArgs{
				AutoScalingGroupArn: pulumi.String("arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup"),
				ManagedScaling: &ecs.CapacityProviderManagedScalingArgs{
					MaximumScalingStepSize: pulumi.Int(10),
					MinimumScalingStepSize: pulumi.Int(1),
					Status:                 ecs.CapacityProviderManagedScalingStatusEnabled,
					TargetCapacity:         pulumi.Int(100),
				},
				ManagedTerminationProtection: ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtectionEnabled,
			},
			Tags: aws.TagArray{
				&aws.TagArgs{
					Key:   pulumi.String("environment"),
					Value: pulumi.String("production"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy

Coming soon!

import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";

const myCapacityProvider = new aws_native.ecs.CapacityProvider("myCapacityProvider", {
    autoScalingGroupProvider: {
        autoScalingGroupArn: "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup",
        managedScaling: {
            maximumScalingStepSize: 10,
            minimumScalingStepSize: 1,
            status: aws_native.ecs.CapacityProviderManagedScalingStatus.Enabled,
            targetCapacity: 100,
        },
        managedTerminationProtection: aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Enabled,
    },
    tags: [{
        key: "environment",
        value: "production",
    }],
});
Copy
import pulumi
import pulumi_aws_native as aws_native

my_capacity_provider = aws_native.ecs.CapacityProvider("myCapacityProvider",
    auto_scaling_group_provider={
        "auto_scaling_group_arn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup",
        "managed_scaling": {
            "maximum_scaling_step_size": 10,
            "minimum_scaling_step_size": 1,
            "status": aws_native.ecs.CapacityProviderManagedScalingStatus.ENABLED,
            "target_capacity": 100,
        },
        "managed_termination_protection": aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.ENABLED,
    },
    tags=[{
        "key": "environment",
        "value": "production",
    }])
Copy

Coming soon!

Example

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

return await Deployment.RunAsync(() => 
{
    var myCapacityProvider = new AwsNative.Ecs.CapacityProvider("myCapacityProvider", new()
    {
        AutoScalingGroupProvider = new AwsNative.Ecs.Inputs.CapacityProviderAutoScalingGroupProviderArgs
        {
            AutoScalingGroupArn = "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup",
            ManagedScaling = new AwsNative.Ecs.Inputs.CapacityProviderManagedScalingArgs
            {
                MaximumScalingStepSize = 10,
                MinimumScalingStepSize = 1,
                Status = AwsNative.Ecs.CapacityProviderManagedScalingStatus.Enabled,
                TargetCapacity = 100,
            },
            ManagedTerminationProtection = AwsNative.Ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Enabled,
        },
        Tags = new[]
        {
            new AwsNative.Inputs.TagArgs
            {
                Key = "environment",
                Value = "production",
            },
        },
    });

});
Copy
package main

import (
	awsnative "github.com/pulumi/pulumi-aws-native/sdk/go/aws"
	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/ecs"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ecs.NewCapacityProvider(ctx, "myCapacityProvider", &ecs.CapacityProviderArgs{
			AutoScalingGroupProvider: &ecs.CapacityProviderAutoScalingGroupProviderArgs{
				AutoScalingGroupArn: pulumi.String("arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup"),
				ManagedScaling: &ecs.CapacityProviderManagedScalingArgs{
					MaximumScalingStepSize: pulumi.Int(10),
					MinimumScalingStepSize: pulumi.Int(1),
					Status:                 ecs.CapacityProviderManagedScalingStatusEnabled,
					TargetCapacity:         pulumi.Int(100),
				},
				ManagedTerminationProtection: ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtectionEnabled,
			},
			Tags: aws.TagArray{
				&aws.TagArgs{
					Key:   pulumi.String("environment"),
					Value: pulumi.String("production"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy

Coming soon!

import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";

const myCapacityProvider = new aws_native.ecs.CapacityProvider("myCapacityProvider", {
    autoScalingGroupProvider: {
        autoScalingGroupArn: "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup",
        managedScaling: {
            maximumScalingStepSize: 10,
            minimumScalingStepSize: 1,
            status: aws_native.ecs.CapacityProviderManagedScalingStatus.Enabled,
            targetCapacity: 100,
        },
        managedTerminationProtection: aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Enabled,
    },
    tags: [{
        key: "environment",
        value: "production",
    }],
});
Copy
import pulumi
import pulumi_aws_native as aws_native

my_capacity_provider = aws_native.ecs.CapacityProvider("myCapacityProvider",
    auto_scaling_group_provider={
        "auto_scaling_group_arn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup",
        "managed_scaling": {
            "maximum_scaling_step_size": 10,
            "minimum_scaling_step_size": 1,
            "status": aws_native.ecs.CapacityProviderManagedScalingStatus.ENABLED,
            "target_capacity": 100,
        },
        "managed_termination_protection": aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.ENABLED,
    },
    tags=[{
        "key": "environment",
        "value": "production",
    }])
Copy

Coming soon!

Example

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

return await Deployment.RunAsync(() => 
{
    var config = new Config();
    var autoScalingGroupArn1 = config.Require("autoScalingGroupArn1");
    var autoScalingGroupArn2 = config.Require("autoScalingGroupArn2");
    var capacityProvider1 = new AwsNative.Ecs.CapacityProvider("capacityProvider1", new()
    {
        AutoScalingGroupProvider = new AwsNative.Ecs.Inputs.CapacityProviderAutoScalingGroupProviderArgs
        {
            AutoScalingGroupArn = autoScalingGroupArn1,
            ManagedScaling = new AwsNative.Ecs.Inputs.CapacityProviderManagedScalingArgs
            {
                Status = AwsNative.Ecs.CapacityProviderManagedScalingStatus.Enabled,
            },
            ManagedTerminationProtection = AwsNative.Ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Disabled,
        },
    });

    var capacityProvider2 = new AwsNative.Ecs.CapacityProvider("capacityProvider2", new()
    {
        AutoScalingGroupProvider = new AwsNative.Ecs.Inputs.CapacityProviderAutoScalingGroupProviderArgs
        {
            AutoScalingGroupArn = autoScalingGroupArn2,
            ManagedScaling = new AwsNative.Ecs.Inputs.CapacityProviderManagedScalingArgs
            {
                Status = AwsNative.Ecs.CapacityProviderManagedScalingStatus.Enabled,
            },
            ManagedTerminationProtection = AwsNative.Ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Disabled,
        },
    });

    var cluster = new AwsNative.Ecs.Cluster("cluster");

    var clusterCPAssociation = new AwsNative.Ecs.ClusterCapacityProviderAssociations("clusterCPAssociation", new()
    {
        Cluster = cluster.Id,
        CapacityProviders = new[]
        {
            capacityProvider1.Id,
            capacityProvider2.Id,
        },
        DefaultCapacityProviderStrategy = new[]
        {
            new AwsNative.Ecs.Inputs.ClusterCapacityProviderAssociationsCapacityProviderStrategyArgs
            {
                Base = 2,
                Weight = 6,
                CapacityProvider = capacityProvider1.Id,
            },
            new AwsNative.Ecs.Inputs.ClusterCapacityProviderAssociationsCapacityProviderStrategyArgs
            {
                Base = 0,
                Weight = 10,
                CapacityProvider = capacityProvider2.Id,
            },
        },
    });

});
Copy
package main

import (
	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/ecs"
	"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, "")
		autoScalingGroupArn1 := cfg.Require("autoScalingGroupArn1")
		autoScalingGroupArn2 := cfg.Require("autoScalingGroupArn2")
		capacityProvider1, err := ecs.NewCapacityProvider(ctx, "capacityProvider1", &ecs.CapacityProviderArgs{
			AutoScalingGroupProvider: &ecs.CapacityProviderAutoScalingGroupProviderArgs{
				AutoScalingGroupArn: pulumi.String(autoScalingGroupArn1),
				ManagedScaling: &ecs.CapacityProviderManagedScalingArgs{
					Status: ecs.CapacityProviderManagedScalingStatusEnabled,
				},
				ManagedTerminationProtection: ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtectionDisabled,
			},
		})
		if err != nil {
			return err
		}
		capacityProvider2, err := ecs.NewCapacityProvider(ctx, "capacityProvider2", &ecs.CapacityProviderArgs{
			AutoScalingGroupProvider: &ecs.CapacityProviderAutoScalingGroupProviderArgs{
				AutoScalingGroupArn: pulumi.String(autoScalingGroupArn2),
				ManagedScaling: &ecs.CapacityProviderManagedScalingArgs{
					Status: ecs.CapacityProviderManagedScalingStatusEnabled,
				},
				ManagedTerminationProtection: ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtectionDisabled,
			},
		})
		if err != nil {
			return err
		}
		cluster, err := ecs.NewCluster(ctx, "cluster", nil)
		if err != nil {
			return err
		}
		_, err = ecs.NewClusterCapacityProviderAssociations(ctx, "clusterCPAssociation", &ecs.ClusterCapacityProviderAssociationsArgs{
			Cluster: cluster.ID(),
			CapacityProviders: pulumi.StringArray{
				capacityProvider1.ID(),
				capacityProvider2.ID(),
			},
			DefaultCapacityProviderStrategy: ecs.ClusterCapacityProviderAssociationsCapacityProviderStrategyArray{
				&ecs.ClusterCapacityProviderAssociationsCapacityProviderStrategyArgs{
					Base:             pulumi.Int(2),
					Weight:           pulumi.Int(6),
					CapacityProvider: capacityProvider1.ID(),
				},
				&ecs.ClusterCapacityProviderAssociationsCapacityProviderStrategyArgs{
					Base:             pulumi.Int(0),
					Weight:           pulumi.Int(10),
					CapacityProvider: capacityProvider2.ID(),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy

Coming soon!

import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";

const config = new pulumi.Config();
const autoScalingGroupArn1 = config.require("autoScalingGroupArn1");
const autoScalingGroupArn2 = config.require("autoScalingGroupArn2");
const capacityProvider1 = new aws_native.ecs.CapacityProvider("capacityProvider1", {autoScalingGroupProvider: {
    autoScalingGroupArn: autoScalingGroupArn1,
    managedScaling: {
        status: aws_native.ecs.CapacityProviderManagedScalingStatus.Enabled,
    },
    managedTerminationProtection: aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Disabled,
}});
const capacityProvider2 = new aws_native.ecs.CapacityProvider("capacityProvider2", {autoScalingGroupProvider: {
    autoScalingGroupArn: autoScalingGroupArn2,
    managedScaling: {
        status: aws_native.ecs.CapacityProviderManagedScalingStatus.Enabled,
    },
    managedTerminationProtection: aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Disabled,
}});
const cluster = new aws_native.ecs.Cluster("cluster", {});
const clusterCPAssociation = new aws_native.ecs.ClusterCapacityProviderAssociations("clusterCPAssociation", {
    cluster: cluster.id,
    capacityProviders: [
        capacityProvider1.id,
        capacityProvider2.id,
    ],
    defaultCapacityProviderStrategy: [
        {
            base: 2,
            weight: 6,
            capacityProvider: capacityProvider1.id,
        },
        {
            base: 0,
            weight: 10,
            capacityProvider: capacityProvider2.id,
        },
    ],
});
Copy
import pulumi
import pulumi_aws_native as aws_native

config = pulumi.Config()
auto_scaling_group_arn1 = config.require("autoScalingGroupArn1")
auto_scaling_group_arn2 = config.require("autoScalingGroupArn2")
capacity_provider1 = aws_native.ecs.CapacityProvider("capacityProvider1", auto_scaling_group_provider={
    "auto_scaling_group_arn": auto_scaling_group_arn1,
    "managed_scaling": {
        "status": aws_native.ecs.CapacityProviderManagedScalingStatus.ENABLED,
    },
    "managed_termination_protection": aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.DISABLED,
})
capacity_provider2 = aws_native.ecs.CapacityProvider("capacityProvider2", auto_scaling_group_provider={
    "auto_scaling_group_arn": auto_scaling_group_arn2,
    "managed_scaling": {
        "status": aws_native.ecs.CapacityProviderManagedScalingStatus.ENABLED,
    },
    "managed_termination_protection": aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.DISABLED,
})
cluster = aws_native.ecs.Cluster("cluster")
cluster_cpassociation = aws_native.ecs.ClusterCapacityProviderAssociations("clusterCPAssociation",
    cluster=cluster.id,
    capacity_providers=[
        capacity_provider1.id,
        capacity_provider2.id,
    ],
    default_capacity_provider_strategy=[
        {
            "base": 2,
            "weight": 6,
            "capacity_provider": capacity_provider1.id,
        },
        {
            "base": 0,
            "weight": 10,
            "capacity_provider": capacity_provider2.id,
        },
    ])
Copy

Coming soon!

Example

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

return await Deployment.RunAsync(() => 
{
    var config = new Config();
    var autoScalingGroupArn1 = config.Require("autoScalingGroupArn1");
    var autoScalingGroupArn2 = config.Require("autoScalingGroupArn2");
    var capacityProvider1 = new AwsNative.Ecs.CapacityProvider("capacityProvider1", new()
    {
        AutoScalingGroupProvider = new AwsNative.Ecs.Inputs.CapacityProviderAutoScalingGroupProviderArgs
        {
            AutoScalingGroupArn = autoScalingGroupArn1,
            ManagedScaling = new AwsNative.Ecs.Inputs.CapacityProviderManagedScalingArgs
            {
                Status = AwsNative.Ecs.CapacityProviderManagedScalingStatus.Enabled,
            },
            ManagedTerminationProtection = AwsNative.Ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Disabled,
        },
    });

    var capacityProvider2 = new AwsNative.Ecs.CapacityProvider("capacityProvider2", new()
    {
        AutoScalingGroupProvider = new AwsNative.Ecs.Inputs.CapacityProviderAutoScalingGroupProviderArgs
        {
            AutoScalingGroupArn = autoScalingGroupArn2,
            ManagedScaling = new AwsNative.Ecs.Inputs.CapacityProviderManagedScalingArgs
            {
                Status = AwsNative.Ecs.CapacityProviderManagedScalingStatus.Enabled,
            },
            ManagedTerminationProtection = AwsNative.Ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Disabled,
        },
    });

    var cluster = new AwsNative.Ecs.Cluster("cluster");

    var clusterCPAssociation = new AwsNative.Ecs.ClusterCapacityProviderAssociations("clusterCPAssociation", new()
    {
        Cluster = cluster.Id,
        CapacityProviders = new[]
        {
            capacityProvider1.Id,
            capacityProvider2.Id,
        },
        DefaultCapacityProviderStrategy = new[]
        {
            new AwsNative.Ecs.Inputs.ClusterCapacityProviderAssociationsCapacityProviderStrategyArgs
            {
                Base = 2,
                Weight = 6,
                CapacityProvider = capacityProvider1.Id,
            },
            new AwsNative.Ecs.Inputs.ClusterCapacityProviderAssociationsCapacityProviderStrategyArgs
            {
                Base = 0,
                Weight = 10,
                CapacityProvider = capacityProvider2.Id,
            },
        },
    });

});
Copy
package main

import (
	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/ecs"
	"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, "")
		autoScalingGroupArn1 := cfg.Require("autoScalingGroupArn1")
		autoScalingGroupArn2 := cfg.Require("autoScalingGroupArn2")
		capacityProvider1, err := ecs.NewCapacityProvider(ctx, "capacityProvider1", &ecs.CapacityProviderArgs{
			AutoScalingGroupProvider: &ecs.CapacityProviderAutoScalingGroupProviderArgs{
				AutoScalingGroupArn: pulumi.String(autoScalingGroupArn1),
				ManagedScaling: &ecs.CapacityProviderManagedScalingArgs{
					Status: ecs.CapacityProviderManagedScalingStatusEnabled,
				},
				ManagedTerminationProtection: ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtectionDisabled,
			},
		})
		if err != nil {
			return err
		}
		capacityProvider2, err := ecs.NewCapacityProvider(ctx, "capacityProvider2", &ecs.CapacityProviderArgs{
			AutoScalingGroupProvider: &ecs.CapacityProviderAutoScalingGroupProviderArgs{
				AutoScalingGroupArn: pulumi.String(autoScalingGroupArn2),
				ManagedScaling: &ecs.CapacityProviderManagedScalingArgs{
					Status: ecs.CapacityProviderManagedScalingStatusEnabled,
				},
				ManagedTerminationProtection: ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtectionDisabled,
			},
		})
		if err != nil {
			return err
		}
		cluster, err := ecs.NewCluster(ctx, "cluster", nil)
		if err != nil {
			return err
		}
		_, err = ecs.NewClusterCapacityProviderAssociations(ctx, "clusterCPAssociation", &ecs.ClusterCapacityProviderAssociationsArgs{
			Cluster: cluster.ID(),
			CapacityProviders: pulumi.StringArray{
				capacityProvider1.ID(),
				capacityProvider2.ID(),
			},
			DefaultCapacityProviderStrategy: ecs.ClusterCapacityProviderAssociationsCapacityProviderStrategyArray{
				&ecs.ClusterCapacityProviderAssociationsCapacityProviderStrategyArgs{
					Base:             pulumi.Int(2),
					Weight:           pulumi.Int(6),
					CapacityProvider: capacityProvider1.ID(),
				},
				&ecs.ClusterCapacityProviderAssociationsCapacityProviderStrategyArgs{
					Base:             pulumi.Int(0),
					Weight:           pulumi.Int(10),
					CapacityProvider: capacityProvider2.ID(),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy

Coming soon!

import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";

const config = new pulumi.Config();
const autoScalingGroupArn1 = config.require("autoScalingGroupArn1");
const autoScalingGroupArn2 = config.require("autoScalingGroupArn2");
const capacityProvider1 = new aws_native.ecs.CapacityProvider("capacityProvider1", {autoScalingGroupProvider: {
    autoScalingGroupArn: autoScalingGroupArn1,
    managedScaling: {
        status: aws_native.ecs.CapacityProviderManagedScalingStatus.Enabled,
    },
    managedTerminationProtection: aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Disabled,
}});
const capacityProvider2 = new aws_native.ecs.CapacityProvider("capacityProvider2", {autoScalingGroupProvider: {
    autoScalingGroupArn: autoScalingGroupArn2,
    managedScaling: {
        status: aws_native.ecs.CapacityProviderManagedScalingStatus.Enabled,
    },
    managedTerminationProtection: aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.Disabled,
}});
const cluster = new aws_native.ecs.Cluster("cluster", {});
const clusterCPAssociation = new aws_native.ecs.ClusterCapacityProviderAssociations("clusterCPAssociation", {
    cluster: cluster.id,
    capacityProviders: [
        capacityProvider1.id,
        capacityProvider2.id,
    ],
    defaultCapacityProviderStrategy: [
        {
            base: 2,
            weight: 6,
            capacityProvider: capacityProvider1.id,
        },
        {
            base: 0,
            weight: 10,
            capacityProvider: capacityProvider2.id,
        },
    ],
});
Copy
import pulumi
import pulumi_aws_native as aws_native

config = pulumi.Config()
auto_scaling_group_arn1 = config.require("autoScalingGroupArn1")
auto_scaling_group_arn2 = config.require("autoScalingGroupArn2")
capacity_provider1 = aws_native.ecs.CapacityProvider("capacityProvider1", auto_scaling_group_provider={
    "auto_scaling_group_arn": auto_scaling_group_arn1,
    "managed_scaling": {
        "status": aws_native.ecs.CapacityProviderManagedScalingStatus.ENABLED,
    },
    "managed_termination_protection": aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.DISABLED,
})
capacity_provider2 = aws_native.ecs.CapacityProvider("capacityProvider2", auto_scaling_group_provider={
    "auto_scaling_group_arn": auto_scaling_group_arn2,
    "managed_scaling": {
        "status": aws_native.ecs.CapacityProviderManagedScalingStatus.ENABLED,
    },
    "managed_termination_protection": aws_native.ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection.DISABLED,
})
cluster = aws_native.ecs.Cluster("cluster")
cluster_cpassociation = aws_native.ecs.ClusterCapacityProviderAssociations("clusterCPAssociation",
    cluster=cluster.id,
    capacity_providers=[
        capacity_provider1.id,
        capacity_provider2.id,
    ],
    default_capacity_provider_strategy=[
        {
            "base": 2,
            "weight": 6,
            "capacity_provider": capacity_provider1.id,
        },
        {
            "base": 0,
            "weight": 10,
            "capacity_provider": capacity_provider2.id,
        },
    ])
Copy

Coming soon!

Create CapacityProvider Resource

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

Constructor syntax

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

@overload
def CapacityProvider(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     auto_scaling_group_provider: Optional[CapacityProviderAutoScalingGroupProviderArgs] = None,
                     name: Optional[str] = None,
                     tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
func NewCapacityProvider(ctx *Context, name string, args *CapacityProviderArgs, opts ...ResourceOption) (*CapacityProvider, error)
public CapacityProvider(string name, CapacityProviderArgs? args = null, CustomResourceOptions? opts = null)
public CapacityProvider(String name, CapacityProviderArgs args)
public CapacityProvider(String name, CapacityProviderArgs args, CustomResourceOptions options)

type: aws-native:ecs:CapacityProvider
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

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

CapacityProvider 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 CapacityProvider resource accepts the following input properties:

AutoScalingGroupProvider Pulumi.AwsNative.Ecs.Inputs.CapacityProviderAutoScalingGroupProvider
The Auto Scaling group settings for the capacity provider.
Name string
The name of the capacity provider. If a name is specified, it cannot start with aws , ecs , or fargate . If no name is specified, a default name in the CFNStackName-CFNResourceName-RandomString format is used.
Tags List<Pulumi.AwsNative.Inputs.Tag>

The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

  • Maximum number of tags per resource - 50
  • For each resource, each tag key must be unique, and each tag key can have only one value.
  • Maximum key length - 128 Unicode characters in UTF-8
  • Maximum value length - 256 Unicode characters in UTF-8
  • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
  • Tag keys and values are case-sensitive.
  • Do not use aws: , AWS: , or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
AutoScalingGroupProvider CapacityProviderAutoScalingGroupProviderArgs
The Auto Scaling group settings for the capacity provider.
Name string
The name of the capacity provider. If a name is specified, it cannot start with aws , ecs , or fargate . If no name is specified, a default name in the CFNStackName-CFNResourceName-RandomString format is used.
Tags TagArgs

The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

  • Maximum number of tags per resource - 50
  • For each resource, each tag key must be unique, and each tag key can have only one value.
  • Maximum key length - 128 Unicode characters in UTF-8
  • Maximum value length - 256 Unicode characters in UTF-8
  • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
  • Tag keys and values are case-sensitive.
  • Do not use aws: , AWS: , or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
autoScalingGroupProvider CapacityProviderAutoScalingGroupProvider
The Auto Scaling group settings for the capacity provider.
name String
The name of the capacity provider. If a name is specified, it cannot start with aws , ecs , or fargate . If no name is specified, a default name in the CFNStackName-CFNResourceName-RandomString format is used.
tags List<Tag>

The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

  • Maximum number of tags per resource - 50
  • For each resource, each tag key must be unique, and each tag key can have only one value.
  • Maximum key length - 128 Unicode characters in UTF-8
  • Maximum value length - 256 Unicode characters in UTF-8
  • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
  • Tag keys and values are case-sensitive.
  • Do not use aws: , AWS: , or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
autoScalingGroupProvider CapacityProviderAutoScalingGroupProvider
The Auto Scaling group settings for the capacity provider.
name string
The name of the capacity provider. If a name is specified, it cannot start with aws , ecs , or fargate . If no name is specified, a default name in the CFNStackName-CFNResourceName-RandomString format is used.
tags Tag[]

The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

  • Maximum number of tags per resource - 50
  • For each resource, each tag key must be unique, and each tag key can have only one value.
  • Maximum key length - 128 Unicode characters in UTF-8
  • Maximum value length - 256 Unicode characters in UTF-8
  • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
  • Tag keys and values are case-sensitive.
  • Do not use aws: , AWS: , or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
auto_scaling_group_provider CapacityProviderAutoScalingGroupProviderArgs
The Auto Scaling group settings for the capacity provider.
name str
The name of the capacity provider. If a name is specified, it cannot start with aws , ecs , or fargate . If no name is specified, a default name in the CFNStackName-CFNResourceName-RandomString format is used.
tags Sequence[TagArgs]

The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

  • Maximum number of tags per resource - 50
  • For each resource, each tag key must be unique, and each tag key can have only one value.
  • Maximum key length - 128 Unicode characters in UTF-8
  • Maximum value length - 256 Unicode characters in UTF-8
  • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
  • Tag keys and values are case-sensitive.
  • Do not use aws: , AWS: , or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
autoScalingGroupProvider Property Map
The Auto Scaling group settings for the capacity provider.
name String
The name of the capacity provider. If a name is specified, it cannot start with aws , ecs , or fargate . If no name is specified, a default name in the CFNStackName-CFNResourceName-RandomString format is used.
tags List<Property Map>

The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

  • Maximum number of tags per resource - 50
  • For each resource, each tag key must be unique, and each tag key can have only one value.
  • Maximum key length - 128 Unicode characters in UTF-8
  • Maximum value length - 256 Unicode characters in UTF-8
  • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
  • Tag keys and values are case-sensitive.
  • Do not use aws: , AWS: , or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.

Outputs

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

Supporting Types

CapacityProviderAutoScalingGroupProvider
, CapacityProviderAutoScalingGroupProviderArgs

AutoScalingGroupArn
This property is required.
Changes to this property will trigger replacement.
string
The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
ManagedDraining Pulumi.AwsNative.Ecs.CapacityProviderAutoScalingGroupProviderManagedDraining
The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
ManagedScaling Pulumi.AwsNative.Ecs.Inputs.CapacityProviderManagedScaling
The managed scaling settings for the Auto Scaling group capacity provider.
ManagedTerminationProtection Pulumi.AwsNative.Ecs.CapacityProviderAutoScalingGroupProviderManagedTerminationProtection

The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.

When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.

When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .

When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.

AutoScalingGroupArn
This property is required.
Changes to this property will trigger replacement.
string
The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
ManagedDraining CapacityProviderAutoScalingGroupProviderManagedDraining
The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
ManagedScaling CapacityProviderManagedScaling
The managed scaling settings for the Auto Scaling group capacity provider.
ManagedTerminationProtection CapacityProviderAutoScalingGroupProviderManagedTerminationProtection

The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.

When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.

When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .

When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.

autoScalingGroupArn
This property is required.
Changes to this property will trigger replacement.
String
The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
managedDraining CapacityProviderAutoScalingGroupProviderManagedDraining
The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
managedScaling CapacityProviderManagedScaling
The managed scaling settings for the Auto Scaling group capacity provider.
managedTerminationProtection CapacityProviderAutoScalingGroupProviderManagedTerminationProtection

The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.

When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.

When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .

When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.

autoScalingGroupArn
This property is required.
Changes to this property will trigger replacement.
string
The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
managedDraining CapacityProviderAutoScalingGroupProviderManagedDraining
The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
managedScaling CapacityProviderManagedScaling
The managed scaling settings for the Auto Scaling group capacity provider.
managedTerminationProtection CapacityProviderAutoScalingGroupProviderManagedTerminationProtection

The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.

When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.

When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .

When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.

auto_scaling_group_arn
This property is required.
Changes to this property will trigger replacement.
str
The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
managed_draining CapacityProviderAutoScalingGroupProviderManagedDraining
The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
managed_scaling CapacityProviderManagedScaling
The managed scaling settings for the Auto Scaling group capacity provider.
managed_termination_protection CapacityProviderAutoScalingGroupProviderManagedTerminationProtection

The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.

When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.

When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .

When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.

autoScalingGroupArn
This property is required.
Changes to this property will trigger replacement.
String
The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
managedDraining "DISABLED" | "ENABLED"
The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
managedScaling Property Map
The managed scaling settings for the Auto Scaling group capacity provider.
managedTerminationProtection "DISABLED" | "ENABLED"

The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.

When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.

When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .

When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.

CapacityProviderAutoScalingGroupProviderManagedDraining
, CapacityProviderAutoScalingGroupProviderManagedDrainingArgs

Disabled
DISABLED
Enabled
ENABLED
CapacityProviderAutoScalingGroupProviderManagedDrainingDisabled
DISABLED
CapacityProviderAutoScalingGroupProviderManagedDrainingEnabled
ENABLED
Disabled
DISABLED
Enabled
ENABLED
Disabled
DISABLED
Enabled
ENABLED
DISABLED
DISABLED
ENABLED
ENABLED
"DISABLED"
DISABLED
"ENABLED"
ENABLED

CapacityProviderAutoScalingGroupProviderManagedTerminationProtection
, CapacityProviderAutoScalingGroupProviderManagedTerminationProtectionArgs

Disabled
DISABLED
Enabled
ENABLED
CapacityProviderAutoScalingGroupProviderManagedTerminationProtectionDisabled
DISABLED
CapacityProviderAutoScalingGroupProviderManagedTerminationProtectionEnabled
ENABLED
Disabled
DISABLED
Enabled
ENABLED
Disabled
DISABLED
Enabled
ENABLED
DISABLED
DISABLED
ENABLED
ENABLED
"DISABLED"
DISABLED
"ENABLED"
ENABLED

CapacityProviderManagedScaling
, CapacityProviderManagedScalingArgs

InstanceWarmupPeriod int
The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of 300 seconds is used.
MaximumScalingStepSize int
The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of 10000 is used.
MinimumScalingStepSize int

The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of 1 is used.

When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.

If you use a capacity provider with an Auto Scaling group configured with more than one Amazon EC2 instance type or Availability Zone, Amazon ECS will scale up by the exact minimum scaling step size value and will ignore both the maximum scaling step size as well as the capacity demand.

Status Pulumi.AwsNative.Ecs.CapacityProviderManagedScalingStatus
Determines whether to use managed scaling for the capacity provider.
TargetCapacity int
The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than 0 and less than or equal to 100 . For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use a targetCapacity of 90 . The default value of 100 percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.
InstanceWarmupPeriod int
The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of 300 seconds is used.
MaximumScalingStepSize int
The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of 10000 is used.
MinimumScalingStepSize int

The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of 1 is used.

When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.

If you use a capacity provider with an Auto Scaling group configured with more than one Amazon EC2 instance type or Availability Zone, Amazon ECS will scale up by the exact minimum scaling step size value and will ignore both the maximum scaling step size as well as the capacity demand.

Status CapacityProviderManagedScalingStatus
Determines whether to use managed scaling for the capacity provider.
TargetCapacity int
The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than 0 and less than or equal to 100 . For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use a targetCapacity of 90 . The default value of 100 percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.
instanceWarmupPeriod Integer
The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of 300 seconds is used.
maximumScalingStepSize Integer
The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of 10000 is used.
minimumScalingStepSize Integer

The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of 1 is used.

When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.

If you use a capacity provider with an Auto Scaling group configured with more than one Amazon EC2 instance type or Availability Zone, Amazon ECS will scale up by the exact minimum scaling step size value and will ignore both the maximum scaling step size as well as the capacity demand.

status CapacityProviderManagedScalingStatus
Determines whether to use managed scaling for the capacity provider.
targetCapacity Integer
The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than 0 and less than or equal to 100 . For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use a targetCapacity of 90 . The default value of 100 percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.
instanceWarmupPeriod number
The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of 300 seconds is used.
maximumScalingStepSize number
The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of 10000 is used.
minimumScalingStepSize number

The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of 1 is used.

When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.

If you use a capacity provider with an Auto Scaling group configured with more than one Amazon EC2 instance type or Availability Zone, Amazon ECS will scale up by the exact minimum scaling step size value and will ignore both the maximum scaling step size as well as the capacity demand.

status CapacityProviderManagedScalingStatus
Determines whether to use managed scaling for the capacity provider.
targetCapacity number
The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than 0 and less than or equal to 100 . For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use a targetCapacity of 90 . The default value of 100 percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.
instance_warmup_period int
The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of 300 seconds is used.
maximum_scaling_step_size int
The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of 10000 is used.
minimum_scaling_step_size int

The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of 1 is used.

When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.

If you use a capacity provider with an Auto Scaling group configured with more than one Amazon EC2 instance type or Availability Zone, Amazon ECS will scale up by the exact minimum scaling step size value and will ignore both the maximum scaling step size as well as the capacity demand.

status CapacityProviderManagedScalingStatus
Determines whether to use managed scaling for the capacity provider.
target_capacity int
The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than 0 and less than or equal to 100 . For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use a targetCapacity of 90 . The default value of 100 percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.
instanceWarmupPeriod Number
The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of 300 seconds is used.
maximumScalingStepSize Number
The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of 10000 is used.
minimumScalingStepSize Number

The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of 1 is used.

When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.

If you use a capacity provider with an Auto Scaling group configured with more than one Amazon EC2 instance type or Availability Zone, Amazon ECS will scale up by the exact minimum scaling step size value and will ignore both the maximum scaling step size as well as the capacity demand.

status "DISABLED" | "ENABLED"
Determines whether to use managed scaling for the capacity provider.
targetCapacity Number
The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than 0 and less than or equal to 100 . For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use a targetCapacity of 90 . The default value of 100 percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.

CapacityProviderManagedScalingStatus
, CapacityProviderManagedScalingStatusArgs

Disabled
DISABLED
Enabled
ENABLED
CapacityProviderManagedScalingStatusDisabled
DISABLED
CapacityProviderManagedScalingStatusEnabled
ENABLED
Disabled
DISABLED
Enabled
ENABLED
Disabled
DISABLED
Enabled
ENABLED
DISABLED
DISABLED
ENABLED
ENABLED
"DISABLED"
DISABLED
"ENABLED"
ENABLED

Tag
, TagArgs

Key This property is required. string
The key name of the tag
Value This property is required. string
The value of the tag
Key This property is required. string
The key name of the tag
Value This property is required. string
The value of the tag
key This property is required. String
The key name of the tag
value This property is required. String
The value of the tag
key This property is required. string
The key name of the tag
value This property is required. string
The value of the tag
key This property is required. str
The key name of the tag
value This property is required. str
The value of the tag
key This property is required. String
The key name of the tag
value This property is required. String
The value of the tag

Package Details

Repository
AWS Native pulumi/pulumi-aws-native
License
Apache-2.0

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi
pulumi/pulumi-aws-native