Interface CfnCapacityProvider.IManagedScalingProperty
The managed scaling settings for the Auto Scaling group capacity provider.
Namespace: Amazon.CDK.AWS.ECS
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public interface CfnCapacityProvider.IManagedScalingProperty
Syntax (vb)
Public Interface CfnCapacityProvider.IManagedScalingProperty
Remarks
When managed scaling is turned on, Amazon ECS manages the scale-in and scale-out actions of the Auto Scaling group. Amazon ECS manages a target tracking scaling policy using an Amazon ECS managed CloudWatch metric with the specified targetCapacity
value as the target value for the metric. For more information, see Using managed scaling in the Amazon Elastic Container Service Developer Guide .
If managed scaling is off, the user must manage the scaling of the Auto Scaling group.
ExampleMetadata: fixture=_generated
Examples
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.ECS;
var managedScalingProperty = new ManagedScalingProperty {
InstanceWarmupPeriod = 123,
MaximumScalingStepSize = 123,
MinimumScalingStepSize = 123,
Status = "status",
TargetCapacity = 123
};
Synopsis
Properties
InstanceWarmupPeriod | The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. |
MaximumScalingStepSize | The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. |
MinimumScalingStepSize | The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. |
Status | Determines whether to use managed scaling for the capacity provider. |
TargetCapacity | The target capacity utilization as a percentage for the capacity provider. |
Properties
InstanceWarmupPeriod
The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group.
double? InstanceWarmupPeriod { get; }
Property Value
Remarks
If this parameter is omitted, the default value of 300
seconds is used.
MaximumScalingStepSize
The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time.
double? MaximumScalingStepSize { get; }
Property Value
Remarks
If this parameter is omitted, the default value of 10000
is used.
MinimumScalingStepSize
The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time.
double? MinimumScalingStepSize { get; }
Property Value
Remarks
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.
Status
Determines whether to use managed scaling for the capacity provider.
string? Status { get; }
Property Value
Remarks
TargetCapacity
The target capacity utilization as a percentage for the capacity provider.
double? TargetCapacity { get; }
Property Value
Remarks
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.