amazonka-autoscaling-1.2.0: Amazon Auto Scaling SDK.

Copyright(c) 2013-2015 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.AutoScaling.UpdateAutoScalingGroup

Contents

Description

Updates the configuration for the specified Auto Scaling group.

To update an Auto Scaling group with a launch configuration with InstanceMonitoring set to False, you must first disable the collection of group metrics. Otherwise, you will get an error. If you have previously enabled the collection of group metrics, you can disable it using DisableMetricsCollection.

The new settings are registered upon the completion of this call. Any launch configuration settings take effect on any triggers after this call returns. Scaling activities that are currently in progress aren't affected.

Note the following:

  • If you specify a new value for MinSize without specifying a value for DesiredCapacity, and the new MinSize is larger than the current size of the group, we implicitly call SetDesiredCapacity to set the size of the group to the new value of MinSize.
  • If you specify a new value for MaxSize without specifying a value for DesiredCapacity, and the new MaxSize is smaller than the current size of the group, we implicitly call SetDesiredCapacity to set the size of the group to the new value of MaxSize.
  • All other optional parameters are left unchanged if not specified.

See: AWS API Reference for UpdateAutoScalingGroup.

Synopsis

Creating a Request

Request Lenses

uasgTerminationPolicies :: Lens' UpdateAutoScalingGroup [Text] Source

A standalone termination policy or a list of termination policies used to select the instance to terminate. The policies are executed in the order that they are listed.

For more information, see Choosing a Termination Policy for Your Auto Scaling Group in the Auto Scaling Developer Guide.

uasgHealthCheckGracePeriod :: Lens' UpdateAutoScalingGroup (Maybe Int) Source

The amount of time, in seconds, that Auto Scaling waits before checking the health status of an instance. The grace period begins when the instance passes the system status and instance status checks from Amazon EC2. For more information, see .

uasgVPCZoneIdentifier :: Lens' UpdateAutoScalingGroup (Maybe Text) Source

The ID of the subnet, if you are launching into a VPC. You can specify several subnets in a comma-separated list.

When you specify VPCZoneIdentifier with AvailabilityZones, ensure that the subnets' Availability Zones match the values you specify for AvailabilityZones.

For more information, see Auto Scaling and Amazon Virtual Private Cloud in the Auto Scaling Developer Guide.

uasgDefaultCooldown :: Lens' UpdateAutoScalingGroup (Maybe Int) Source

The amount of time, in seconds, after a scaling activity completes before another scaling activity can start. For more information, see Understanding Auto Scaling Cooldowns.

uasgMaxSize :: Lens' UpdateAutoScalingGroup (Maybe Int) Source

The maximum size of the Auto Scaling group.

uasgDesiredCapacity :: Lens' UpdateAutoScalingGroup (Maybe Int) Source

The number of EC2 instances that should be running in the Auto Scaling group. This number must be greater than or equal to the minimum size of the group and less than or equal to the maximum size of the group.

uasgAvailabilityZones :: Lens' UpdateAutoScalingGroup (Maybe (NonEmpty Text)) Source

One or more Availability Zones for the group.

uasgMinSize :: Lens' UpdateAutoScalingGroup (Maybe Int) Source

The minimum size of the Auto Scaling group.

uasgHealthCheckType :: Lens' UpdateAutoScalingGroup (Maybe Text) Source

The type of health check for the instances in the Auto Scaling group. The health check type can either be EC2 for Amazon EC2 or ELB for Elastic Load Balancing.

uasgLaunchConfigurationName :: Lens' UpdateAutoScalingGroup (Maybe Text) Source

The name of the launch configuration.

uasgPlacementGroup :: Lens' UpdateAutoScalingGroup (Maybe Text) Source

The name of the placement group into which you'll launch your instances, if any. For more information, see Placement Groups.

uasgAutoScalingGroupName :: Lens' UpdateAutoScalingGroup Text Source

The name of the Auto Scaling group.

Destructuring the Response

updateAutoScalingGroupResponse :: UpdateAutoScalingGroupResponse Source

Creates a value of UpdateAutoScalingGroupResponse with the minimum fields required to make a request.