aws-sdk-autoscaling 1.25.0 → 1.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: bdda0d737d9e7be86ce2650f76c189e7324601e6
4
- data.tar.gz: bbdbb1e16b2957b0ddeacef0e1087eac65f7569f
3
+ metadata.gz: ccc520ae4018308005cffefafa188bb3fade7524
4
+ data.tar.gz: 8de1a64544fb540f6d067e921241daba4806a486
5
5
  SHA512:
6
- metadata.gz: a250f5c5ee4ff5aaf4a761b625f57e2fa137cc51cb5f7228aef3e81217daa330d95c9e1bb9fee3723045e6e4c26c6190009a8218a44de231aaa26f807d26d2fc
7
- data.tar.gz: 0dcef7fdc3010719fe3cfe5e19a116b4392d2b2ebbf8e50fbbe645a4fcb4cfbb1ee3a3f2ce1f4529cabbf05b7d07b76035c528e313549b8df157c1acad84091c
6
+ metadata.gz: 44345e6d3978220d2b7d9d5eaf6c83af1a7e82c7c347c0893019878fdfdc418800a7fb7a0d44dc776755e53bf5892ceb06645d8ac0f1d185bb52243ee6ae41ef
7
+ data.tar.gz: 16e96647bbe2e7e82b4ce1b1023aed405e84ec3da65071c1f25ae9b37bcc232b39bdec8bc1201314166a0ee608ad3d4d01d2ffdb505d760d49305560db37df5f
@@ -53,6 +53,6 @@ require_relative 'aws-sdk-autoscaling/customizations'
53
53
  # @service
54
54
  module Aws::AutoScaling
55
55
 
56
- GEM_VERSION = '1.25.0'
56
+ GEM_VERSION = '1.26.0'
57
57
 
58
58
  end
@@ -643,8 +643,9 @@ module Aws::AutoScaling
643
643
  # @option options [Time,DateTime,Date,Integer,String] :time
644
644
  # This parameter is deprecated.
645
645
  # @option options [Time,DateTime,Date,Integer,String] :start_time
646
- # The time for this action to start, in YYYY-MM-DDThh:mm:ssZ format in
647
- # UTC/GMT only and in quotes (for example, `"2019-06-01T00:00:00Z"`).
646
+ # The date and time for this action to start, in YYYY-MM-DDThh:mm:ssZ
647
+ # format in UTC/GMT only and in quotes (for example,
648
+ # `"2019-06-01T00:00:00Z"`).
648
649
  #
649
650
  # If you specify `Recurrence` and `StartTime`, Amazon EC2 Auto Scaling
650
651
  # performs the action at this time, and then performs the action based
@@ -653,8 +654,8 @@ module Aws::AutoScaling
653
654
  # If you try to schedule your action in the past, Amazon EC2 Auto
654
655
  # Scaling returns an error message.
655
656
  # @option options [Time,DateTime,Date,Integer,String] :end_time
656
- # The time for the recurring schedule to end. Amazon EC2 Auto Scaling
657
- # does not perform the action after this time.
657
+ # The date and time for the recurring schedule to end. Amazon EC2 Auto
658
+ # Scaling does not perform the action after this time.
658
659
  # @option options [String] :recurrence
659
660
  # The recurring schedule for this action, in Unix cron syntax format.
660
661
  # This format consists of five fields separated by white spaces:
@@ -662,15 +663,19 @@ module Aws::AutoScaling
662
663
  # \[Day\_of\_Week\]. The value must be in quotes (for example, `"30 0 1
663
664
  # 1,6,12 *"`). For more information about this format, see [Crontab][1].
664
665
  #
666
+ # When `StartTime` and `EndTime` are specified with `Recurrence`, they
667
+ # form the boundaries of when the recurring action starts and stops.
668
+ #
665
669
  #
666
670
  #
667
671
  # [1]: http://crontab.org
668
672
  # @option options [Integer] :min_size
669
- # The minimum size for the Auto Scaling group.
673
+ # The minimum number of instances in the Auto Scaling group.
670
674
  # @option options [Integer] :max_size
671
- # The maximum size for the Auto Scaling group.
675
+ # The maximum number of instances in the Auto Scaling group.
672
676
  # @option options [Integer] :desired_capacity
673
- # The number of EC2 instances that should be running in the group.
677
+ # The number of EC2 instances that should be running in the Auto Scaling
678
+ # group.
674
679
  # @return [ScheduledAction]
