| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
UpdateAutoScalingGroup
Description
Updates the configuration for the specified AutoScalingGroup.
Note
To update an Auto Scaling group with a launch configuration
that has the InstanceMonitoring flag
set to False, you must first ensure that collection
of group metrics is disabled. Otherwise, calls to
UpdateAutoScalingGroup will fail.
If you have previously enabled group metrics collection,
you can disable collection of all group metrics
by calling 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
If a new value is specified for MinSize without specifying the value for DesiredCapacity, and if the new MinSize is larger than the current size of the Auto Scaling Group, there will be an implicit call to SetDesiredCapacity to set the group to the new MinSize.
If a new value is specified for MaxSize without specifying the value for DesiredCapacity, and the new MaxSize is smaller than the current size of the Auto Scaling Group, there will be an implicit call to SetDesiredCapacity to set the group to the new MaxSize.
All other optional parameters are left unchanged if not passed in the request.
Request Parameters
For information about the common parameters that all actions use, see Common Parameters.
- AutoScalingGroupName
The name of the Auto Scaling group.
Type: String
Length constraints: Minimum length of 1. Maximum length of 1600.
Required: Yes
- AvailabilityZones.member.N
Availability Zones for the group.
Type: String list
Length constraints: Minimum of 1 item(s) in the list.
Required: No
- DefaultCooldown
The amount of time, in seconds, after a scaling activity completes before any further scaling activities can start. For more information, see Cooldown Period.
Type: Integer
Required: No
- DesiredCapacity
The desired capacity for the Auto Scaling group.
Type: Integer
Required: No
- HealthCheckGracePeriod
The length of time that Auto Scaling waits before checking an instance's health status. The grace period begins when an instance comes into service.
Type: Integer
Required: No
- HealthCheckType
The type of health check for the instances in the Auto Scaling group. The health check type can either be
EC2for Amazon EC2 orELBfor Elastic Load Balancing.Type: String
Length constraints: Minimum length of 1. Maximum length of 32.
Required: No
- LaunchConfigurationName
The name of the launch configuration.
Type: String
Length constraints: Minimum length of 1. Maximum length of 1600.
Required: No
- MaxSize
The maximum size of the Auto Scaling group.
Type: Integer
Required: No
- MinSize
The minimum size of the Auto Scaling group.
Type: Integer
Required: No
- PlacementGroup
The name of the cluster placement group, if applicable. For more information, go to Using Cluster Instances in the Amazon EC2 User Guide.
Type: String
Length constraints: Minimum length of 1. Maximum length of 255.
Required: No
- TerminationPolicies.member.N
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 on creating a termination policy for your Auto Scaling group, go to Instance Termination Policy for Your Auto Scaling Group in the the Auto Scaling Developer Guide.
Type: String list
Required: No
- VPCZoneIdentifier
The subnet identifier for the Amazon VPC connection, if applicable. You can specify several subnets in a comma-separated list.
When you specify
VPCZoneIdentifierwithAvailabilityZones, ensure that the subnets' Availability Zones match the values you specify forAvailabilityZones.For more information on creating your Auto Scaling group in Amazon VPC by specifying subnets, see Launch Auto Scaling Instances into Amazon VPC in the the Auto Scaling Developer Guide.
Type: String
Length constraints: Minimum length of 1. Maximum length of 255.
Required: No
Errors
For information about the errors that are common to all actions, see Common Errors.
- ScalingActivityInProgress
You cannot delete an Auto Scaling group while there are scaling activities in progress for that group.
HTTP Status Code: 400
Examples
Update existing Auto Scaling group with ELB health check
Sample Request
https://autoscaling.amazonaws.com/?HealthCheckType=ELB &HealthCheckGracePeriod=300 &AutoScalingGroupName=my-test-asg-lbs &Version=2011-01-01 &Action=UpdateAutoScalingGroup &AUTHPARAMS
Sample Response
<UpdateAutoScalingGroupResponse xmlns="http://autoscaling.amazonaws.com/doc/2011-01-01/">
<ResponseMetadata>
<RequestId>adafead0-ab8a-11e2-ba13-ab0ccEXAMPLE</RequestId>
</ResponseMetadata>
</UpdateAutoScalingGroupResponse>Update existing Auto Scaling group with a new Availability Zone
Sample Request
https://autoscaling.amazonaws.com/?AutoScalingGroupName=my-test-asg-lbs &AvailabilityZones.member.1=us-east-1a &AvailabilityZones.member.2=us-east-1b &AvailabilityZones.member.3=us-east-1c &MinSize=3 &Version=2011-01-01 &Action=UpdateAutoScalingGroup &AUTHPARAMS
Sample Response
<UpdateAutoScalingGroupResponse xmlns="http://autoscaling.amazonaws.com/doc/2011-01-01/">
<ResponseMetadata>
<RequestId>adafead0-ab8a-11e2-ba13-ab0ccEXAMPLE</RequestId>
</ResponseMetadata>
</UpdateAutoScalingGroupResponse>
