software.amazon.awscdk.services.ecs

Interface AsgCapacityProviderProps

All Superinterfaces:

AddAutoScalingGroupCapacityOptions

All Known Implementing Classes:

AsgCapacityProviderProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.52.1 (build 5ccc8f6)",
           date="2022-01-20T19:50:05.330Z")
public interface AsgCapacityProviderProps
extends AddAutoScalingGroupCapacityOptions

The options for creating an Auto Scaling Group Capacity Provider.

Example:

 Vpc vpc;
 Cluster cluster = Cluster.Builder.create(this, "Cluster")
         .vpc(vpc)
         .build();
 AutoScalingGroup autoScalingGroup = AutoScalingGroup.Builder.create(this, "ASG")
         .vpc(vpc)
         .instanceType(new InstanceType("t2.micro"))
         .machineImage(EcsOptimizedImage.amazonLinux2())
         .minCapacity(0)
         .maxCapacity(100)
         .build();
 AsgCapacityProvider capacityProvider = AsgCapacityProvider.Builder.create(this, "AsgCapacityProvider")
         .autoScalingGroup(autoScalingGroup)
         .build();
 cluster.addAsgCapacityProvider(capacityProvider);
 Ec2TaskDefinition taskDefinition = new Ec2TaskDefinition(this, "TaskDef");
 taskDefinition.addContainer("web", ContainerDefinitionOptions.builder()
         .image(ContainerImage.fromRegistry("amazon/amazon-ecs-sample"))
         .memoryReservationMiB(256)
         .build());
 Ec2Service.Builder.create(this, "EC2Service")
         .cluster(cluster)
         .taskDefinition(taskDefinition)
         .capacityProviderStrategies(List.of(CapacityProviderStrategy.builder()
                 .capacityProvider(capacityProvider.getCapacityProviderName())
                 .weight(1)
                 .build()))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	AsgCapacityProviderProps.Builder A builder for AsgCapacityProviderProps
static class	AsgCapacityProviderProps.Jsii$Proxy An implementation for AsgCapacityProviderProps

Method Summary

Modifier and Type	Method and Description
static AsgCapacityProviderProps.Builder	builder()
IAutoScalingGroup	getAutoScalingGroup() The autoscaling group to add as a Capacity Provider.
default java.lang.String	getCapacityProviderName() The name of the capacity provider.
default java.lang.Boolean	getEnableManagedScaling() Whether to enable managed scaling.
default java.lang.Boolean	getEnableManagedTerminationProtection() Whether to enable managed termination protection.
default java.lang.Number	getMaximumScalingStepSize() Maximum scaling step size.
default java.lang.Number	getMinimumScalingStepSize() Minimum scaling step size.
default java.lang.Number	getTargetCapacityPercent() Target capacity percent.

Methods inherited from interface software.amazon.awscdk.services.ecs.AddAutoScalingGroupCapacityOptions

getCanContainersAccessInstanceRole, getMachineImageType, getSpotInstanceDraining, getTaskDrainTime, getTopicEncryptionKey

Method Detail

getAutoScalingGroup

IAutoScalingGroup getAutoScalingGroup()

The autoscaling group to add as a Capacity Provider.

getCapacityProviderName

default java.lang.String getCapacityProviderName()

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.

Default: CloudFormation-generated name

getEnableManagedScaling

default java.lang.Boolean getEnableManagedScaling()

Whether to enable managed scaling.

Default: true

getEnableManagedTerminationProtection

default java.lang.Boolean getEnableManagedTerminationProtection()

Whether to enable managed termination protection.

Default: true

getMaximumScalingStepSize

default java.lang.Number getMaximumScalingStepSize()

Maximum scaling step size.

In most cases this should be left alone.

Default: 1000

getMinimumScalingStepSize

default java.lang.Number getMinimumScalingStepSize()

Minimum scaling step size.

In most cases this should be left alone.

Default: 1

getTargetCapacityPercent

default java.lang.Number getTargetCapacityPercent()

Target capacity percent.

In most cases this should be left alone.

Default: 100

builder

static AsgCapacityProviderProps.Builder builder()

Specified by:

builder in interface AddAutoScalingGroupCapacityOptions

Returns:

a AsgCapacityProviderProps.Builder of AsgCapacityProviderProps