675
680
  def put_scheduled_update_group_action(options = {})
676
681
  options = options.merge(auto_scaling_group_name: @name)
@@ -814,16 +819,27 @@ module Aws::AutoScaling
814
819
  # })
815
820
  # @param [Hash] options ({})
816
821
  # @option options [String] :launch_configuration_name
817
- # The name of the launch configuration. If you specify this parameter,
818
- # you can't specify a launch template or a mixed instances policy.
822
+ # The name of the launch configuration. If you specify
823
+ # `LaunchConfigurationName` in your update request, you can't specify
824
+ # `LaunchTemplate` or `MixedInstancesPolicy`.
825
+ #
826
+ # <note markdown="1"> To update an Auto Scaling group with a launch configuration with
827
+ # `InstanceMonitoring` set to `false`, you must first disable the
828
+ # collection of group metrics. Otherwise, you get an error. If you have
829
+ # previously enabled the collection of group metrics, you can disable it
830
+ # using DisableMetricsCollection.
831
+ #
832
+ # </note>
819
833
  # @option options [Types::LaunchTemplateSpecification] :launch_template
820
834
  # The launch template and version to use to specify the updates. If you
821
- # specify this parameter, you can't specify a launch configuration or a
822
- # mixed instances policy.
835
+ # specify `LaunchTemplate` in your update request, you can't specify
836
+ # `LaunchConfigurationName` or `MixedInstancesPolicy`.
823
837
  # @option options [Types::MixedInstancesPolicy] :mixed_instances_policy
824
- # The mixed instances policy to use to specify the updates. If you
825
- # specify this parameter, you can't specify a launch configuration or a
826
- # launch template.
838
+ # An embedded object that specifies a mixed instances policy.
839
+ #
840
+ # In your call to `UpdateAutoScalingGroup`, you can make changes to the
841
+ # policy that is specified. All optional parameters are left unchanged
842
+ # if not specified.
827
843
  #
828
844
  # For more information, see [Auto Scaling Groups with Multiple Instance
829
845
  # Types and Purchase Options][1] in the *Amazon EC2 Auto Scaling User
@@ -843,9 +859,13 @@ module Aws::AutoScaling
843
859
  # @option options [Integer] :default_cooldown
844
860
  # The amount of time, in seconds, after a scaling activity completes
845
861
  # before another scaling activity can start. The default value is `300`.
862
+ # This cooldown period is not used when a scaling-specific cooldown is
863
+ # specified.
846
864
  #
847
- # For more information, see [Scaling Cooldowns][1] in the *Amazon EC2
848
- # Auto Scaling User Guide*.
865
+ # Cooldown periods are not supported for target tracking scaling
866
+ # policies, step scaling policies, or scheduled scaling. For more
867
+ # information, see [Scaling Cooldowns][1] in the *Amazon EC2 Auto
868
+ # Scaling User Guide*.
849
869
  #
850
870
  #
851
871
  #
@@ -882,7 +902,7 @@ module Aws::AutoScaling
882
902
  #
883
903
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html
884
904
  # @option options [String] :vpc_zone_identifier
885
- # A comma-separated list of subnet IDs, if you are launching into a VPC.
905
+ # A comma-separated list of subnet IDs for virtual private cloud (VPC).
886
906
  #
887
907
  # If you specify `VPCZoneIdentifier` with `AvailabilityZones`, the
888
908
  # subnets that you specify for this parameter must reside in those
@@ -600,50 +600,64 @@ module Aws::AutoScaling
600
600
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html
601
601
  #
602
602
  # @option params [required, String] :auto_scaling_group_name
603
- # The name of the Auto Scaling group. This name must be unique within
604
- # the scope of your AWS account.
603
+ # The name of the Auto Scaling group. This name must be unique per
604
+ # Region per account.
605
605
  #
606
606
  # @option params [String] :launch_configuration_name
607
- # The name of the launch configuration. This parameter, a launch
608
- # template, a mixed instances policy, or an EC2 instance must be
609
- # specified.
607
+ # The name of the launch configuration.
610
608
  #
611
609
  # For more information, see [Creating an Auto Scaling Group Using a
612
610
  # Launch Configuration][1] in the *Amazon EC2 Auto Scaling User Guide*.
613
611
  #
