aws-sdk-autoscaling 1.25.0 → 1.26.0

Sign up to get free protection for your applications and to get access to all the features.
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