Required 1

Set these to use the module.

• namestring, no defaultName used across the resources created

Set by controls 1

Active controls fix these values.

• network_interfaceslist({...}), set to nullCustomize network interfaces to be attached at instance boot time

Optional 94

• autoscaling_group_tagsmap(string), default {}A map of additional tags to add to the autoscaling group
• autoscaling_group_tags_not_propagate_at_launchlist(string), default []A list of tag keys that should NOT be propagated to launched EC2 instances
• availability_zone_distributionobject({...}), default nullA map of configuration for capacity distribution across availability zones
• availability_zoneslist(string), default nullA list of Availability Zones where instances in the Auto Scaling group can be created. Used for launching into the default VPC subnet in each Availability Zone when not using the vpc_zone_identifier attribute, or for attaching a network interface when an existing network interface ID is specified in a launch template. Conflicts with vpc_zone_identifier
• block_device_mappingslist({...}), default nullSpecify volumes to attach to the instance besides the volumes specified by the AMI
• capacity_rebalancebool, default nullIndicates whether capacity rebalance is enabled
• capacity_reservation_specificationobject({...}), default nullTargeting for EC2 capacity reservations
• contextstring, default nullReserved
• cpu_optionsobject({...}), default nullThe CPU options for the instance
• createbool, default trueDetermines whether to create autoscaling group or not
• create_iam_instance_profilebool, default falseDetermines whether an IAM instance profile is created or to use an existing IAM instance profile
• create_launch_templatebool, default trueDetermines whether to create launch template or not
• credit_specificationobject({...}), default nullCustomize the credit specification of the instance
• default_cooldownnumber, default nullThe amount of time, in seconds, after a scaling activity completes before another scaling activity can start
• default_instance_warmupnumber, default nullAmount of time, in seconds, until a newly launched instance can contribute to the Amazon CloudWatch metrics. This delay lets an instance finish initializing before Amazon EC2 Auto Scaling aggregates instance metrics, resulting in more reliable usage data. Set this value equal to the amount of time that it takes for resource consumption to become stable after an instance reaches the InService state.
• default_versionstring, default nullDefault Version of the launch template
• desired_capacitynumber, default nullThe number of Amazon EC2 instances that should be running in the autoscaling group
• desired_capacity_typestring, default nullThe unit of measurement for the value specified for desired_capacity. Supported for attribute-based instance type selection only. Valid values: units, vcpu, memory-mib.
• disable_api_stopbool, default nullIf true, enables EC2 instance stop protection
• disable_api_terminationbool, default nullIf true, enables EC2 instance termination protection
• ebs_optimizedbool, default nullIf true, the launched EC2 instance will be EBS-optimized
• enable_monitoringbool, default trueEnables/disables detailed monitoring
• enabled_metricslist(string), default []A list of metrics to collect. The allowed values are GroupDesiredCapacity, GroupInServiceCapacity, GroupPendingCapacity, GroupMinSize, GroupMaxSize, GroupInServiceInstances, GroupPendingInstances, GroupStandbyInstances, GroupStandbyCapacity, GroupTerminatingCapacity, GroupTerminatingInstances, GroupTotalCapacity, GroupTotalInstances
• enclave_optionsobject({...}), default nullEnable Nitro Enclaves on launched instances
• force_deletebool, default nullAllows deleting the Auto Scaling Group without waiting for all instances in the pool to terminate. You can force an Auto Scaling Group to delete even if it's in the process of scaling a resource. Normally, Terraform drains all the instances before deleting the group. This bypasses that behavior and potentially leaves resources dangling
• force_delete_warm_poolbool, default nullAllows deleting the Auto Scaling Group without waiting for all instances in the warm pool to terminate
• health_check_grace_periodnumber, default nullTime (in seconds) after instance comes into service before checking health
• health_check_typestring, default nullEC2 or ELB. Controls how health checking is done
• hibernation_optionsobject({...}), default nullThe hibernation options for the instance
• iam_instance_profile_arnstring, default nullAmazon Resource Name (ARN) of an existing IAM instance profile. Used when create_iam_instance_profile = false
• iam_instance_profile_namestring, default nullThe name of the IAM instance profile to be created (create_iam_instance_profile = true) or existing (create_iam_instance_profile = false)
• iam_role_descriptionstring, default nullDescription of the role
• iam_role_namestring, default nullName to use on IAM role created
• iam_role_pathstring, default nullIAM role path
• iam_role_permissions_boundarystring, default nullARN of the policy that is used to set the permissions boundary for the IAM role
• iam_role_policiesmap(string), default {}IAM policies to attach to the IAM role
• iam_role_tagsmap(string), default {}A map of additional tags to add to the IAM role created
• iam_role_use_name_prefixbool, default trueDetermines whether the IAM role name (iam_role_name) is used as a prefix
• ignore_desired_capacity_changesbool, default falseDetermines whether the desired_capacity value is ignored after initial apply. See README note for more details
• ignore_failed_scaling_activitiesbool, default falseWhether to ignore failed Auto Scaling scaling activities while waiting for capacity. The default is false -- failed scaling activities cause errors to be returned.
• image_idstring, default nullThe AMI from which to launch the instance
• initial_lifecycle_hookslist({...}), default nullOne or more Lifecycle Hooks to attach to the Auto Scaling Group before instances are launched. The syntax is exactly the same as the separate aws_autoscaling_lifecycle_hook resource, without the autoscaling_group_name attribute. Please note that this will only work when creating a new Auto Scaling Group. For all other use-cases, please use aws_autoscaling_lifecycle_hook resource
• instance_initiated_shutdown_behaviorstring, default nullShutdown behavior for the instance. Can be stop or terminate. (Default: stop)
• instance_lifecycle_policyobject({...}), default nullIf this block is configured, adds an instance lifecycle policy to the specified Auto Scaling Group
• instance_maintenance_policyobject({...}), default nullIf this block is configured, add a instance maintenance policy to the specified Auto Scaling group
• instance_market_optionsobject({...}), default nullThe market (purchasing) option for the instance
• instance_namestring, default ""Name that is propogated to launched EC2 instances via a tag - if not provided, defaults to var.name
• instance_refreshobject({...}), default nullIf this block is configured, start an Instance Refresh when this Auto Scaling Group is updated
• instance_requirementsobject({...}), default nullThe attribute requirements for the type of instance. If present then instance_type cannot be present
• instance_typestring, default nullThe type of the instance. If present then instance_requirements cannot be present
• kernel_idstring, default nullThe kernel ID
• key_namestring, default nullThe key name that should be used for the instance
• launch_template_descriptionstring, default nullDescription of the launch template
• launch_template_idstring, default nullID of an existing launch template to be used (created outside of this module)
• launch_template_namestring, default ""Name of launch template to be created
• launch_template_tagsmap(string), default {}A map of additional tags to add to the launch template
• launch_template_use_name_prefixbool, default trueDetermines whether to use launch_template_name as is or create a unique name beginning with the launch_template_name as the prefix
• launch_template_versionstring, default nullLaunch template version. Can be version number, $Latest, or $Default
• license_specificationslist({...}), default nullA list of license specifications to associate with
• maintenance_optionsobject({...}), default nullThe maintenance options for the instance
• max_instance_lifetimenumber, default nullThe maximum amount of time, in seconds, that an instance can be in service, values must be either equal to 0 or between 86400 and 31536000 seconds
• max_sizenumber, default nullThe maximum size of the autoscaling group
• metadata_optionsobject({...}), default {...}Customize the metadata options for the instance
• metrics_granularitystring, default nullThe granularity to associate with the metrics to collect. The only valid value is 1Minute
• min_elb_capacitynumber, default nullSetting this causes Terraform to wait for this number of instances to show up healthy in the ELB only on creation. Updates will not wait on ELB instance number changes
• min_sizenumber, default nullThe minimum size of the autoscaling group
• mixed_instances_policyobject({...}), default nullConfiguration block containing settings to define launch targets for Auto Scaling groups
• network_performance_optionsobject({...}), default nullThe network performance options for the launch template
• placementobject({...}), default nullThe placement of the instance
• placement_groupstring, default nullThe name of the placement group into which you'll launch your instances, if any
• private_dns_name_optionsobject({...}), default nullThe options for the instance hostname. The default values are inherited from the subnet
• protect_from_scale_inbool, default falseAllows setting instance protection. The autoscaling group will not select instances with this setting for termination during scale in events.
• putin_khuylobool, default trueDo you agree that Putin doesn't respect Ukrainian sovereignty and territorial integrity? More info: https://en.wikipedia.org/wiki/Putin_khuylo!
• ram_disk_idstring, default nullThe ID of the ram disk
• regionstring, default nullRegion where the resource(s) will be managed. Defaults to the Region set in the provider configuration
• scaling_policiesmap({...}), default nullMap of target scaling policy schedule to create
• schedulesmap({...}), default nullMap of autoscaling group schedule to create
• secondary_interfaceslist({...}), default nullSecondary interfaces to associate with instances launched from the template
• security_groupslist(string), default []A list of security group IDs to associate
• service_linked_role_arnstring, default nullThe ARN of the service-linked role that the ASG will use to call other AWS services
• suspended_processeslist(string), default []A list of processes to suspend for the Auto Scaling Group. The allowed values are Launch, Terminate, HealthCheck, ReplaceUnhealthy, AZRebalance, AlarmNotification, ScheduledActions, AddToLoadBalancer, InstanceRefresh. Note that if you suspend either the Launch or Terminate process types, it can prevent your Auto Scaling Group from functioning properly
• tag_specificationslist({...}), default nullThe tags to apply to the resources during launch
• tagsmap(string), default {}A map of tags to assign to resources
• termination_policieslist(string), default []A list of policies to decide how the instances in the Auto Scaling Group should be terminated. The allowed values are OldestInstance, NewestInstance, OldestLaunchConfiguration, ClosestToNextInstanceHour, OldestLaunchTemplate, AllocationStrategy, Default
• timeoutsobject({...}), default nullTimeout configurations for the autoscaling group
• traffic_source_attachmentsmap({...}), default nullMap of traffic source attachment definitions to create
• update_default_versionbool, default nullWhether to update Default Version each update. Conflicts with default_version
• use_mixed_instances_policybool, default falseDetermines whether to use a mixed instances policy in the autoscaling group or not
• use_name_prefixbool, default trueDetermines whether to use name as is or create a unique name beginning with the name as the prefix
• user_datastring, default nullThe Base64-encoded user data to provide when launching the instance
• vpc_zone_identifierlist(string), default nullA list of subnet IDs to launch resources in. Subnets automatically determine which availability zones the group will reside. Conflicts with availability_zones
• wait_for_capacity_timeoutstring, default nullA maximum duration that Terraform should wait for ASG instances to be healthy before timing out. (See also Waiting for Capacity below.) Setting this to '0' causes Terraform to skip all Capacity Waiting behavior.
• wait_for_elb_capacitynumber, default nullSetting this will cause Terraform to wait for exactly this number of healthy instances in all attached load balancers on both create and update operations. Takes precedence over min_elb_capacity behavior.
• warm_poolobject({...}), default nullIf this block is configured, add a Warm Pool to the specified Auto Scaling group