612
+ # If you do not specify `LaunchConfigurationName`, you must specify one
613
+ # of the following parameters: `InstanceId`, `LaunchTemplate`, or
614
+ # `MixedInstancesPolicy`.
615
+ #
614
616
  #
615
617
  #
616
618
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg.html
617
619
  #
618
620
  # @option params [Types::LaunchTemplateSpecification] :launch_template
619
- # The launch template to use to launch instances. This parameter, a
620
- # launch configuration, a mixed instances policy, or an EC2 instance
621
- # must be specified.
621
+ # The launch template to use to launch instances.
622
622
  #
623
623
  # For more information, see [Creating an Auto Scaling Group Using a
624
624
  # Launch Template][1] in the *Amazon EC2 Auto Scaling User Guide*.
625
625
  #
626
+ # If you do not specify `LaunchTemplate`, you must specify one of the
627
+ # following parameters: `InstanceId`, `LaunchConfigurationName`, or
628
+ # `MixedInstancesPolicy`.
629
+ #
626
630
  #
627
631
  #
628
632
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-launch-template.html
629
633
  #
630
634
  # @option params [Types::MixedInstancesPolicy] :mixed_instances_policy
631
- # The mixed instances policy to use to launch instances. This parameter,
632
- # a launch template, a launch configuration, or an EC2 instance must be
633
- # specified.
635
+ # An embedded object that specifies a mixed instances policy. The
636
+ # required parameters must be specified. If optional parameters are
637
+ # unspecified, their default values are used.
638
+ #
639
+ # The policy includes parameters that not only define the distribution
640
+ # of On-Demand Instances and Spot Instances, the maximum price to pay
641
+ # for Spot instances, and how the Auto Scaling group allocates instance
642
+ # types to fulfill On-Demand and Spot capacity, but also the parameters
643
+ # that specify the instance configuration information—the launch
644
+ # template and instance types.
634
645
  #
635
646
  # For more information, see [Auto Scaling Groups with Multiple Instance
636
647
  # Types and Purchase Options][1] in the *Amazon EC2 Auto Scaling User
637
648
  # Guide*.
638
649
  #
650
+ # You must specify one of the following parameters in your request:
651
+ # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
652
+ # `MixedInstancesPolicy`.
653
+ #
639
654
  #
640
655
  #
641
656
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html
642
657
  #
643
658
  # @option params [String] :instance_id
644
659
  # The ID of the instance used to create a launch configuration for the
645
- # group. This parameter, a launch configuration, a launch template, or a
646
- # mixed instances policy must be specified.
660
+ # group.
647
661
  #
648
662
  # When you specify an ID of an instance, Amazon EC2 Auto Scaling creates
649
663
  # a new launch configuration and associates it with the group. This
@@ -653,6 +667,10 @@ module Aws::AutoScaling
653
667
  # For more information, see [Create an Auto Scaling Group Using an EC2
654
668
  # Instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
655
669
  #
670
+ # You must specify one of the following parameters in your request:
671
+ # `LaunchConfigurationName`, `LaunchTemplate`, `InstanceId`, or
672
+ # `MixedInstancesPolicy`.
673
+ #
656
674
  #
657
675
  #
658
676
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-from-instance.html
@@ -664,11 +682,11 @@ module Aws::AutoScaling
664
682
  # The maximum size of the group.
665
683
  #
666
684
  # @option params [Integer] :desired_capacity
667
- # The number of EC2 instances that should be running in the group. This
668
- # number must be greater than or equal to the minimum size of the group
669
- # and less than or equal to the maximum size of the group. If you do not
670
- # specify a desired capacity, the default is the minimum size of the
671
- # group.
685
+ # The number of Amazon EC2 instances that the Auto Scaling group
686
+ # attempts to maintain. This number must be greater than or equal to the
687
+ # minimum size of the group and less than or equal to the maximum size
688
+ # of the group. If you do not specify a desired capacity, the default is
689
+ # the minimum size of the group.
672
690
  #
673
691
  # @option params [Integer] :default_cooldown
674
692
  # The amount of time, in seconds, after a scaling activity completes
@@ -689,10 +707,12 @@ module Aws::AutoScaling
689
707
  # parameter is required to launch instances into EC2-Classic.
690
708
  #
691
709
  # @option params [Array<String>] :load_balancer_names
