aws-sdk-autoscaling 1.59.0 → 1.64.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 +4 -4
- data/CHANGELOG.md +25 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-autoscaling.rb +1 -1
- data/lib/aws-sdk-autoscaling/auto_scaling_group.rb +125 -21
- data/lib/aws-sdk-autoscaling/client.rb +610 -100
- data/lib/aws-sdk-autoscaling/client_api.rb +185 -0
- data/lib/aws-sdk-autoscaling/customizations.rb +1 -1
- data/lib/aws-sdk-autoscaling/instance.rb +5 -1
- data/lib/aws-sdk-autoscaling/load_balancer.rb +5 -5
- data/lib/aws-sdk-autoscaling/resource.rb +33 -20
- data/lib/aws-sdk-autoscaling/scaling_policy.rb +8 -0
- data/lib/aws-sdk-autoscaling/types.rb +1019 -114
- metadata +5 -6
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: b286db5e817489a87192ad500538cbdcb251a48f0854706e26fbe8750601547e
|
4
|
+
data.tar.gz: 170288d4780b00d472551def8fedf0271931d532fb996c6a79462a982d2d11f8
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 50def4d13828420c1145f420c8c942ec7cebbeb316fe3c946d4d0bb9f6e53991fb68e3f6b1521bb03f10c7bc8d9602663cf9f81f845e5b485326ec3a4efb96aa
|
7
|
+
data.tar.gz: 5f63bc456fca712ebe918eef7f6fbf9cb845b03e30eb40318ad3f2a180c2020caf1769ae7b377f900bec16baff55a30cf05b083c3d7d54e1e83882f7af857b70
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,31 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.64.0 (2021-06-30)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Amazon EC2 Auto Scaling infrastructure improvements and optimizations.
|
8
|
+
|
9
|
+
1.63.0 (2021-06-04)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Documentation updates for Amazon EC2 Auto Scaling
|
13
|
+
|
14
|
+
1.62.0 (2021-06-02)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - You can now launch EC2 instances with GP3 volumes when using Auto Scaling groups with Launch Configurations
|
18
|
+
|
19
|
+
1.61.0 (2021-05-19)
|
20
|
+
------------------
|
21
|
+
|
22
|
+
* Feature - With this release, customers can easily use Predictive Scaling as a policy directly through Amazon EC2 Auto Scaling configurations to proactively scale their applications ahead of predicted demand.
|
23
|
+
|
24
|
+
1.60.0 (2021-04-08)
|
25
|
+
------------------
|
26
|
+
|
27
|
+
* Feature - Amazon EC2 Auto Scaling announces Warm Pools that help applications to scale out faster by pre-initializing EC2 instances and save money by requiring fewer continuously running instances
|
28
|
+
|
4
29
|
1.59.0 (2021-03-18)
|
5
30
|
------------------
|
6
31
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.64.0
|
data/lib/aws-sdk-autoscaling.rb
CHANGED
@@ -77,6 +77,13 @@ module Aws::AutoScaling
|
|
77
77
|
data[:desired_capacity]
|
78
78
|
end
|
79
79
|
|
80
|
+
# The predicted capacity of the group when it has a predictive scaling
|
81
|
+
# policy.
|
82
|
+
# @return [Integer]
|
83
|
+
def predicted_capacity
|
84
|
+
data[:predicted_capacity]
|
85
|
+
end
|
86
|
+
|
80
87
|
# The duration of the default cooldown period, in seconds.
|
81
88
|
# @return [Integer]
|
82
89
|
def default_cooldown
|
@@ -103,7 +110,7 @@ module Aws::AutoScaling
|
|
103
110
|
end
|
104
111
|
|
105
112
|
# The service to use for the health checks. The valid values are `EC2`
|
106
|
-
# and `ELB`. If you configure an Auto Scaling group to use ELB health
|
113
|
+
# and `ELB`. If you configure an Auto Scaling group to use `ELB` health
|
107
114
|
# checks, it considers the instance unhealthy if it fails either the EC2
|
108
115
|
# status checks or the load balancer health checks.
|
109
116
|
# @return [String]
|
@@ -171,7 +178,8 @@ module Aws::AutoScaling
|
|
171
178
|
end
|
172
179
|
|
173
180
|
# The Amazon Resource Name (ARN) of the service-linked role that the
|
174
|
-
# Auto Scaling group uses to call other
|
181
|
+
# Auto Scaling group uses to call other Amazon Web Services on your
|
182
|
+
# behalf.
|
175
183
|
# @return [String]
|
176
184
|
def service_linked_role_arn
|
177
185
|
data[:service_linked_role_arn]
|
@@ -192,6 +200,24 @@ module Aws::AutoScaling
|
|
192
200
|
data[:capacity_rebalance]
|
193
201
|
end
|
194
202
|
|
203
|
+
# The warm pool for the group.
|
204
|
+
# @return [Types::WarmPoolConfiguration]
|
205
|
+
def warm_pool_configuration
|
206
|
+
data[:warm_pool_configuration]
|
207
|
+
end
|
208
|
+
|
209
|
+
# The current size of the warm pool.
|
210
|
+
# @return [Integer]
|
211
|
+
def warm_pool_size
|
212
|
+
data[:warm_pool_size]
|
213
|
+
end
|
214
|
+
|
215
|
+
# Reserved.
|
216
|
+
# @return [String]
|
217
|
+
def context
|
218
|
+
data[:context]
|
219
|
+
end
|
220
|
+
|
195
221
|
# @!endgroup
|
196
222
|
|
197
223
|
# @return [Client]
|
@@ -415,8 +441,8 @@ module Aws::AutoScaling
|
|
415
441
|
# @option options [Boolean] :force_delete
|
416
442
|
# Specifies that the group is to be deleted along with all instances
|
417
443
|
# associated with the group, without waiting for all instances to be
|
418
|
-
# terminated. This parameter also deletes any lifecycle
|
419
|
-
# associated with the group.
|
444
|
+
# terminated. This parameter also deletes any outstanding lifecycle
|
445
|
+
# actions associated with the group.
|
420
446
|
# @return [EmptyStructure]
|
421
447
|
def delete(options = {})
|
422
448
|
options = options.merge(auto_scaling_group_name: @name)
|
@@ -486,6 +512,20 @@ module Aws::AutoScaling
|
|
486
512
|
#
|
487
513
|
# * `GroupTotalCapacity`
|
488
514
|
#
|
515
|
+
# * `WarmPoolDesiredCapacity`
|
516
|
+
#
|
517
|
+
# * `WarmPoolWarmedCapacity`
|
518
|
+
#
|
519
|
+
# * `WarmPoolPendingCapacity`
|
520
|
+
#
|
521
|
+
# * `WarmPoolTerminatingCapacity`
|
522
|
+
#
|
523
|
+
# * `WarmPoolTotalCapacity`
|
524
|
+
#
|
525
|
+
# * `GroupAndWarmPoolDesiredCapacity`
|
526
|
+
#
|
527
|
+
# * `GroupAndWarmPoolTotalCapacity`
|
528
|
+
#
|
489
529
|
# If you omit this parameter, all metrics are disabled.
|
490
530
|
# @return [EmptyStructure]
|
491
531
|
def disable_metrics_collection(options = {})
|
@@ -534,6 +574,22 @@ module Aws::AutoScaling
|
|
534
574
|
#
|
535
575
|
# * `GroupTotalCapacity`
|
536
576
|
#
|
577
|
+
# The warm pools feature supports the following additional metrics:
|
578
|
+
#
|
579
|
+
# * `WarmPoolDesiredCapacity`
|
580
|
+
#
|
581
|
+
# * `WarmPoolWarmedCapacity`
|
582
|
+
#
|
583
|
+
# * `WarmPoolPendingCapacity`
|
584
|
+
#
|
585
|
+
# * `WarmPoolTerminatingCapacity`
|
586
|
+
#
|
587
|
+
# * `WarmPoolTotalCapacity`
|
588
|
+
#
|
589
|
+
# * `GroupAndWarmPoolDesiredCapacity`
|
590
|
+
#
|
591
|
+
# * `GroupAndWarmPoolTotalCapacity`
|
592
|
+
#
|
537
593
|
# If you omit this parameter, all metrics are enabled.
|
538
594
|
# @option options [required, String] :granularity
|
539
595
|
# The granularity to associate with the metrics to collect. The only
|
@@ -585,6 +641,29 @@ module Aws::AutoScaling
|
|
585
641
|
# disable_scale_in: false,
|
586
642
|
# },
|
587
643
|
# enabled: false,
|
644
|
+
# predictive_scaling_configuration: {
|
645
|
+
# metric_specifications: [ # required
|
646
|
+
# {
|
647
|
+
# target_value: 1.0, # required
|
648
|
+
# predefined_metric_pair_specification: {
|
649
|
+
# predefined_metric_type: "ASGCPUUtilization", # required, accepts ASGCPUUtilization, ASGNetworkIn, ASGNetworkOut, ALBRequestCount
|
650
|
+
# resource_label: "XmlStringMaxLen1023",
|
651
|
+
# },
|
652
|
+
# predefined_scaling_metric_specification: {
|
653
|
+
# predefined_metric_type: "ASGAverageCPUUtilization", # required, accepts ASGAverageCPUUtilization, ASGAverageNetworkIn, ASGAverageNetworkOut, ALBRequestCountPerTarget
|
654
|
+
# resource_label: "XmlStringMaxLen1023",
|
655
|
+
# },
|
656
|
+
# predefined_load_metric_specification: {
|
657
|
+
# predefined_metric_type: "ASGTotalCPUUtilization", # required, accepts ASGTotalCPUUtilization, ASGTotalNetworkIn, ASGTotalNetworkOut, ALBTargetGroupRequestCount
|
658
|
+
# resource_label: "XmlStringMaxLen1023",
|
659
|
+
# },
|
660
|
+
# },
|
661
|
+
# ],
|
662
|
+
# mode: "ForecastAndScale", # accepts ForecastAndScale, ForecastOnly
|
663
|
+
# scheduling_buffer_time: 1,
|
664
|
+
# max_capacity_breach_behavior: "HonorMaxCapacity", # accepts HonorMaxCapacity, IncreaseMaxCapacity
|
665
|
+
# max_capacity_buffer: 1,
|
666
|
+
# },
|
588
667
|
# })
|
589
668
|
# @param [Hash] options ({})
|
590
669
|
# @option options [required, String] :policy_name
|
@@ -597,6 +676,8 @@ module Aws::AutoScaling
|
|
597
676
|
# * `StepScaling`
|
598
677
|
#
|
599
678
|
# * `SimpleScaling` (default)
|
679
|
+
#
|
680
|
+
# * `PredictiveScaling`
|
600
681
|
# @option options [String] :adjustment_type
|
601
682
|
# Specifies how the scaling adjustment is interpreted (for example, an
|
602
683
|
# absolute number or a percentage). The valid values are
|
@@ -675,7 +756,7 @@ module Aws::AutoScaling
|
|
675
756
|
# Valid only if the policy type is `TargetTrackingScaling` or
|
676
757
|
# `StepScaling`.
|
677
758
|
# @option options [Types::TargetTrackingConfiguration] :target_tracking_configuration
|
678
|
-
# A target tracking scaling policy.
|
759
|
+
# A target tracking scaling policy. Provides support for predefined or
|
679
760
|
# customized metrics.
|
680
761
|
#
|
681
762
|
# The following predefined metrics are available:
|
@@ -709,6 +790,21 @@ module Aws::AutoScaling
|
|
709
790
|
#
|
710
791
|
#
|
711
792
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-enable-disable-scaling-policy.html
|
793
|
+
# @option options [Types::PredictiveScalingConfiguration] :predictive_scaling_configuration
|
794
|
+
# A predictive scaling policy. Provides support for only predefined
|
795
|
+
# metrics.
|
796
|
+
#
|
797
|
+
# Predictive scaling works with CPU utilization, network in/out, and the
|
798
|
+
# Application Load Balancer request count.
|
799
|
+
#
|
800
|
+
# For more information, see [PredictiveScalingConfiguration][1] in the
|
801
|
+
# *Amazon EC2 Auto Scaling API Reference*.
|
802
|
+
#
|
803
|
+
# Required if the policy type is `PredictiveScaling`.
|
804
|
+
#
|
805
|
+
#
|
806
|
+
#
|
807
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_PredictiveScalingConfiguration.html
|
712
808
|
# @return [ScalingPolicy]
|
713
809
|
def put_scaling_policy(options = {})
|
714
810
|
options = options.merge(auto_scaling_group_name: @name)
|
@@ -941,6 +1037,7 @@ module Aws::AutoScaling
|
|
941
1037
|
# service_linked_role_arn: "ResourceName",
|
942
1038
|
# max_instance_lifetime: 1,
|
943
1039
|
# capacity_rebalance: false,
|
1040
|
+
# context: "Context",
|
944
1041
|
# })
|
945
1042
|
# @param [Hash] options ({})
|
946
1043
|
# @option options [String] :launch_configuration_name
|
@@ -995,7 +1092,7 @@ module Aws::AutoScaling
|
|
995
1092
|
# One or more Availability Zones for the group.
|
996
1093
|
# @option options [String] :health_check_type
|
997
1094
|
# The service to use for the health checks. The valid values are `EC2`
|
998
|
-
# and `ELB`. If you configure an Auto Scaling group to use ELB health
|
1095
|
+
# and `ELB`. If you configure an Auto Scaling group to use `ELB` health
|
999
1096
|
# checks, it considers the instance unhealthy if it fails either the EC2
|
1000
1097
|
# status checks or the load balancer health checks.
|
1001
1098
|
# @option options [Integer] :health_check_grace_period
|
@@ -1048,9 +1145,9 @@ module Aws::AutoScaling
|
|
1048
1145
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection
|
1049
1146
|
# @option options [String] :service_linked_role_arn
|
1050
1147
|
# The Amazon Resource Name (ARN) of the service-linked role that the
|
1051
|
-
# Auto Scaling group uses to call other
|
1052
|
-
# more information, see [Service-linked roles][1] in the
|
1053
|
-
# Auto Scaling User Guide*.
|
1148
|
+
# Auto Scaling group uses to call other Amazon Web Services on your
|
1149
|
+
# behalf. For more information, see [Service-linked roles][1] in the
|
1150
|
+
# *Amazon EC2 Auto Scaling User Guide*.
|
1054
1151
|
#
|
1055
1152
|
#
|
1056
1153
|
#
|
@@ -1074,6 +1171,8 @@ module Aws::AutoScaling
|
|
1074
1171
|
#
|
1075
1172
|
#
|
1076
1173
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
|
1174
|
+
# @option options [String] :context
|
1175
|
+
# Reserved.
|
1077
1176
|
# @return [AutoScalingGroup]
|
1078
1177
|
def update(options = {})
|
1079
1178
|
options = options.merge(auto_scaling_group_name: @name)
|
@@ -1094,11 +1193,13 @@ module Aws::AutoScaling
|
|
1094
1193
|
# })
|
1095
1194
|
# @param [Hash] options ({})
|
1096
1195
|
# @option options [Array<String>] :activity_ids
|
1097
|
-
# The activity IDs of the desired scaling activities.
|
1098
|
-
#
|
1099
|
-
#
|
1100
|
-
#
|
1101
|
-
#
|
1196
|
+
# The activity IDs of the desired scaling activities. If you omit this
|
1197
|
+
# parameter, all activities for the past six weeks are described. If
|
1198
|
+
# unknown activities are requested, they are ignored with no error. If
|
1199
|
+
# you specify an Auto Scaling group, the results are limited to that
|
1200
|
+
# group.
|
1201
|
+
#
|
1202
|
+
# Array Members: Maximum number of 50 IDs.
|
1102
1203
|
# @option options [Boolean] :include_deleted_groups
|
1103
1204
|
# Indicates whether to include scaling activity from deleted Auto
|
1104
1205
|
# Scaling groups.
|
@@ -1264,11 +1365,13 @@ module Aws::AutoScaling
|
|
1264
1365
|
# @option options [Array<String>] :policy_names
|
1265
1366
|
# The names of one or more policies. If you omit this parameter, all
|
1266
1367
|
# policies are described. If a group name is provided, the results are
|
1267
|
-
# limited to that group.
|
1268
|
-
#
|
1368
|
+
# limited to that group. If you specify an unknown policy name, it is
|
1369
|
+
# ignored with no error.
|
1370
|
+
#
|
1371
|
+
# Array Members: Maximum number of 50 items.
|
1269
1372
|
# @option options [Array<String>] :policy_types
|
1270
1373
|
# One or more policy types. The valid values are `SimpleScaling`,
|
1271
|
-
# `StepScaling`, and `
|
1374
|
+
# `StepScaling`, `TargetTrackingScaling`, and `PredictiveScaling`.
|
1272
1375
|
# @return [ScalingPolicy::Collection]
|
1273
1376
|
def policies(options = {})
|
1274
1377
|
batches = Enumerator.new do |y|
|
@@ -1298,10 +1401,11 @@ module Aws::AutoScaling
|
|
1298
1401
|
# })
|
1299
1402
|
# @param [Hash] options ({})
|
1300
1403
|
# @option options [Array<String>] :scheduled_action_names
|
1301
|
-
# The names of one or more scheduled actions.
|
1302
|
-
#
|
1303
|
-
#
|
1304
|
-
#
|
1404
|
+
# The names of one or more scheduled actions. If you omit this
|
1405
|
+
# parameter, all scheduled actions are described. If you specify an
|
1406
|
+
# unknown scheduled action, it is ignored with no error.
|
1407
|
+
#
|
1408
|
+
# Array Members: Maximum number of 50 actions.
|
1305
1409
|
# @option options [Time,DateTime,Date,Integer,String] :start_time
|
1306
1410
|
# The earliest scheduled start time to return. If scheduled action names
|
1307
1411
|
# are provided, this parameter is ignored.
|
@@ -596,8 +596,9 @@ module Aws::AutoScaling
|
|
596
596
|
# not roll back any replacements that have already been completed, but
|
597
597
|
# it prevents new replacements from being started.
|
598
598
|
#
|
599
|
-
#
|
600
|
-
#
|
599
|
+
# This operation is part of the [instance refresh feature][1] in Amazon
|
600
|
+
# EC2 Auto Scaling, which helps you update instances in your Auto
|
601
|
+
# Scaling group after you make configuration changes.
|
601
602
|
#
|
602
603
|
#
|
603
604
|
#
|
@@ -986,11 +987,11 @@ module Aws::AutoScaling
|
|
986
987
|
#
|
987
988
|
# @option params [String] :service_linked_role_arn
|
988
989
|
# The Amazon Resource Name (ARN) of the service-linked role that the
|
989
|
-
# Auto Scaling group uses to call other
|
990
|
-
# default, Amazon EC2 Auto Scaling uses a service-linked role
|
991
|
-
# AWSServiceRoleForAutoScaling
|
992
|
-
# For more information, see [Service-linked roles][1] in the
|
993
|
-
# Auto Scaling User Guide*.
|
990
|
+
# Auto Scaling group uses to call other Amazon Web Services on your
|
991
|
+
# behalf. By default, Amazon EC2 Auto Scaling uses a service-linked role
|
992
|
+
# named `AWSServiceRoleForAutoScaling`, which it creates if it does not
|
993
|
+
# exist. For more information, see [Service-linked roles][1] in the
|
994
|
+
# *Amazon EC2 Auto Scaling User Guide*.
|
994
995
|
#
|
995
996
|
#
|
996
997
|
#
|
@@ -1007,6 +1008,9 @@ module Aws::AutoScaling
|
|
1007
1008
|
#
|
1008
1009
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-max-instance-lifetime.html
|
1009
1010
|
#
|
1011
|
+
# @option params [String] :context
|
1012
|
+
# Reserved.
|
1013
|
+
#
|
1010
1014
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1011
1015
|
#
|
1012
1016
|
#
|
@@ -1032,9 +1036,12 @@ module Aws::AutoScaling
|
|
1032
1036
|
#
|
1033
1037
|
# resp = client.create_auto_scaling_group({
|
1034
1038
|
# auto_scaling_group_name: "my-auto-scaling-group",
|
1035
|
-
# health_check_grace_period:
|
1039
|
+
# health_check_grace_period: 300,
|
1036
1040
|
# health_check_type: "ELB",
|
1037
|
-
#
|
1041
|
+
# launch_template: {
|
1042
|
+
# launch_template_id: "lt-0a20c965061f64abc",
|
1043
|
+
# version: "$Default",
|
1044
|
+
# },
|
1038
1045
|
# max_size: 3,
|
1039
1046
|
# min_size: 1,
|
1040
1047
|
# target_group_arns: [
|
@@ -1043,23 +1050,45 @@ module Aws::AutoScaling
|
|
1043
1050
|
# vpc_zone_identifier: "subnet-057fa0918fEXAMPLE, subnet-610acd08EXAMPLE",
|
1044
1051
|
# })
|
1045
1052
|
#
|
1046
|
-
# @example Example: To create an Auto Scaling group with
|
1053
|
+
# @example Example: To create an Auto Scaling group with a mixed instances policy
|
1047
1054
|
#
|
1048
|
-
# # This example creates an Auto Scaling group
|
1055
|
+
# # This example creates an Auto Scaling group with a mixed instances policy. It specifies the c5.large, c5a.large, and
|
1056
|
+
# # c6g.large instance types and defines a different launch template for the c6g.large instance type.
|
1049
1057
|
#
|
1050
1058
|
# resp = client.create_auto_scaling_group({
|
1051
|
-
# auto_scaling_group_name: "my-
|
1052
|
-
#
|
1053
|
-
#
|
1054
|
-
# ],
|
1055
|
-
# health_check_grace_period: 120,
|
1056
|
-
# health_check_type: "ELB",
|
1057
|
-
# launch_configuration_name: "my-launch-config",
|
1058
|
-
# load_balancer_names: [
|
1059
|
-
# "my-load-balancer",
|
1060
|
-
# ],
|
1061
|
-
# max_size: 3,
|
1059
|
+
# auto_scaling_group_name: "my-asg",
|
1060
|
+
# desired_capacity: 3,
|
1061
|
+
# max_size: 5,
|
1062
1062
|
# min_size: 1,
|
1063
|
+
# mixed_instances_policy: {
|
1064
|
+
# instances_distribution: {
|
1065
|
+
# on_demand_base_capacity: 1,
|
1066
|
+
# on_demand_percentage_above_base_capacity: 50,
|
1067
|
+
# spot_allocation_strategy: "capacity-optimized",
|
1068
|
+
# },
|
1069
|
+
# launch_template: {
|
1070
|
+
# launch_template_specification: {
|
1071
|
+
# launch_template_name: "my-launch-template-for-x86",
|
1072
|
+
# version: "$Latest",
|
1073
|
+
# },
|
1074
|
+
# overrides: [
|
1075
|
+
# {
|
1076
|
+
# instance_type: "c6g.large",
|
1077
|
+
# launch_template_specification: {
|
1078
|
+
# launch_template_name: "my-launch-template-for-arm",
|
1079
|
+
# version: "$Latest",
|
1080
|
+
# },
|
1081
|
+
# },
|
1082
|
+
# {
|
1083
|
+
# instance_type: "c5.large",
|
1084
|
+
# },
|
1085
|
+
# {
|
1086
|
+
# instance_type: "c5a.large",
|
1087
|
+
# },
|
1088
|
+
# ],
|
1089
|
+
# },
|
1090
|
+
# },
|
1091
|
+
# vpc_zone_identifier: "subnet-057fa0918fEXAMPLE, subnet-610acd08EXAMPLE",
|
1063
1092
|
# })
|
1064
1093
|
#
|
1065
1094
|
# @example Request syntax with placeholder values
|
@@ -1137,6 +1166,7 @@ module Aws::AutoScaling
|
|
1137
1166
|
# ],
|
1138
1167
|
# service_linked_role_arn: "ResourceName",
|
1139
1168
|
# max_instance_lifetime: 1,
|
1169
|
+
# context: "Context",
|
1140
1170
|
# })
|
1141
1171
|
#
|
1142
1172
|
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateAutoScalingGroup AWS API Documentation
|
@@ -1450,6 +1480,7 @@ module Aws::AutoScaling
|
|
1450
1480
|
# delete_on_termination: false,
|
1451
1481
|
# iops: 1,
|
1452
1482
|
# encrypted: false,
|
1483
|
+
# throughput: 1,
|
1453
1484
|
# },
|
1454
1485
|
# no_device: false,
|
1455
1486
|
# },
|
@@ -1567,8 +1598,8 @@ module Aws::AutoScaling
|
|
1567
1598
|
# @option params [Boolean] :force_delete
|
1568
1599
|
# Specifies that the group is to be deleted along with all instances
|
1569
1600
|
# associated with the group, without waiting for all instances to be
|
1570
|
-
# terminated. This parameter also deletes any lifecycle
|
1571
|
-
# associated with the group.
|
1601
|
+
# terminated. This parameter also deletes any outstanding lifecycle
|
1602
|
+
# actions associated with the group.
|
1572
1603
|
#
|
1573
1604
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1574
1605
|
#
|
@@ -1847,12 +1878,50 @@ module Aws::AutoScaling
|
|
1847
1878
|
req.send_request(options)
|
1848
1879
|
end
|
1849
1880
|
|
1881
|
+
# Deletes the warm pool for the specified Auto Scaling group.
|
1882
|
+
#
|
1883
|
+
# For more information, see [Warm pools for Amazon EC2 Auto Scaling][1]
|
1884
|
+
# in the *Amazon EC2 Auto Scaling User Guide*.
|
1885
|
+
#
|
1886
|
+
#
|
1887
|
+
#
|
1888
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-warm-pools.html
|
1889
|
+
#
|
1890
|
+
# @option params [required, String] :auto_scaling_group_name
|
1891
|
+
# The name of the Auto Scaling group.
|
1892
|
+
#
|
1893
|
+
# @option params [Boolean] :force_delete
|
1894
|
+
# Specifies that the warm pool is to be deleted along with all of its
|
1895
|
+
# associated instances, without waiting for all instances to be
|
1896
|
+
# terminated. This parameter also deletes any outstanding lifecycle
|
1897
|
+
# actions associated with the warm pool instances.
|
1898
|
+
#
|
1899
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1900
|
+
#
|
1901
|
+
# @example Request syntax with placeholder values
|
1902
|
+
#
|
1903
|
+
# resp = client.delete_warm_pool({
|
1904
|
+
# auto_scaling_group_name: "XmlStringMaxLen255", # required
|
1905
|
+
# force_delete: false,
|
1906
|
+
# })
|
1907
|
+
#
|
1908
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteWarmPool AWS API Documentation
|
1909
|
+
#
|
1910
|
+
# @overload delete_warm_pool(params = {})
|
1911
|
+
# @param [Hash] params ({})
|
1912
|
+
def delete_warm_pool(params = {}, options = {})
|
1913
|
+
req = build_request(:delete_warm_pool, params)
|
1914
|
+
req.send_request(options)
|
1915
|
+
end
|
1916
|
+
|
1850
1917
|
# Describes the current Amazon EC2 Auto Scaling resource quotas for your
|
1851
|
-
#
|
1918
|
+
# account.
|
1852
1919
|
#
|
1853
|
-
#
|
1854
|
-
#
|
1855
|
-
#
|
1920
|
+
# When you establish an account, the account has initial quotas on the
|
1921
|
+
# maximum number of Auto Scaling groups and launch configurations that
|
1922
|
+
# you can create in a given Region. For more information, see [Amazon
|
1923
|
+
# EC2 Auto Scaling service quotas][1] in the *Amazon EC2 Auto Scaling
|
1924
|
+
# User Guide*.
|
1856
1925
|
#
|
1857
1926
|
#
|
1858
1927
|
#
|
@@ -1868,7 +1937,7 @@ module Aws::AutoScaling
|
|
1868
1937
|
#
|
1869
1938
|
# @example Example: To describe your Auto Scaling account limits
|
1870
1939
|
#
|
1871
|
-
# # This example describes the Auto Scaling
|
1940
|
+
# # This example describes the Amazon EC2 Auto Scaling service quotas for your account.
|
1872
1941
|
#
|
1873
1942
|
# resp = client.describe_account_limits({
|
1874
1943
|
# })
|
@@ -1897,18 +1966,16 @@ module Aws::AutoScaling
|
|
1897
1966
|
req.send_request(options)
|
1898
1967
|
end
|
1899
1968
|
|
1900
|
-
# Describes the available adjustment types for
|
1901
|
-
# scaling policies.
|
1902
|
-
# simple scaling policies; they do not apply to target tracking scaling
|
1903
|
-
# policies.
|
1969
|
+
# Describes the available adjustment types for step scaling and simple
|
1970
|
+
# scaling policies.
|
1904
1971
|
#
|
1905
1972
|
# The following adjustment types are supported:
|
1906
1973
|
#
|
1907
|
-
# * ChangeInCapacity
|
1974
|
+
# * `ChangeInCapacity`
|
1908
1975
|
#
|
1909
|
-
# * ExactCapacity
|
1976
|
+
# * `ExactCapacity`
|
1910
1977
|
#
|
1911
|
-
# * PercentChangeInCapacity
|
1978
|
+
# * `PercentChangeInCapacity`
|
1912
1979
|
#
|
1913
1980
|
# @return [Types::DescribeAdjustmentTypesAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1914
1981
|
#
|
@@ -1951,7 +2018,12 @@ module Aws::AutoScaling
|
|
1951
2018
|
req.send_request(options)
|
1952
2019
|
end
|
1953
2020
|
|
1954
|
-
#
|
2021
|
+
# Gets information about the Auto Scaling groups in the account and
|
2022
|
+
# Region.
|
2023
|
+
#
|
2024
|
+
# This operation returns information about instances in Auto Scaling
|
2025
|
+
# groups. To retrieve information about the instances in a warm pool,
|
2026
|
+
# you must call the DescribeWarmPool API.
|
1955
2027
|
#
|
1956
2028
|
# @option params [Array<String>] :auto_scaling_group_names
|
1957
2029
|
# The names of the Auto Scaling groups. By default, you can only specify
|
@@ -2065,6 +2137,7 @@ module Aws::AutoScaling
|
|
2065
2137
|
# resp.auto_scaling_groups[0].min_size #=> Integer
|
2066
2138
|
# resp.auto_scaling_groups[0].max_size #=> Integer
|
2067
2139
|
# resp.auto_scaling_groups[0].desired_capacity #=> Integer
|
2140
|
+
# resp.auto_scaling_groups[0].predicted_capacity #=> Integer
|
2068
2141
|
# resp.auto_scaling_groups[0].default_cooldown #=> Integer
|
2069
2142
|
# resp.auto_scaling_groups[0].availability_zones #=> Array
|
2070
2143
|
# resp.auto_scaling_groups[0].availability_zones[0] #=> String
|
@@ -2078,7 +2151,7 @@ module Aws::AutoScaling
|
|
2078
2151
|
# resp.auto_scaling_groups[0].instances[0].instance_id #=> String
|
2079
2152
|
# resp.auto_scaling_groups[0].instances[0].instance_type #=> String
|
2080
2153
|
# resp.auto_scaling_groups[0].instances[0].availability_zone #=> String
|
2081
|
-
# resp.auto_scaling_groups[0].instances[0].lifecycle_state #=> String, one of "Pending", "Pending:Wait", "Pending:Proceed", "Quarantined", "InService", "Terminating", "Terminating:Wait", "Terminating:Proceed", "Terminated", "Detaching", "Detached", "EnteringStandby", "Standby"
|
2154
|
+
# resp.auto_scaling_groups[0].instances[0].lifecycle_state #=> String, one of "Pending", "Pending:Wait", "Pending:Proceed", "Quarantined", "InService", "Terminating", "Terminating:Wait", "Terminating:Proceed", "Terminated", "Detaching", "Detached", "EnteringStandby", "Standby", "Warmed:Pending", "Warmed:Pending:Wait", "Warmed:Pending:Proceed", "Warmed:Terminating", "Warmed:Terminating:Wait", "Warmed:Terminating:Proceed", "Warmed:Terminated", "Warmed:Stopped", "Warmed:Running"
|
2082
2155
|
# resp.auto_scaling_groups[0].instances[0].health_status #=> String
|
2083
2156
|
# resp.auto_scaling_groups[0].instances[0].launch_configuration_name #=> String
|
2084
2157
|
# resp.auto_scaling_groups[0].instances[0].launch_template.launch_template_id #=> String
|
@@ -2108,6 +2181,12 @@ module Aws::AutoScaling
|
|
2108
2181
|
# resp.auto_scaling_groups[0].service_linked_role_arn #=> String
|
2109
2182
|
# resp.auto_scaling_groups[0].max_instance_lifetime #=> Integer
|
2110
2183
|
# resp.auto_scaling_groups[0].capacity_rebalance #=> Boolean
|
2184
|
+
# resp.auto_scaling_groups[0].warm_pool_configuration.max_group_prepared_capacity #=> Integer
|
2185
|
+
# resp.auto_scaling_groups[0].warm_pool_configuration.min_size #=> Integer
|
2186
|
+
# resp.auto_scaling_groups[0].warm_pool_configuration.pool_state #=> String, one of "Stopped", "Running"
|
2187
|
+
# resp.auto_scaling_groups[0].warm_pool_configuration.status #=> String, one of "PendingDelete"
|
2188
|
+
# resp.auto_scaling_groups[0].warm_pool_size #=> Integer
|
2189
|
+
# resp.auto_scaling_groups[0].context #=> String
|
2111
2190
|
# resp.next_token #=> String
|
2112
2191
|
#
|
2113
2192
|
#
|
@@ -2126,12 +2205,15 @@ module Aws::AutoScaling
|
|
2126
2205
|
req.send_request(options)
|
2127
2206
|
end
|
2128
2207
|
|
2129
|
-
#
|
2208
|
+
# Gets information about the Auto Scaling instances in the account and
|
2209
|
+
# Region.
|
2130
2210
|
#
|
2131
2211
|
# @option params [Array<String>] :instance_ids
|
2132
|
-
# The IDs of the instances.
|
2133
|
-
#
|
2134
|
-
#
|
2212
|
+
# The IDs of the instances. If you omit this parameter, all Auto Scaling
|
2213
|
+
# instances are described. If you specify an ID that does not exist, it
|
2214
|
+
# is ignored with no error.
|
2215
|
+
#
|
2216
|
+
# Array Members: Maximum number of 50 items.
|
2135
2217
|
#
|
2136
2218
|
# @option params [Integer] :max_records
|
2137
2219
|
# The maximum number of items to return with this call. The default
|
@@ -2248,10 +2330,20 @@ module Aws::AutoScaling
|
|
2248
2330
|
req.send_request(options)
|
2249
2331
|
end
|
2250
2332
|
|
2251
|
-
#
|
2333
|
+
# Gets information about the instance refreshes for the specified Auto
|
2334
|
+
# Scaling group.
|
2252
2335
|
#
|
2253
|
-
#
|
2254
|
-
#
|
2336
|
+
# This operation is part of the [instance refresh feature][1] in Amazon
|
2337
|
+
# EC2 Auto Scaling, which helps you update instances in your Auto
|
2338
|
+
# Scaling group after you make configuration changes.
|
2339
|
+
#
|
2340
|
+
# To help you determine the status of an instance refresh, this
|
2341
|
+
# operation returns information about the instance refreshes you
|
2342
|
+
# previously initiated, including their status, end time, the percentage
|
2343
|
+
# of the instance refresh that is complete, and the number of instances
|
2344
|
+
# remaining to update before the instance refresh is complete.
|
2345
|
+
#
|
2346
|
+
# The following are the possible statuses:
|
2255
2347
|
#
|
2256
2348
|
# * `Pending` - The request was created, but the operation has not
|
2257
2349
|
# started.
|
@@ -2269,9 +2361,6 @@ module Aws::AutoScaling
|
|
2269
2361
|
#
|
2270
2362
|
# * `Cancelled` - The operation is cancelled.
|
2271
2363
|
#
|
2272
|
-
# For more information, see [Replacing Auto Scaling instances based on
|
2273
|
-
# an instance refresh][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
2274
|
-
#
|
2275
2364
|
#
|
2276
2365
|
#
|
2277
2366
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html
|
@@ -2347,6 +2436,10 @@ module Aws::AutoScaling
|
|
2347
2436
|
# resp.instance_refreshes[0].end_time #=> Time
|
2348
2437
|
# resp.instance_refreshes[0].percentage_complete #=> Integer
|
2349
2438
|
# resp.instance_refreshes[0].instances_to_update #=> Integer
|
2439
|
+
# resp.instance_refreshes[0].progress_details.live_pool_progress.percentage_complete #=> Integer
|
2440
|
+
# resp.instance_refreshes[0].progress_details.live_pool_progress.instances_to_update #=> Integer
|
2441
|
+
# resp.instance_refreshes[0].progress_details.warm_pool_progress.percentage_complete #=> Integer
|
2442
|
+
# resp.instance_refreshes[0].progress_details.warm_pool_progress.instances_to_update #=> Integer
|
2350
2443
|
# resp.next_token #=> String
|
2351
2444
|
#
|
2352
2445
|
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeInstanceRefreshes AWS API Documentation
|
@@ -2358,12 +2451,15 @@ module Aws::AutoScaling
|
|
2358
2451
|
req.send_request(options)
|
2359
2452
|
end
|
2360
2453
|
|
2361
|
-
#
|
2454
|
+
# Gets information about the launch configurations in the account and
|
2455
|
+
# Region.
|
2362
2456
|
#
|
2363
2457
|
# @option params [Array<String>] :launch_configuration_names
|
2364
2458
|
# The launch configuration names. If you omit this parameter, all launch
|
2365
2459
|
# configurations are described.
|
2366
2460
|
#
|
2461
|
+
# Array Members: Maximum number of 50 items.
|
2462
|
+
#
|
2367
2463
|
# @option params [String] :next_token
|
2368
2464
|
# The token for the next set of items to return. (You received this
|
2369
2465
|
# token from a previous call.)
|
@@ -2446,6 +2542,7 @@ module Aws::AutoScaling
|
|
2446
2542
|
# resp.launch_configurations[0].block_device_mappings[0].ebs.delete_on_termination #=> Boolean
|
2447
2543
|
# resp.launch_configurations[0].block_device_mappings[0].ebs.iops #=> Integer
|
2448
2544
|
# resp.launch_configurations[0].block_device_mappings[0].ebs.encrypted #=> Boolean
|
2545
|
+
# resp.launch_configurations[0].block_device_mappings[0].ebs.throughput #=> Integer
|
2449
2546
|
# resp.launch_configurations[0].block_device_mappings[0].no_device #=> Boolean
|
2450
2547
|
# resp.launch_configurations[0].instance_monitoring.enabled #=> Boolean
|
2451
2548
|
# resp.launch_configurations[0].spot_price #=> String
|
@@ -2472,9 +2569,9 @@ module Aws::AutoScaling
|
|
2472
2569
|
#
|
2473
2570
|
# The following hook types are supported:
|
2474
2571
|
#
|
2475
|
-
# * autoscaling:
|
2572
|
+
# * `autoscaling:EC2_INSTANCE_LAUNCHING`
|
2476
2573
|
#
|
2477
|
-
# * autoscaling:
|
2574
|
+
# * `autoscaling:EC2_INSTANCE_TERMINATING`
|
2478
2575
|
#
|
2479
2576
|
# @return [Types::DescribeLifecycleHookTypesAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2480
2577
|
#
|
@@ -2510,7 +2607,8 @@ module Aws::AutoScaling
|
|
2510
2607
|
req.send_request(options)
|
2511
2608
|
end
|
2512
2609
|
|
2513
|
-
#
|
2610
|
+
# Gets information about the lifecycle hooks for the specified Auto
|
2611
|
+
# Scaling group.
|
2514
2612
|
#
|
2515
2613
|
# @option params [required, String] :auto_scaling_group_name
|
2516
2614
|
# The name of the Auto Scaling group.
|
@@ -2577,7 +2675,36 @@ module Aws::AutoScaling
|
|
2577
2675
|
req.send_request(options)
|
2578
2676
|
end
|
2579
2677
|
|
2580
|
-
#
|
2678
|
+
# Gets information about the load balancer target groups for the
|
2679
|
+
# specified Auto Scaling group.
|
2680
|
+
#
|
2681
|
+
# To determine the availability of registered instances, use the `State`
|
2682
|
+
# element in the response. When you attach a target group to an Auto
|
2683
|
+
# Scaling group, the initial `State` value is `Adding`. The state
|
2684
|
+
# transitions to `Added` after all Auto Scaling instances are registered
|
2685
|
+
# with the target group. If Elastic Load Balancing health checks are
|
2686
|
+
# enabled for the Auto Scaling group, the state transitions to
|
2687
|
+
# `InService` after at least one Auto Scaling instance passes the health
|
2688
|
+
# check. When the target group is in the `InService` state, Amazon EC2
|
2689
|
+
# Auto Scaling can terminate and replace any instances that are reported
|
2690
|
+
# as unhealthy. If no registered instances pass the health checks, the
|
2691
|
+
# target group doesn't enter the `InService` state.
|
2692
|
+
#
|
2693
|
+
# Target groups also have an `InService` state if you attach them in the
|
2694
|
+
# CreateAutoScalingGroup API call. If your target group state is
|
2695
|
+
# `InService`, but it is not working properly, check the scaling
|
2696
|
+
# activities by calling DescribeScalingActivities and take any
|
2697
|
+
# corrective actions necessary.
|
2698
|
+
#
|
2699
|
+
# For help with failed health checks, see [Troubleshooting Amazon EC2
|
2700
|
+
# Auto Scaling: Health checks][1] in the *Amazon EC2 Auto Scaling User
|
2701
|
+
# Guide*. For more information, see [Elastic Load Balancing and Amazon
|
2702
|
+
# EC2 Auto Scaling][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
2703
|
+
#
|
2704
|
+
#
|
2705
|
+
#
|
2706
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ts-as-healthchecks.html
|
2707
|
+
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
|
2581
2708
|
#
|
2582
2709
|
# @option params [required, String] :auto_scaling_group_name
|
2583
2710
|
# The name of the Auto Scaling group.
|
@@ -2638,12 +2765,41 @@ module Aws::AutoScaling
|
|
2638
2765
|
req.send_request(options)
|
2639
2766
|
end
|
2640
2767
|
|
2641
|
-
#
|
2768
|
+
# Gets information about the load balancers for the specified Auto
|
2769
|
+
# Scaling group.
|
2642
2770
|
#
|
2643
2771
|
# This operation describes only Classic Load Balancers. If you have
|
2644
2772
|
# Application Load Balancers, Network Load Balancers, or Gateway Load
|
2645
2773
|
# Balancers, use the DescribeLoadBalancerTargetGroups API instead.
|
2646
2774
|
#
|
2775
|
+
# To determine the availability of registered instances, use the `State`
|
2776
|
+
# element in the response. When you attach a load balancer to an Auto
|
2777
|
+
# Scaling group, the initial `State` value is `Adding`. The state
|
2778
|
+
# transitions to `Added` after all Auto Scaling instances are registered
|
2779
|
+
# with the load balancer. If Elastic Load Balancing health checks are
|
2780
|
+
# enabled for the Auto Scaling group, the state transitions to
|
2781
|
+
# `InService` after at least one Auto Scaling instance passes the health
|
2782
|
+
# check. When the load balancer is in the `InService` state, Amazon EC2
|
2783
|
+
# Auto Scaling can terminate and replace any instances that are reported
|
2784
|
+
# as unhealthy. If no registered instances pass the health checks, the
|
2785
|
+
# load balancer doesn't enter the `InService` state.
|
2786
|
+
#
|
2787
|
+
# Load balancers also have an `InService` state if you attach them in
|
2788
|
+
# the CreateAutoScalingGroup API call. If your load balancer state is
|
2789
|
+
# `InService`, but it is not working properly, check the scaling
|
2790
|
+
# activities by calling DescribeScalingActivities and take any
|
2791
|
+
# corrective actions necessary.
|
2792
|
+
#
|
2793
|
+
# For help with failed health checks, see [Troubleshooting Amazon EC2
|
2794
|
+
# Auto Scaling: Health checks][1] in the *Amazon EC2 Auto Scaling User
|
2795
|
+
# Guide*. For more information, see [Elastic Load Balancing and Amazon
|
2796
|
+
# EC2 Auto Scaling][2] in the *Amazon EC2 Auto Scaling User Guide*.
|
2797
|
+
#
|
2798
|
+
#
|
2799
|
+
#
|
2800
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ts-as-healthchecks.html
|
2801
|
+
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html
|
2802
|
+
#
|
2647
2803
|
# @option params [required, String] :auto_scaling_group_name
|
2648
2804
|
# The name of the Auto Scaling group.
|
2649
2805
|
#
|
@@ -2774,8 +2930,8 @@ module Aws::AutoScaling
|
|
2774
2930
|
req.send_request(options)
|
2775
2931
|
end
|
2776
2932
|
|
2777
|
-
#
|
2778
|
-
# Scaling
|
2933
|
+
# Gets information about the Amazon SNS notifications that are
|
2934
|
+
# configured for one or more Auto Scaling groups.
|
2779
2935
|
#
|
2780
2936
|
# @option params [Array<String>] :auto_scaling_group_names
|
2781
2937
|
# The name of the Auto Scaling group.
|
@@ -2847,7 +3003,7 @@ module Aws::AutoScaling
|
|
2847
3003
|
req.send_request(options)
|
2848
3004
|
end
|
2849
3005
|
|
2850
|
-
#
|
3006
|
+
# Gets information about the scaling policies in the account and Region.
|
2851
3007
|
#
|
2852
3008
|
# @option params [String] :auto_scaling_group_name
|
2853
3009
|
# The name of the Auto Scaling group.
|
@@ -2855,12 +3011,14 @@ module Aws::AutoScaling
|
|
2855
3011
|
# @option params [Array<String>] :policy_names
|
2856
3012
|
# The names of one or more policies. If you omit this parameter, all
|
2857
3013
|
# policies are described. If a group name is provided, the results are
|
2858
|
-
# limited to that group.
|
2859
|
-
#
|
3014
|
+
# limited to that group. If you specify an unknown policy name, it is
|
3015
|
+
# ignored with no error.
|
3016
|
+
#
|
3017
|
+
# Array Members: Maximum number of 50 items.
|
2860
3018
|
#
|
2861
3019
|
# @option params [Array<String>] :policy_types
|
2862
3020
|
# One or more policy types. The valid values are `SimpleScaling`,
|
2863
|
-
# `StepScaling`, and `
|
3021
|
+
# `StepScaling`, `TargetTrackingScaling`, and `PredictiveScaling`.
|
2864
3022
|
#
|
2865
3023
|
# @option params [String] :next_token
|
2866
3024
|
# The token for the next set of items to return. (You received this
|
@@ -2955,6 +3113,18 @@ module Aws::AutoScaling
|
|
2955
3113
|
# resp.scaling_policies[0].target_tracking_configuration.target_value #=> Float
|
2956
3114
|
# resp.scaling_policies[0].target_tracking_configuration.disable_scale_in #=> Boolean
|
2957
3115
|
# resp.scaling_policies[0].enabled #=> Boolean
|
3116
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.metric_specifications #=> Array
|
3117
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.metric_specifications[0].target_value #=> Float
|
3118
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.metric_specifications[0].predefined_metric_pair_specification.predefined_metric_type #=> String, one of "ASGCPUUtilization", "ASGNetworkIn", "ASGNetworkOut", "ALBRequestCount"
|
3119
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.metric_specifications[0].predefined_metric_pair_specification.resource_label #=> String
|
3120
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.metric_specifications[0].predefined_scaling_metric_specification.predefined_metric_type #=> String, one of "ASGAverageCPUUtilization", "ASGAverageNetworkIn", "ASGAverageNetworkOut", "ALBRequestCountPerTarget"
|
3121
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.metric_specifications[0].predefined_scaling_metric_specification.resource_label #=> String
|
3122
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.metric_specifications[0].predefined_load_metric_specification.predefined_metric_type #=> String, one of "ASGTotalCPUUtilization", "ASGTotalNetworkIn", "ASGTotalNetworkOut", "ALBTargetGroupRequestCount"
|
3123
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.metric_specifications[0].predefined_load_metric_specification.resource_label #=> String
|
3124
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.mode #=> String, one of "ForecastAndScale", "ForecastOnly"
|
3125
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.scheduling_buffer_time #=> Integer
|
3126
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.max_capacity_breach_behavior #=> String, one of "HonorMaxCapacity", "IncreaseMaxCapacity"
|
3127
|
+
# resp.scaling_policies[0].predictive_scaling_configuration.max_capacity_buffer #=> Integer
|
2958
3128
|
# resp.next_token #=> String
|
2959
3129
|
#
|
2960
3130
|
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribePolicies AWS API Documentation
|
@@ -2966,26 +3136,35 @@ module Aws::AutoScaling
|
|
2966
3136
|
req.send_request(options)
|
2967
3137
|
end
|
2968
3138
|
|
2969
|
-
#
|
2970
|
-
#
|
3139
|
+
# Gets information about the scaling activities in the account and
|
3140
|
+
# Region.
|
2971
3141
|
#
|
2972
|
-
#
|
2973
|
-
#
|
2974
|
-
# scaling events occur, you see scaling activity messages in the
|
2975
|
-
# **Activity history**. For more information, see [Verifying a scaling
|
3142
|
+
# When scaling events occur, you see a record of the scaling activity in
|
3143
|
+
# the scaling activities. For more information, see [Verifying a scaling
|
2976
3144
|
# activity for an Auto Scaling group][1] in the *Amazon EC2 Auto Scaling
|
2977
3145
|
# User Guide*.
|
2978
3146
|
#
|
3147
|
+
# If the scaling event succeeds, the value of the `StatusCode` element
|
3148
|
+
# in the response is `Successful`. If an attempt to launch instances
|
3149
|
+
# failed, the `StatusCode` value is `Failed` or `Cancelled` and the
|
3150
|
+
# `StatusMessage` element in the response indicates the cause of the
|
3151
|
+
# failure. For help interpreting the `StatusMessage`, see
|
3152
|
+
# [Troubleshooting Amazon EC2 Auto Scaling][2] in the *Amazon EC2 Auto
|
3153
|
+
# Scaling User Guide*.
|
3154
|
+
#
|
2979
3155
|
#
|
2980
3156
|
#
|
2981
3157
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-verify-scaling-activity.html
|
3158
|
+
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/CHAP_Troubleshooting.html
|
2982
3159
|
#
|
2983
3160
|
# @option params [Array<String>] :activity_ids
|
2984
|
-
# The activity IDs of the desired scaling activities.
|
2985
|
-
#
|
2986
|
-
#
|
2987
|
-
#
|
2988
|
-
#
|
3161
|
+
# The activity IDs of the desired scaling activities. If you omit this
|
3162
|
+
# parameter, all activities for the past six weeks are described. If
|
3163
|
+
# unknown activities are requested, they are ignored with no error. If
|
3164
|
+
# you specify an Auto Scaling group, the results are limited to that
|
3165
|
+
# group.
|
3166
|
+
#
|
3167
|
+
# Array Members: Maximum number of 50 IDs.
|
2989
3168
|
#
|
2990
3169
|
# @option params [String] :auto_scaling_group_name
|
2991
3170
|
# The name of the Auto Scaling group.
|
@@ -3130,18 +3309,21 @@ module Aws::AutoScaling
|
|
3130
3309
|
req.send_request(options)
|
3131
3310
|
end
|
3132
3311
|
|
3133
|
-
#
|
3134
|
-
#
|
3135
|
-
#
|
3312
|
+
# Gets information about the scheduled actions that haven't run or that
|
3313
|
+
# have not reached their end time.
|
3314
|
+
#
|
3315
|
+
# To describe the scaling activities for scheduled actions that have
|
3316
|
+
# already run, call the DescribeScalingActivities API.
|
3136
3317
|
#
|
3137
3318
|
# @option params [String] :auto_scaling_group_name
|
3138
3319
|
# The name of the Auto Scaling group.
|
3139
3320
|
#
|
3140
3321
|
# @option params [Array<String>] :scheduled_action_names
|
3141
|
-
# The names of one or more scheduled actions.
|
3142
|
-
#
|
3143
|
-
#
|
3144
|
-
#
|
3322
|
+
# The names of one or more scheduled actions. If you omit this
|
3323
|
+
# parameter, all scheduled actions are described. If you specify an
|
3324
|
+
# unknown scheduled action, it is ignored with no error.
|
3325
|
+
#
|
3326
|
+
# Array Members: Maximum number of 50 actions.
|
3145
3327
|
#
|
3146
3328
|
# @option params [Time,DateTime,Date,Integer,String] :start_time
|
3147
3329
|
# The earliest scheduled start time to return. If scheduled action names
|
@@ -3381,6 +3563,69 @@ module Aws::AutoScaling
|
|
3381
3563
|
req.send_request(options)
|
3382
3564
|
end
|
3383
3565
|
|
3566
|
+
# Gets information about a warm pool and its instances.
|
3567
|
+
#
|
3568
|
+
# For more information, see [Warm pools for Amazon EC2 Auto Scaling][1]
|
3569
|
+
# in the *Amazon EC2 Auto Scaling User Guide*.
|
3570
|
+
#
|
3571
|
+
#
|
3572
|
+
#
|
3573
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-warm-pools.html
|
3574
|
+
#
|
3575
|
+
# @option params [required, String] :auto_scaling_group_name
|
3576
|
+
# The name of the Auto Scaling group.
|
3577
|
+
#
|
3578
|
+
# @option params [Integer] :max_records
|
3579
|
+
# The maximum number of instances to return with this call. The maximum
|
3580
|
+
# value is `50`.
|
3581
|
+
#
|
3582
|
+
# @option params [String] :next_token
|
3583
|
+
# The token for the next set of instances to return. (You received this
|
3584
|
+
# token from a previous call.)
|
3585
|
+
#
|
3586
|
+
# @return [Types::DescribeWarmPoolAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3587
|
+
#
|
3588
|
+
# * {Types::DescribeWarmPoolAnswer#warm_pool_configuration #warm_pool_configuration} => Types::WarmPoolConfiguration
|
3589
|
+
# * {Types::DescribeWarmPoolAnswer#instances #instances} => Array<Types::Instance>
|
3590
|
+
# * {Types::DescribeWarmPoolAnswer#next_token #next_token} => String
|
3591
|
+
#
|
3592
|
+
# @example Request syntax with placeholder values
|
3593
|
+
#
|
3594
|
+
# resp = client.describe_warm_pool({
|
3595
|
+
# auto_scaling_group_name: "XmlStringMaxLen255", # required
|
3596
|
+
# max_records: 1,
|
3597
|
+
# next_token: "XmlString",
|
3598
|
+
# })
|
3599
|
+
#
|
3600
|
+
# @example Response structure
|
3601
|
+
#
|
3602
|
+
# resp.warm_pool_configuration.max_group_prepared_capacity #=> Integer
|
3603
|
+
# resp.warm_pool_configuration.min_size #=> Integer
|
3604
|
+
# resp.warm_pool_configuration.pool_state #=> String, one of "Stopped", "Running"
|
3605
|
+
# resp.warm_pool_configuration.status #=> String, one of "PendingDelete"
|
3606
|
+
# resp.instances #=> Array
|
3607
|
+
# resp.instances[0].instance_id #=> String
|
3608
|
+
# resp.instances[0].instance_type #=> String
|
3609
|
+
# resp.instances[0].availability_zone #=> String
|
3610
|
+
# resp.instances[0].lifecycle_state #=> String, one of "Pending", "Pending:Wait", "Pending:Proceed", "Quarantined", "InService", "Terminating", "Terminating:Wait", "Terminating:Proceed", "Terminated", "Detaching", "Detached", "EnteringStandby", "Standby", "Warmed:Pending", "Warmed:Pending:Wait", "Warmed:Pending:Proceed", "Warmed:Terminating", "Warmed:Terminating:Wait", "Warmed:Terminating:Proceed", "Warmed:Terminated", "Warmed:Stopped", "Warmed:Running"
|
3611
|
+
# resp.instances[0].health_status #=> String
|
3612
|
+
# resp.instances[0].launch_configuration_name #=> String
|
3613
|
+
# resp.instances[0].launch_template.launch_template_id #=> String
|
3614
|
+
# resp.instances[0].launch_template.launch_template_name #=> String
|
3615
|
+
# resp.instances[0].launch_template.version #=> String
|
3616
|
+
# resp.instances[0].protected_from_scale_in #=> Boolean
|
3617
|
+
# resp.instances[0].weighted_capacity #=> String
|
3618
|
+
# resp.next_token #=> String
|
3619
|
+
#
|
3620
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeWarmPool AWS API Documentation
|
3621
|
+
#
|
3622
|
+
# @overload describe_warm_pool(params = {})
|
3623
|
+
# @param [Hash] params ({})
|
3624
|
+
def describe_warm_pool(params = {}, options = {})
|
3625
|
+
req = build_request(:describe_warm_pool, params)
|
3626
|
+
req.send_request(options)
|
3627
|
+
end
|
3628
|
+
|
3384
3629
|
# Removes one or more instances from the specified Auto Scaling group.
|
3385
3630
|
#
|
3386
3631
|
# After the instances are detached, you can manage them independent of
|
@@ -3601,6 +3846,20 @@ module Aws::AutoScaling
|
|
3601
3846
|
#
|
3602
3847
|
# * `GroupTotalCapacity`
|
3603
3848
|
#
|
3849
|
+
# * `WarmPoolDesiredCapacity`
|
3850
|
+
#
|
3851
|
+
# * `WarmPoolWarmedCapacity`
|
3852
|
+
#
|
3853
|
+
# * `WarmPoolPendingCapacity`
|
3854
|
+
#
|
3855
|
+
# * `WarmPoolTerminatingCapacity`
|
3856
|
+
#
|
3857
|
+
# * `WarmPoolTotalCapacity`
|
3858
|
+
#
|
3859
|
+
# * `GroupAndWarmPoolDesiredCapacity`
|
3860
|
+
#
|
3861
|
+
# * `GroupAndWarmPoolTotalCapacity`
|
3862
|
+
#
|
3604
3863
|
# If you omit this parameter, all metrics are disabled.
|
3605
3864
|
#
|
3606
3865
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
@@ -3677,6 +3936,22 @@ module Aws::AutoScaling
|
|
3677
3936
|
#
|
3678
3937
|
# * `GroupTotalCapacity`
|
3679
3938
|
#
|
3939
|
+
# The warm pools feature supports the following additional metrics:
|
3940
|
+
#
|
3941
|
+
# * `WarmPoolDesiredCapacity`
|
3942
|
+
#
|
3943
|
+
# * `WarmPoolWarmedCapacity`
|
3944
|
+
#
|
3945
|
+
# * `WarmPoolPendingCapacity`
|
3946
|
+
#
|
3947
|
+
# * `WarmPoolTerminatingCapacity`
|
3948
|
+
#
|
3949
|
+
# * `WarmPoolTotalCapacity`
|
3950
|
+
#
|
3951
|
+
# * `GroupAndWarmPoolDesiredCapacity`
|
3952
|
+
#
|
3953
|
+
# * `GroupAndWarmPoolTotalCapacity`
|
3954
|
+
#
|
3680
3955
|
# If you omit this parameter, all metrics are enabled.
|
3681
3956
|
#
|
3682
3957
|
# @option params [required, String] :granularity
|
@@ -3961,6 +4236,89 @@ module Aws::AutoScaling
|
|
3961
4236
|
req.send_request(options)
|
3962
4237
|
end
|
3963
4238
|
|
4239
|
+
# Retrieves the forecast data for a predictive scaling policy.
|
4240
|
+
#
|
4241
|
+
# Load forecasts are predictions of the hourly load values using
|
4242
|
+
# historical load data from CloudWatch and an analysis of historical
|
4243
|
+
# trends. Capacity forecasts are represented as predicted values for the
|
4244
|
+
# minimum capacity that is needed on an hourly basis, based on the
|
4245
|
+
# hourly load forecast.
|
4246
|
+
#
|
4247
|
+
# A minimum of 24 hours of data is required to create the initial
|
4248
|
+
# forecasts. However, having a full 14 days of historical data results
|
4249
|
+
# in more accurate forecasts.
|
4250
|
+
#
|
4251
|
+
# For more information, see [Predictive scaling for Amazon EC2 Auto
|
4252
|
+
# Scaling][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
4253
|
+
#
|
4254
|
+
#
|
4255
|
+
#
|
4256
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-predictive-scaling.html
|
4257
|
+
#
|
4258
|
+
# @option params [required, String] :auto_scaling_group_name
|
4259
|
+
# The name of the Auto Scaling group.
|
4260
|
+
#
|
4261
|
+
# @option params [required, String] :policy_name
|
4262
|
+
# The name of the policy.
|
4263
|
+
#
|
4264
|
+
# @option params [required, Time,DateTime,Date,Integer,String] :start_time
|
4265
|
+
# The inclusive start time of the time range for the forecast data to
|
4266
|
+
# get. At most, the date and time can be one year before the current
|
4267
|
+
# date and time.
|
4268
|
+
#
|
4269
|
+
# @option params [required, Time,DateTime,Date,Integer,String] :end_time
|
4270
|
+
# The exclusive end time of the time range for the forecast data to get.
|
4271
|
+
# The maximum time duration between the start and end time is 30 days.
|
4272
|
+
#
|
4273
|
+
# Although this parameter can accept a date and time that is more than
|
4274
|
+
# two days in the future, the availability of forecast data has limits.
|
4275
|
+
# Amazon EC2 Auto Scaling only issues forecasts for periods of two days
|
4276
|
+
# in advance.
|
4277
|
+
#
|
4278
|
+
# @return [Types::GetPredictiveScalingForecastAnswer] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4279
|
+
#
|
4280
|
+
# * {Types::GetPredictiveScalingForecastAnswer#load_forecast #load_forecast} => Array<Types::LoadForecast>
|
4281
|
+
# * {Types::GetPredictiveScalingForecastAnswer#capacity_forecast #capacity_forecast} => Types::CapacityForecast
|
4282
|
+
# * {Types::GetPredictiveScalingForecastAnswer#update_time #update_time} => Time
|
4283
|
+
#
|
4284
|
+
# @example Request syntax with placeholder values
|
4285
|
+
#
|
4286
|
+
# resp = client.get_predictive_scaling_forecast({
|
4287
|
+
# auto_scaling_group_name: "XmlStringMaxLen255", # required
|
4288
|
+
# policy_name: "XmlStringMaxLen255", # required
|
4289
|
+
# start_time: Time.now, # required
|
4290
|
+
# end_time: Time.now, # required
|
4291
|
+
# })
|
4292
|
+
#
|
4293
|
+
# @example Response structure
|
4294
|
+
#
|
4295
|
+
# resp.load_forecast #=> Array
|
4296
|
+
# resp.load_forecast[0].timestamps #=> Array
|
4297
|
+
# resp.load_forecast[0].timestamps[0] #=> Time
|
4298
|
+
# resp.load_forecast[0].values #=> Array
|
4299
|
+
# resp.load_forecast[0].values[0] #=> Float
|
4300
|
+
# resp.load_forecast[0].metric_specification.target_value #=> Float
|
4301
|
+
# resp.load_forecast[0].metric_specification.predefined_metric_pair_specification.predefined_metric_type #=> String, one of "ASGCPUUtilization", "ASGNetworkIn", "ASGNetworkOut", "ALBRequestCount"
|
4302
|
+
# resp.load_forecast[0].metric_specification.predefined_metric_pair_specification.resource_label #=> String
|
4303
|
+
# resp.load_forecast[0].metric_specification.predefined_scaling_metric_specification.predefined_metric_type #=> String, one of "ASGAverageCPUUtilization", "ASGAverageNetworkIn", "ASGAverageNetworkOut", "ALBRequestCountPerTarget"
|
4304
|
+
# resp.load_forecast[0].metric_specification.predefined_scaling_metric_specification.resource_label #=> String
|
4305
|
+
# resp.load_forecast[0].metric_specification.predefined_load_metric_specification.predefined_metric_type #=> String, one of "ASGTotalCPUUtilization", "ASGTotalNetworkIn", "ASGTotalNetworkOut", "ALBTargetGroupRequestCount"
|
4306
|
+
# resp.load_forecast[0].metric_specification.predefined_load_metric_specification.resource_label #=> String
|
4307
|
+
# resp.capacity_forecast.timestamps #=> Array
|
4308
|
+
# resp.capacity_forecast.timestamps[0] #=> Time
|
4309
|
+
# resp.capacity_forecast.values #=> Array
|
4310
|
+
# resp.capacity_forecast.values[0] #=> Float
|
4311
|
+
# resp.update_time #=> Time
|
4312
|
+
#
|
4313
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/GetPredictiveScalingForecast AWS API Documentation
|
4314
|
+
#
|
4315
|
+
# @overload get_predictive_scaling_forecast(params = {})
|
4316
|
+
# @param [Hash] params ({})
|
4317
|
+
def get_predictive_scaling_forecast(params = {}, options = {})
|
4318
|
+
req = build_request(:get_predictive_scaling_forecast, params)
|
4319
|
+
req.send_request(options)
|
4320
|
+
end
|
4321
|
+
|
3964
4322
|
# Creates or updates a lifecycle hook for the specified Auto Scaling
|
3965
4323
|
# group.
|
3966
4324
|
#
|
@@ -4165,17 +4523,28 @@ module Aws::AutoScaling
|
|
4165
4523
|
req.send_request(options)
|
4166
4524
|
end
|
4167
4525
|
|
4168
|
-
# Creates or updates a scaling policy for an Auto Scaling group.
|
4526
|
+
# Creates or updates a scaling policy for an Auto Scaling group. Scaling
|
4527
|
+
# policies are used to scale an Auto Scaling group based on configurable
|
4528
|
+
# metrics. If no policies are defined, the dynamic scaling and
|
4529
|
+
# predictive scaling features are not used.
|
4169
4530
|
#
|
4170
|
-
# For more information about using scaling
|
4171
|
-
#
|
4172
|
-
#
|
4173
|
-
#
|
4531
|
+
# For more information about using dynamic scaling, see [Target tracking
|
4532
|
+
# scaling policies][1] and [Step and simple scaling policies][2] in the
|
4533
|
+
# *Amazon EC2 Auto Scaling User Guide*.
|
4534
|
+
#
|
4535
|
+
# For more information about using predictive scaling, see [Predictive
|
4536
|
+
# scaling for Amazon EC2 Auto Scaling][3] in the *Amazon EC2 Auto
|
4537
|
+
# Scaling User Guide*.
|
4538
|
+
#
|
4539
|
+
# You can view the scaling policies for an Auto Scaling group using the
|
4540
|
+
# DescribePolicies API call. If you are no longer using a scaling
|
4541
|
+
# policy, you can delete it by calling the DeletePolicy API.
|
4174
4542
|
#
|
4175
4543
|
#
|
4176
4544
|
#
|
4177
4545
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-target-tracking.html
|
4178
4546
|
# [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-simple-step.html
|
4547
|
+
# [3]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-predictive-scaling.html
|
4179
4548
|
#
|
4180
4549
|
# @option params [required, String] :auto_scaling_group_name
|
4181
4550
|
# The name of the Auto Scaling group.
|
@@ -4192,6 +4561,8 @@ module Aws::AutoScaling
|
|
4192
4561
|
#
|
4193
4562
|
# * `SimpleScaling` (default)
|
4194
4563
|
#
|
4564
|
+
# * `PredictiveScaling`
|
4565
|
+
#
|
4195
4566
|
# @option params [String] :adjustment_type
|
4196
4567
|
# Specifies how the scaling adjustment is interpreted (for example, an
|
4197
4568
|
# absolute number or a percentage). The valid values are
|
@@ -4278,7 +4649,7 @@ module Aws::AutoScaling
|
|
4278
4649
|
# `StepScaling`.
|
4279
4650
|
#
|
4280
4651
|
# @option params [Types::TargetTrackingConfiguration] :target_tracking_configuration
|
4281
|
-
# A target tracking scaling policy.
|
4652
|
+
# A target tracking scaling policy. Provides support for predefined or
|
4282
4653
|
# customized metrics.
|
4283
4654
|
#
|
4284
4655
|
# The following predefined metrics are available:
|
@@ -4314,6 +4685,22 @@ module Aws::AutoScaling
|
|
4314
4685
|
#
|
4315
4686
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-enable-disable-scaling-policy.html
|
4316
4687
|
#
|
4688
|
+
# @option params [Types::PredictiveScalingConfiguration] :predictive_scaling_configuration
|
4689
|
+
# A predictive scaling policy. Provides support for only predefined
|
4690
|
+
# metrics.
|
4691
|
+
#
|
4692
|
+
# Predictive scaling works with CPU utilization, network in/out, and the
|
4693
|
+
# Application Load Balancer request count.
|
4694
|
+
#
|
4695
|
+
# For more information, see [PredictiveScalingConfiguration][1] in the
|
4696
|
+
# *Amazon EC2 Auto Scaling API Reference*.
|
4697
|
+
#
|
4698
|
+
# Required if the policy type is `PredictiveScaling`.
|
4699
|
+
#
|
4700
|
+
#
|
4701
|
+
#
|
4702
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_PredictiveScalingConfiguration.html
|
4703
|
+
#
|
4317
4704
|
# @return [Types::PolicyARNType] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4318
4705
|
#
|
4319
4706
|
# * {Types::PolicyARNType#policy_arn #policy_arn} => String
|
@@ -4331,7 +4718,7 @@ module Aws::AutoScaling
|
|
4331
4718
|
# target_tracking_configuration: {
|
4332
4719
|
# predefined_metric_specification: {
|
4333
4720
|
# predefined_metric_type: "ALBRequestCountPerTarget",
|
4334
|
-
# resource_label: "app/
|
4721
|
+
# resource_label: "app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff",
|
4335
4722
|
# },
|
4336
4723
|
# target_value: 1000.0,
|
4337
4724
|
# },
|
@@ -4393,6 +4780,29 @@ module Aws::AutoScaling
|
|
4393
4780
|
# disable_scale_in: false,
|
4394
4781
|
# },
|
4395
4782
|
# enabled: false,
|
4783
|
+
# predictive_scaling_configuration: {
|
4784
|
+
# metric_specifications: [ # required
|
4785
|
+
# {
|
4786
|
+
# target_value: 1.0, # required
|
4787
|
+
# predefined_metric_pair_specification: {
|
4788
|
+
# predefined_metric_type: "ASGCPUUtilization", # required, accepts ASGCPUUtilization, ASGNetworkIn, ASGNetworkOut, ALBRequestCount
|
4789
|
+
# resource_label: "XmlStringMaxLen1023",
|
4790
|
+
# },
|
4791
|
+
# predefined_scaling_metric_specification: {
|
4792
|
+
# predefined_metric_type: "ASGAverageCPUUtilization", # required, accepts ASGAverageCPUUtilization, ASGAverageNetworkIn, ASGAverageNetworkOut, ALBRequestCountPerTarget
|
4793
|
+
# resource_label: "XmlStringMaxLen1023",
|
4794
|
+
# },
|
4795
|
+
# predefined_load_metric_specification: {
|
4796
|
+
# predefined_metric_type: "ASGTotalCPUUtilization", # required, accepts ASGTotalCPUUtilization, ASGTotalNetworkIn, ASGTotalNetworkOut, ALBTargetGroupRequestCount
|
4797
|
+
# resource_label: "XmlStringMaxLen1023",
|
4798
|
+
# },
|
4799
|
+
# },
|
4800
|
+
# ],
|
4801
|
+
# mode: "ForecastAndScale", # accepts ForecastAndScale, ForecastOnly
|
4802
|
+
# scheduling_buffer_time: 1,
|
4803
|
+
# max_capacity_breach_behavior: "HonorMaxCapacity", # accepts HonorMaxCapacity, IncreaseMaxCapacity
|
4804
|
+
# max_capacity_buffer: 1,
|
4805
|
+
# },
|
4396
4806
|
# })
|
4397
4807
|
#
|
4398
4808
|
# @example Response structure
|
@@ -4417,6 +4827,11 @@ module Aws::AutoScaling
|
|
4417
4827
|
# For more information, see [Scheduled scaling][1] in the *Amazon EC2
|
4418
4828
|
# Auto Scaling User Guide*.
|
4419
4829
|
#
|
4830
|
+
# You can view the scheduled actions for an Auto Scaling group using the
|
4831
|
+
# DescribeScheduledActions API call. If you are no longer using a
|
4832
|
+
# scheduled action, you can delete it by calling the
|
4833
|
+
# DeleteScheduledAction API.
|
4834
|
+
#
|
4420
4835
|
#
|
4421
4836
|
#
|
4422
4837
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/schedule_time.html
|
@@ -4527,6 +4942,94 @@ module Aws::AutoScaling
|
|
4527
4942
|
req.send_request(options)
|
4528
4943
|
end
|
4529
4944
|
|
4945
|
+
# Creates or updates a warm pool for the specified Auto Scaling group. A
|
4946
|
+
# warm pool is a pool of pre-initialized EC2 instances that sits
|
4947
|
+
# alongside the Auto Scaling group. Whenever your application needs to
|
4948
|
+
# scale out, the Auto Scaling group can draw on the warm pool to meet
|
4949
|
+
# its new desired capacity. For more information and example
|
4950
|
+
# configurations, see [Warm pools for Amazon EC2 Auto Scaling][1] in the
|
4951
|
+
# *Amazon EC2 Auto Scaling User Guide*.
|
4952
|
+
#
|
4953
|
+
# This operation must be called from the Region in which the Auto
|
4954
|
+
# Scaling group was created. This operation cannot be called on an Auto
|
4955
|
+
# Scaling group that has a mixed instances policy or a launch template
|
4956
|
+
# or launch configuration that requests Spot Instances.
|
4957
|
+
#
|
4958
|
+
# You can view the instances in the warm pool using the DescribeWarmPool
|
4959
|
+
# API call. If you are no longer using a warm pool, you can delete it by
|
4960
|
+
# calling the DeleteWarmPool API.
|
4961
|
+
#
|
4962
|
+
#
|
4963
|
+
#
|
4964
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-warm-pools.html
|
4965
|
+
#
|
4966
|
+
# @option params [required, String] :auto_scaling_group_name
|
4967
|
+
# The name of the Auto Scaling group.
|
4968
|
+
#
|
4969
|
+
# @option params [Integer] :max_group_prepared_capacity
|
4970
|
+
# Specifies the maximum number of instances that are allowed to be in
|
4971
|
+
# the warm pool or in any state except `Terminated` for the Auto Scaling
|
4972
|
+
# group. This is an optional property. Specify it only if you do not
|
4973
|
+
# want the warm pool size to be determined by the difference between the
|
4974
|
+
# group's maximum capacity and its desired capacity.
|
4975
|
+
#
|
4976
|
+
# If a value for `MaxGroupPreparedCapacity` is not specified, Amazon EC2
|
4977
|
+
# Auto Scaling launches and maintains the difference between the
|
4978
|
+
# group's maximum capacity and its desired capacity. If you specify a
|
4979
|
+
# value for `MaxGroupPreparedCapacity`, Amazon EC2 Auto Scaling uses the
|
4980
|
+
# difference between the `MaxGroupPreparedCapacity` and the desired
|
4981
|
+
# capacity instead.
|
4982
|
+
#
|
4983
|
+
# The size of the warm pool is dynamic. Only when
|
4984
|
+
# `MaxGroupPreparedCapacity` and `MinSize` are set to the same value
|
4985
|
+
# does the warm pool have an absolute size.
|
4986
|
+
#
|
4987
|
+
# If the desired capacity of the Auto Scaling group is higher than the
|
4988
|
+
# `MaxGroupPreparedCapacity`, the capacity of the warm pool is 0, unless
|
4989
|
+
# you specify a value for `MinSize`. To remove a value that you
|
4990
|
+
# previously set, include the property but specify -1 for the value.
|
4991
|
+
#
|
4992
|
+
# @option params [Integer] :min_size
|
4993
|
+
# Specifies the minimum number of instances to maintain in the warm
|
4994
|
+
# pool. This helps you to ensure that there is always a certain number
|
4995
|
+
# of warmed instances available to handle traffic spikes. Defaults to 0
|
4996
|
+
# if not specified.
|
4997
|
+
#
|
4998
|
+
# @option params [String] :pool_state
|
4999
|
+
# Sets the instance state to transition to after the lifecycle actions
|
5000
|
+
# are complete. Default is `Stopped`.
|
5001
|
+
#
|
5002
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
5003
|
+
#
|
5004
|
+
#
|
5005
|
+
# @example Example: To add a warm pool to an Auto Scaling group
|
5006
|
+
#
|
5007
|
+
# # This example adds a warm pool to the specified Auto Scaling group.
|
5008
|
+
#
|
5009
|
+
# resp = client.put_warm_pool({
|
5010
|
+
# auto_scaling_group_name: "my-auto-scaling-group",
|
5011
|
+
# min_size: 30,
|
5012
|
+
# pool_state: "Stopped",
|
5013
|
+
# })
|
5014
|
+
#
|
5015
|
+
# @example Request syntax with placeholder values
|
5016
|
+
#
|
5017
|
+
# resp = client.put_warm_pool({
|
5018
|
+
# auto_scaling_group_name: "XmlStringMaxLen255", # required
|
5019
|
+
# max_group_prepared_capacity: 1,
|
5020
|
+
# min_size: 1,
|
5021
|
+
# pool_state: "Stopped", # accepts Stopped, Running
|
5022
|
+
# })
|
5023
|
+
#
|
5024
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutWarmPool AWS API Documentation
|
5025
|
+
#
|
5026
|
+
# @overload put_warm_pool(params = {})
|
5027
|
+
# @param [Hash] params ({})
|
5028
|
+
def put_warm_pool(params = {}, options = {})
|
5029
|
+
req = build_request(:put_warm_pool, params)
|
5030
|
+
req.send_request(options)
|
5031
|
+
end
|
5032
|
+
|
4530
5033
|
# Records a heartbeat for the lifecycle action associated with the
|
4531
5034
|
# specified token or instance. This extends the timeout by the length of
|
4532
5035
|
# time defined using the PutLifecycleHook API call.
|
@@ -4552,12 +5055,12 @@ module Aws::AutoScaling
|
|
4552
5055
|
# 5. If you finish before the timeout period ends, complete the
|
4553
5056
|
# lifecycle action.
|
4554
5057
|
#
|
4555
|
-
# For more information, see [Auto Scaling lifecycle][1]
|
4556
|
-
# EC2 Auto Scaling User Guide*.
|
5058
|
+
# For more information, see [Amazon EC2 Auto Scaling lifecycle hooks][1]
|
5059
|
+
# in the *Amazon EC2 Auto Scaling User Guide*.
|
4557
5060
|
#
|
4558
5061
|
#
|
4559
5062
|
#
|
4560
|
-
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/
|
5063
|
+
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html
|
4561
5064
|
#
|
4562
5065
|
# @option params [required, String] :lifecycle_hook_name
|
4563
5066
|
# The name of the lifecycle hook.
|
@@ -4792,6 +5295,7 @@ module Aws::AutoScaling
|
|
4792
5295
|
end
|
4793
5296
|
|
4794
5297
|
# Updates the instance protection settings of the specified instances.
|
5298
|
+
# This operation cannot be called on instances in a warm pool.
|
4795
5299
|
#
|
4796
5300
|
# For more information about preventing instances that are part of an
|
4797
5301
|
# Auto Scaling group from terminating on scale in, see [Instance
|
@@ -4859,19 +5363,20 @@ module Aws::AutoScaling
|
|
4859
5363
|
end
|
4860
5364
|
|
4861
5365
|
# Starts a new instance refresh operation, which triggers a rolling
|
4862
|
-
# replacement of
|
4863
|
-
#
|
5366
|
+
# replacement of previously launched instances in the Auto Scaling group
|
5367
|
+
# with a new group of instances.
|
4864
5368
|
#
|
4865
|
-
#
|
5369
|
+
# This operation is part of the [instance refresh feature][1] in Amazon
|
5370
|
+
# EC2 Auto Scaling, which helps you update instances in your Auto
|
5371
|
+
# Scaling group after you make configuration changes.
|
5372
|
+
#
|
5373
|
+
# If the call succeeds, it creates a new instance refresh request with a
|
4866
5374
|
# unique ID that you can use to track its progress. To query its status,
|
4867
5375
|
# call the DescribeInstanceRefreshes API. To describe the instance
|
4868
5376
|
# refreshes that have already run, call the DescribeInstanceRefreshes
|
4869
5377
|
# API. To cancel an instance refresh operation in progress, use the
|
4870
5378
|
# CancelInstanceRefresh API.
|
4871
5379
|
#
|
4872
|
-
# For more information, see [Replacing Auto Scaling instances based on
|
4873
|
-
# an instance refresh][1] in the *Amazon EC2 Auto Scaling User Guide*.
|
4874
|
-
#
|
4875
5380
|
#
|
4876
5381
|
#
|
4877
5382
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html
|
@@ -5025,7 +5530,8 @@ module Aws::AutoScaling
|
|
5025
5530
|
end
|
5026
5531
|
|
5027
5532
|
# Terminates the specified instance and optionally adjusts the desired
|
5028
|
-
# group size.
|
5533
|
+
# group size. This operation cannot be called on instances in a warm
|
5534
|
+
# pool.
|
5029
5535
|
#
|
5030
5536
|
# This call simply makes a termination request. The instance is not
|
5031
5537
|
# terminated immediately. When an instance is terminated, the instance
|
@@ -5213,7 +5719,7 @@ module Aws::AutoScaling
|
|
5213
5719
|
#
|
5214
5720
|
# @option params [String] :health_check_type
|
5215
5721
|
# The service to use for the health checks. The valid values are `EC2`
|
5216
|
-
# and `ELB`. If you configure an Auto Scaling group to use ELB health
|
5722
|
+
# and `ELB`. If you configure an Auto Scaling group to use `ELB` health
|
5217
5723
|
# checks, it considers the instance unhealthy if it fails either the EC2
|
5218
5724
|
# status checks or the load balancer health checks.
|
5219
5725
|
#
|
@@ -5272,9 +5778,9 @@ module Aws::AutoScaling
|
|
5272
5778
|
#
|
5273
5779
|
# @option params [String] :service_linked_role_arn
|
5274
5780
|
# The Amazon Resource Name (ARN) of the service-linked role that the
|
5275
|
-
# Auto Scaling group uses to call other
|
5276
|
-
# more information, see [Service-linked roles][1] in the
|
5277
|
-
# Auto Scaling User Guide*.
|
5781
|
+
# Auto Scaling group uses to call other Amazon Web Services on your
|
5782
|
+
# behalf. For more information, see [Service-linked roles][1] in the
|
5783
|
+
# *Amazon EC2 Auto Scaling User Guide*.
|
5278
5784
|
#
|
5279
5785
|
#
|
5280
5786
|
#
|
@@ -5301,6 +5807,9 @@ module Aws::AutoScaling
|
|
5301
5807
|
#
|
5302
5808
|
# [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html
|
5303
5809
|
#
|
5810
|
+
# @option params [String] :context
|
5811
|
+
# Reserved.
|
5812
|
+
#
|
5304
5813
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
5305
5814
|
#
|
5306
5815
|
#
|
@@ -5384,6 +5893,7 @@ module Aws::AutoScaling
|
|
5384
5893
|
# service_linked_role_arn: "ResourceName",
|
5385
5894
|
# max_instance_lifetime: 1,
|
5386
5895
|
# capacity_rebalance: false,
|
5896
|
+
# context: "Context",
|
5387
5897
|
# })
|
5388
5898
|
#
|
5389
5899
|
# @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/UpdateAutoScalingGroup AWS API Documentation
|
@@ -5408,7 +5918,7 @@ module Aws::AutoScaling
|
|
5408
5918
|
params: params,
|
5409
5919
|
config: config)
|
5410
5920
|
context[:gem_name] = 'aws-sdk-autoscaling'
|
5411
|
-
context[:gem_version] = '1.
|
5921
|
+
context[:gem_version] = '1.64.0'
|
5412
5922
|
Seahorse::Client::Request.new(handlers, context)
|
5413
5923
|
end
|
5414
5924
|
|