Auto Scaling Group

An Auto Scaling Group in AWS is a resource that manages a collection of Amazon EC2 instances as a single unit. It automatically adjusts the number of instances based on defined scaling policies, health checks, and demand, ensuring applications remain available and cost-efficient. It also supports features like load balancing integration, scheduled scaling, and instance replacement for high availability.

aws.autoscaling_group

Fields

TitleIDTypeData TypeDescription
_keycorestring
account_idcorestring
auto_scaling_group_arncorestringThe Amazon Resource Name (ARN) of the Auto Scaling group.
auto_scaling_group_namecorestringThe name of the Auto Scaling group.
availability_zone_distributioncorejsonThe instance capacity distribution across Availability Zones.
availability_zone_impairment_policycorejsonThe Availability Zone impairment policy.
availability_zonescorearray<string>One or more Availability Zones for the group.
capacity_rebalancecoreboolIndicates whether Capacity Rebalancing is enabled.
capacity_reservation_specificationcorejsonThe capacity reservation specification.
contextcorestringReserved.
created_timecoretimestampThe date and time the group was created.
default_cooldowncoreint64The duration of the default cooldown period, in seconds.
default_instance_warmupcoreint64The duration of the default instance warmup, in seconds.
desired_capacitycoreint64The desired size of the group.
desired_capacity_typecorestringThe unit of measurement for the value specified for desired capacity. Amazon EC2 Auto Scaling supports DesiredCapacityType for attribute-based instance type selection only.
enabled_metricscorejsonThe metrics enabled for the group.
health_check_grace_periodcoreint64The duration of the health check grace period, in seconds.
health_check_typecorestringA comma-separated value string of one or more health check types.
instance_maintenance_policycorejsonAn instance maintenance policy.
instancescorejsonThe EC2 instances associated with the group.
launch_configuration_namecorestringThe name of the associated launch configuration.
launch_templatecorejsonThe launch template for the group.
load_balancer_namescorearray<string>One or more load balancers associated with the group.
max_instance_lifetimecoreint64The maximum amount of time, in seconds, that an instance can be in service. Valid Range: Minimum value of 0.
max_sizecoreint64The maximum size of the group.
min_sizecoreint64The minimum size of the group.
mixed_instances_policycorejsonThe mixed instances policy for the group.
new_instances_protected_from_scale_incoreboolIndicates whether newly launched instances are protected from termination by Amazon EC2 Auto Scaling when scaling in. For more information about preventing instances from terminating on scale in, see Use instance scale-in protection in the Amazon EC2 Auto Scaling User Guide.
placement_groupcorestringThe name of the placement group into which to launch your instances, if any.
predicted_capacitycoreint64The predicted capacity of the group when it has a predictive scaling policy.
service_linked_role_arncorestringThe Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling group uses to call other Amazon Web Services on your behalf.
statuscorestringThe current state of the group when the DeleteAutoScalingGroup operation is in progress.
suspended_processescorejsonThe suspended processes associated with the group.
tagscorehstore
target_group_arnscorearray<string>The Amazon Resource Names (ARN) of the target groups for your load balancer.
termination_policiescorearray<string>The termination policies for the group.
traffic_sourcescorejsonThe traffic sources associated with this Auto Scaling group.
vpc_zone_identifiercorestringOne or more subnet IDs, if applicable, separated by commas.
warm_pool_configurationcorejsonThe warm pool for the group.
warm_pool_sizecoreint64The current size of the warm pool.