692
- # One or more Classic Load Balancers. To specify an Application Load
693
- # Balancer or a Network Load Balancer, use `TargetGroupARNs` instead.
710
+ # A list of Classic Load Balancers associated with this Auto Scaling
711
+ # group. For Application Load Balancers and Network Load Balancers,
712
+ # specify a list of target groups using the `TargetGroupARNs` property
713
+ # instead.
694
714
  #
695
- # For more information, see [Using a Load Balancer With an Auto Scaling
715
+ # For more information, see [Using a Load Balancer with an Auto Scaling
696
716
  # Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
697
717
  #
698
718
  #
@@ -700,7 +720,16 @@ module Aws::AutoScaling
700
720
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
701
721
  #
702
722
  # @option params [Array<String>] :target_group_arns
703
- # The Amazon Resource Names (ARN) of the target groups.
723
+ # The Amazon Resource Names (ARN) of the target groups to associate with
724
+ # the Auto Scaling group. Instances are registered as targets in a
725
+ # target group, and traffic is routed to the target group.
726
+ #
727
+ # For more information, see [Using a Load Balancer with an Auto Scaling
728
+ # Group][1] in the *Amazon EC2 Auto Scaling User Guide*.
729
+ #
730
+ #
731
+ #
732
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
704
733
  #
705
734
  # @option params [String] :health_check_type
706
735
  # The service to use for the health checks. The valid values are `EC2`
@@ -950,8 +979,8 @@ module Aws::AutoScaling
950
979
  # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchConfiguration.html
951
980
  #
952
981
  # @option params [required, String] :launch_configuration_name
953
- # The name of the launch configuration. This name must be unique within
954
- # the scope of your AWS account.
982
+ # The name of the launch configuration. This name must be unique per
983
+ # Region per account.
955
984
  #
956
985
  # @option params [String] :image_id
957
986
  # The ID of the Amazon Machine Image (AMI) to use to launch your EC2
@@ -1032,9 +1061,6 @@ module Aws::AutoScaling
1032
1061
  # new launch configuration derives attributes from the instance, except
1033
1062
  # for the block device mapping.
1034
1063
  #
1035
- # If you do not specify `InstanceId`, you must specify both `ImageId`
1036
- # and `InstanceType`.
1037
- #
1038
1064
  # To create a launch configuration with a block device mapping or
1039
1065
  # override any other instance attributes, specify them as part of the
1040
1066
  # same request.
@@ -1042,6 +1068,9 @@ module Aws::AutoScaling
1042
1068
  # For more information, see [Create a Launch Configuration Using an EC2
1043
1069
  # Instance][1] in the *Amazon EC2 Auto Scaling User Guide*.
1044
1070
  #
1071
+ # If you do not specify `InstanceId`, you must specify both `ImageId`
1072
+ # and `InstanceType`.
1073
+ #
1045
1074
  #
1046
1075
  #
1047
1076
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-lc-with-instanceID.html
@@ -1049,11 +1078,11 @@ module Aws::AutoScaling
1049
1078
  # @option params [String] :instance_type
1050
1079
  # The instance type of the EC2 instance.
1051
1080
  #
1052
- # If you do not specify `InstanceId`, you must specify `InstanceType`.
1053
- #
1054
1081
  # For information about available instance types, see [Available
1055
1082
  # Instance Types][1] in the *Amazon EC2 User Guide for Linux Instances.*
1056
1083
  #
1084
+ # If you do not specify `InstanceId`, you must specify `InstanceType`.
1085
+ #
1057
1086
  #
1058
1087
  #
1059
1088
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes
@@ -1096,8 +1125,8 @@ module Aws::AutoScaling
1096
1125
  # security credentials available. You can use IAM roles with Amazon EC2
1097
1126
  # Auto Scaling to automatically enable applications running on your EC2
1098
1127
  # instances to securely access other AWS resources. For more
1099
- # information, see [Use an IAM Role for Applications That Run on Amazon
1100
- # EC2 Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1128
+ # information, see [IAM Role for Applications That Run on Amazon EC2
1129
+ # Instances][1] in the *Amazon EC2 Auto Scaling User Guide*.
1101
1130
  #
1102
1131
  #
1103
1132
  #
@@ -1142,17 +1171,17 @@ module Aws::AutoScaling
1142
1171
  # the instance placement tenancy attribute set to `default`), you must
1143
1172
  # set the value of this parameter to `dedicated`.
1144
1173
  #
