software.amazon.awscdk.services.ecs

Interface AsgCapacityProviderProps

All Superinterfaces:

AddAutoScalingGroupCapacityOptions, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

AsgCapacityProviderProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.50.0 (build d1830a4)",
           date="2022-01-04T15:39:06.992Z")
 @Stability(value=Experimental)
public interface AsgCapacityProviderProps
extends software.amazon.jsii.JsiiSerializable, AddAutoScalingGroupCapacityOptions

(experimental) 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() (experimental) The autoscaling group to add as a Capacity Provider.
default String	getCapacityProviderName() (experimental) The name of the capacity provider.
default Boolean	getEnableManagedScaling() (experimental) Whether to enable managed scaling.
default Boolean	getEnableManagedTerminationProtection() (experimental) Whether to enable managed termination protection.
default Number	getMaximumScalingStepSize() (experimental) Maximum scaling step size.
default Number	getMinimumScalingStepSize() (experimental) Minimum scaling step size.
default Number	getTargetCapacityPercent() (experimental) Target capacity percent.

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

getCanContainersAccessInstanceRole, getMachineImageType, getSpotInstanceDraining, getTaskDrainTime, getTopicEncryptionKey

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getAutoScalingGroup

@Stability(value=Experimental)
 @NotNull
IAutoScalingGroup getAutoScalingGroup()

(experimental) The autoscaling group to add as a Capacity Provider.

getCapacityProviderName

@Stability(value=Experimental)
 @Nullable
default String getCapacityProviderName()

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

@Stability(value=Experimental)
 @Nullable
default Boolean getEnableManagedScaling()

(experimental) Whether to enable managed scaling.

Default: true

getEnableManagedTerminationProtection

@Stability(value=Experimental)
 @Nullable
default Boolean getEnableManagedTerminationProtection()

(experimental) Whether to enable managed termination protection.

Default: true

getMaximumScalingStepSize

@Stability(value=Experimental)
 @Nullable
default Number getMaximumScalingStepSize()

(experimental) Maximum scaling step size.

In most cases this should be left alone.

Default: 1000

getMinimumScalingStepSize

@Stability(value=Experimental)
 @Nullable
default Number getMinimumScalingStepSize()

(experimental) Minimum scaling step size.

In most cases this should be left alone.

Default: 1

getTargetCapacityPercent

@Stability(value=Experimental)
 @Nullable
default Number getTargetCapacityPercent()

(experimental) Target capacity percent.

In most cases this should be left alone.

Default: 100

builder

@Stability(value=Experimental)
static AsgCapacityProviderProps.Builder builder()

Specified by:

builder in interface AddAutoScalingGroupCapacityOptions

Returns:

a AsgCapacityProviderProps.Builder of AsgCapacityProviderProps