1145
- # If you specify this parameter, be sure to specify at least one subnet
1146
- # when you create your group.
1174
+ # If you specify `PlacementTenancy`, be sure to specify at least one
1175
+ # subnet when you create your group.
1147
1176
  #
1148
- # For more information, see [Launching Auto Scaling Instances in a
1149
- # VPC][1] in the *Amazon EC2 Auto Scaling User Guide*.
1177
+ # For more information, see [Instance Placement Tenancy][1] in the
1178
+ # *Amazon EC2 Auto Scaling User Guide*.
1150
1179
  #
1151
1180
  # Valid values: `default` \| `dedicated`
1152
1181
  #
1153
1182
  #
1154
1183
  #
1155
- # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html
1184
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html#as-vpc-tenancy
1156
1185
  #
1157
1186
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1158
1187
  #
@@ -1461,8 +1490,16 @@ module Aws::AutoScaling
1461
1490
 
1462
1491
  # Deletes the specified scaling policy.
1463
1492
  #
1464
- # Deleting a policy deletes the underlying alarm action, but does not
1465
- # delete the alarm, even if it no longer has an associated action.
1493
+ # Deleting either a step scaling policy or a simple scaling policy
1494
+ # deletes the underlying alarm action, but does not delete the alarm,
1495
+ # even if it no longer has an associated action.
1496
+ #
1497
+ # For more information, see [Deleting a Scaling Policy][1] in the
1498
+ # *Amazon EC2 Auto Scaling User Guide*.
1499
+ #
1500
+ #
1501
+ #
1502
+ # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/deleting-scaling-policy.html
1466
1503
  #
1467
1504
  # @option params [String] :auto_scaling_group_name
1468
1505
  # The name of the Auto Scaling group.
@@ -2692,8 +2729,8 @@ module Aws::AutoScaling
2692
2729
  end
2693
2730
 
2694
2731
  # Describes the actions scheduled for your Auto Scaling group that
2695
- # haven't run. To describe the actions that have already run, use
2696
- # DescribeScalingActivities.
2732
+ # haven't run or that have not reached their end time. To describe the
2733
+ # actions that have already run, use DescribeScalingActivities.
2697
2734
  #
2698
2735
  # @option params [String] :auto_scaling_group_name
2699
2736
  # The name of the Auto Scaling group.
@@ -3328,7 +3365,8 @@ module Aws::AutoScaling
3328
3365
  # Indicates whether Amazon EC2 Auto Scaling waits for the cooldown
3329
3366
  # period to complete before executing the policy.
3330
3367
  #
3331
- # This parameter is not supported if the policy type is `StepScaling`.
3368
+ # This parameter is not supported if the policy type is `StepScaling` or
3369
+ # `TargetTrackingScaling`.
3332
3370
  #
3333
3371
  # For more information, see [Scaling Cooldowns][1] in the *Amazon EC2
3334
3372
  # Auto Scaling User Guide*.
@@ -3860,8 +3898,9 @@ module Aws::AutoScaling
3860
3898
  # This parameter is deprecated.
3861
3899
  #
3862
3900
  # @option params [Time,DateTime,Date,Integer,String] :start_time
3863
- # The time for this action to start, in YYYY-MM-DDThh:mm:ssZ format in
3864
- # UTC/GMT only and in quotes (for example, `"2019-06-01T00:00:00Z"`).
3901
+ # The date and time for this action to start, in YYYY-MM-DDThh:mm:ssZ
3902
+ # format in UTC/GMT only and in quotes (for example,
3903
+ # `"2019-06-01T00:00:00Z"`).
3865
3904
  #
3866
3905
  # If you specify `Recurrence` and `StartTime`, Amazon EC2 Auto Scaling
3867
3906
  # performs the action at this time, and then performs the action based
@@ -3871,8 +3910,8 @@ module Aws::AutoScaling
3871
3910
  # Scaling returns an error message.
3872
3911
  #
3873
3912
  # @option params [Time,DateTime,Date,Integer,String] :end_time
3874
- # The time for the recurring schedule to end. Amazon EC2 Auto Scaling
3875
- # does not perform the action after this time.
3913
+ # The date and time for the recurring schedule to end. Amazon EC2 Auto
3914
+ # Scaling does not perform the action after this time.
3876
3915
  #
3877
3916
  # @option params [String] :recurrence
3878
3917
  # The recurring schedule for this action, in Unix cron syntax format.
@@ -3881,18 +3920,22 @@ module Aws::AutoScaling
3881
3920
  # \[Day\_of\_Week\]. The value must be in quotes (for example, `"30 0 1
3882
3921
  # 1,6,12 *"`). For more information about this format, see [Crontab][1].
3883
3922
  #
3923
+ # When `StartTime` and `EndTime` are specified with `Recurrence`, they
3924
+ # form the boundaries of when the recurring action starts and stops.
3925
+ #
3884
3926
  #
3885
3927
  #
3886
3928
  # [1]: http://crontab.org
3887
3929
  #
3888
3930
  # @option params [Integer] :min_size
3889
- # The minimum size for the Auto Scaling group.
3931
+ # The minimum number of instances in the Auto Scaling group.
3890
3932
  #
3891
3933
  # @option params [Integer] :max_size
3892
- # The maximum size for the Auto Scaling group.
3934
+ # The maximum number of instances in the Auto Scaling group.
3893
3935
  #
3894
3936
  # @option params [Integer] :desired_capacity
3895
- # The number of EC2 instances that should be running in the group.
3937
+ # The number of EC2 instances that should be running in the Auto Scaling
3938
+ # group.
3896
3939
  #
3897
3940
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3898
3941
  #
@@ -4375,46 +4418,76 @@ module Aws::AutoScaling
4375
4418
 
4376
4419
  # Updates the configuration for the specified Auto Scaling group.
4377
4420
  #
4378
- # The new settings take effect on any scaling activities after this call
4379
- # returns. Scaling activities that are currently in progress aren't
4380
- # affected.
4381
- #
4382
- # To update an Auto Scaling group with a launch configuration with
4383
- # `InstanceMonitoring` set to `false`, you must first disable the
4384
- # collection of group metrics. Otherwise, you get an error. If you have
4385
- # previously enabled the collection of group metrics, you can disable it
4386
- # using DisableMetricsCollection.
4387
- #
4388
- # Note the following:
4421
+ # To update an Auto Scaling group, specify the name of the group and the
4422
+ # parameter that you want to change. Any parameters that you don't
4423
+ # specify are not changed by this update request. The new settings take
4424
+ # effect on any scaling activities after this call returns. Scaling
4425
+ # activities that are currently in progress aren't affected.
4426
+ #
4427
+ # If you associate a new launch configuration or template with an Auto
4428
+ # Scaling group, all new instances will get the updated configuration,
4429
+ # but existing instances continue to run with the configuration that
4430
+ # they were originally launched with. When you update a group to specify
4431
+ # a mixed instances policy instead of a launch configuration or
4432
+ # template, existing instances may be replaced to match the new
4433
+ # purchasing options that you specified in the policy. For example, if
4434
+ # the group currently has 100% On-Demand capacity and the policy
4435
+ # specifies 50% Spot capacity, this means that half of your instances
4436
+ # will be gradually terminated and relaunched as Spot Instances. When
4437
+ # replacing instances, Amazon EC2 Auto Scaling launches new instances
4438
+ # before terminating the old ones, so that updating your group does not
4439
+ # compromise the performance or availability of your application.
4440
+ #
4441
+ # Note the following about changing `DesiredCapacity`, `MaxSize`, or
4442
+ # `MinSize`\:
4443
+ #
4444
+ # * If a scale-in event occurs as a result of a new `DesiredCapacity`
4445
+ # value that is lower than the current size of the group, the Auto
4446
+ # Scaling group uses its termination policy to determine which
4447
+ # instances to terminate.
4389
4448
  #
4390
4449
  # * If you specify a new value for `MinSize` without specifying a value
4391
4450
  # for `DesiredCapacity`, and the new `MinSize` is larger than the
4392
- # current size of the group, we implicitly call SetDesiredCapacity to
4393
- # set the size of the group to the new value of `MinSize`.
4451
+ # current size of the group, this sets the group's `DesiredCapacity`
4452
+ # to the new `MinSize` value.
4394
4453
  #
4395
4454
  # * If you specify a new value for `MaxSize` without specifying a value
4396
4455
  # for `DesiredCapacity`, and the new `MaxSize` is smaller than the
4397
- # current size of the group, we implicitly call SetDesiredCapacity to
4398
- # set the size of the group to the new value of `MaxSize`.
4456
+ # current size of the group, this sets the group's `DesiredCapacity`
4457
+ # to the new `MaxSize` value.
4399
4458
  #
4400
- # * All other optional parameters are left unchanged if not specified.
4459
+ # To see which parameters have been set, use DescribeAutoScalingGroups.
4460
+ # You can also view the scaling policies for an Auto Scaling group using
4461
+ # DescribePolicies. If the group has scaling policies, you can update
4462
+ # them using PutScalingPolicy.
4401
4463
  #
4402
4464
  # @option params [required, String] :auto_scaling_group_name
4403
4465
  # The name of the Auto Scaling group.
4404
4466
  #
4405
4467
  # @option params [String] :launch_configuration_name
4406
- # The name of the launch configuration. If you specify this parameter,
4407
- # you can't specify a launch template or a mixed instances policy.
4468
+ # The name of the launch configuration. If you specify
4469
+ # `LaunchConfigurationName` in your update request, you can't specify
4470
+ # `LaunchTemplate` or `MixedInstancesPolicy`.
4471
+ #
4472
+ # <note markdown="1"> To update an Auto Scaling group with a launch configuration with
4473
+ # `InstanceMonitoring` set to `false`, you must first disable the
4474
+ # collection of group metrics. Otherwise, you get an error. If you have
4475
+ # previously enabled the collection of group metrics, you can disable it
4476
+ # using DisableMetricsCollection.
4477
+ #
4478
+ # </note>
4408
4479
  #
4409
4480
  # @option params [Types::LaunchTemplateSpecification] :launch_template
4410
4481
  # The launch template and version to use to specify the updates. If you
4411
- # specify this parameter, you can't specify a launch configuration or a
4412
- # mixed instances policy.
4482
+ # specify `LaunchTemplate` in your update request, you can't specify
4483
+ # `LaunchConfigurationName` or `MixedInstancesPolicy`.
4413
4484
  #
4414
4485
  # @option params [Types::MixedInstancesPolicy] :mixed_instances_policy
4415
- # The mixed instances policy to use to specify the updates. If you
4416
- # specify this parameter, you can't specify a launch configuration or a
4417
- # launch template.
4486
+ # An embedded object that specifies a mixed instances policy.
4487
+ #
4488
+ # In your call to `UpdateAutoScalingGroup`, you can make changes to the
4489
+ # policy that is specified. All optional parameters are left unchanged
4490
+ # if not specified.
4418
4491
  #
4419
4492
  # For more information, see [Auto Scaling Groups with Multiple Instance
4420
4493
  # Types and Purchase Options][1] in the *Amazon EC2 Auto Scaling User
@@ -4438,9 +4511,13 @@ module Aws::AutoScaling
4438
4511
  # @option params [Integer] :default_cooldown
4439
4512
  # The amount of time, in seconds, after a scaling activity completes
4440
4513
  # before another scaling activity can start. The default value is `300`.
4514
+ # This cooldown period is not used when a scaling-specific cooldown is
4515
+ # specified.
4441
4516
  #
4442
- # For more information, see [Scaling Cooldowns][1] in the *Amazon EC2
4443
- # Auto Scaling User Guide*.
4517
+ # Cooldown periods are not supported for target tracking scaling
4518
+ # policies, step scaling policies, or scheduled scaling. For more
4519
+ # information, see [Scaling Cooldowns][1] in the *Amazon EC2 Auto
4520
+ # Scaling User Guide*.
4444
4521
  #
4445
4522
  #
4446
4523
  #
@@ -4482,7 +4559,7 @@ module Aws::AutoScaling
4482
4559
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html
4483
4560
  #
4484
4561
  # @option params [String] :vpc_zone_identifier
4485
- # A comma-separated list of subnet IDs, if you are launching into a VPC.
4562
+ # A comma-separated list of subnet IDs for virtual private cloud (VPC).
4486
4563
  #
4487
4564
  # If you specify `VPCZoneIdentifier` with `AvailabilityZones`, the
4488
4565
  # subnets that you specify for this parameter must reside in those
@@ -4622,7 +4699,7 @@ module Aws::AutoScaling
4622
4699
  params: params,
4623
4700
  config: config)
4624
4701
  context[:gem_name] = 'aws-sdk-autoscaling'
4625
- context[:gem_version] = '1.25.0'
4702
+ context[:gem_version] = '1.26.0'
4626
4703
  Seahorse::Client::Request.new(handlers, context)
4627
4704
  end
4628
4705