Amazon EC2 Auto Scaling is designed to automatically launch or terminate EC2 instances based on user-defined scaling policies, scheduled actions, and health checks.
For more information about Amazon EC2 Auto Scaling, see the Amazon EC2 Auto Scaling User Guide. For information about granting IAM users required permissions for calls to Amazon EC2 Auto Scaling, see Granting IAM users required permissions for Amazon EC2 Auto Scaling resources in the Amazon EC2 Auto Scaling API Reference.
", + "service": "Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances based on user-defined scaling policies, scheduled actions, and health checks.
For more information, see the Amazon EC2 Auto Scaling User Guide and the Amazon EC2 Auto Scaling API Reference.
", "operations": { "AttachInstances": "Attaches one or more EC2 instances to the specified Auto Scaling group.
When you attach instances, Amazon EC2 Auto Scaling increases the desired capacity of the group by the number of instances being attached. If the number of instances being attached plus the desired capacity of the group exceeds the maximum size of the group, the operation fails.
If there is a Classic Load Balancer attached to your Auto Scaling group, the instances are also registered with the load balancer. If there are target groups attached to your Auto Scaling group, the instances are also registered with the target groups.
For more information, see Attach EC2 instances to your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
", - "AttachLoadBalancerTargetGroups": "Attaches one or more target groups to the specified Auto Scaling group.
This operation is used with the following load balancer types:
Application Load Balancer - Operates at the application layer (layer 7) and supports HTTP and HTTPS.
Network Load Balancer - Operates at the transport layer (layer 4) and supports TCP, TLS, and UDP.
Gateway Load Balancer - Operates at the network layer (layer 3).
To describe the target groups for an Auto Scaling group, call the DescribeLoadBalancerTargetGroups API. To detach the target group from the Auto Scaling group, call the DetachLoadBalancerTargetGroups API.
This operation is additive and does not detach existing target groups or Classic Load Balancers from the Auto Scaling group.
For more information, see Elastic Load Balancing and Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
", - "AttachLoadBalancers": "To attach an Application Load Balancer, Network Load Balancer, or Gateway Load Balancer, use the AttachLoadBalancerTargetGroups API operation instead.
Attaches one or more Classic Load Balancers to the specified Auto Scaling group. Amazon EC2 Auto Scaling registers the running instances with these Classic Load Balancers.
To describe the load balancers for an Auto Scaling group, call the DescribeLoadBalancers API. To detach the load balancer from the Auto Scaling group, call the DetachLoadBalancers API.
This operation is additive and does not detach existing Classic Load Balancers or target groups from the Auto Scaling group.
For more information, see Elastic Load Balancing and Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
", + "AttachLoadBalancerTargetGroups": "Attaches one or more target groups to the specified Auto Scaling group.
This operation is used with the following load balancer types:
Application Load Balancer - Operates at the application layer (layer 7) and supports HTTP and HTTPS.
Network Load Balancer - Operates at the transport layer (layer 4) and supports TCP, TLS, and UDP.
Gateway Load Balancer - Operates at the network layer (layer 3).
To describe the target groups for an Auto Scaling group, call the DescribeLoadBalancerTargetGroups API. To detach the target group from the Auto Scaling group, call the DetachLoadBalancerTargetGroups API.
This operation is additive and does not detach existing target groups or Classic Load Balancers from the Auto Scaling group.
For more information, see Use Elastic Load Balancing to distribute traffic across the instances in your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
", + "AttachLoadBalancers": "To attach an Application Load Balancer, Network Load Balancer, or Gateway Load Balancer, use the AttachLoadBalancerTargetGroups API operation instead.
Attaches one or more Classic Load Balancers to the specified Auto Scaling group. Amazon EC2 Auto Scaling registers the running instances with these Classic Load Balancers.
To describe the load balancers for an Auto Scaling group, call the DescribeLoadBalancers API. To detach a load balancer from the Auto Scaling group, call the DetachLoadBalancers API.
This operation is additive and does not detach existing Classic Load Balancers or target groups from the Auto Scaling group.
For more information, see Use Elastic Load Balancing to distribute traffic across the instances in your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
", "BatchDeleteScheduledAction": "Deletes one or more scheduled actions for the specified Auto Scaling group.
", "BatchPutScheduledUpdateGroupAction": "Creates or updates one or more scheduled scaling actions for an Auto Scaling group.
", "CancelInstanceRefresh": "Cancels an instance refresh operation in progress. Cancellation does not roll back any replacements that have already been completed, but it prevents new replacements from being started.
This operation is part of the instance refresh feature in Amazon EC2 Auto Scaling, which helps you update instances in your Auto Scaling group after you make configuration changes.
", "CompleteLifecycleAction": "Completes the lifecycle action for the specified token or instance with the specified result.
This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:
(Optional) Create a launch template or launch configuration with a user data script that runs while an instance is in a wait state due to a lifecycle hook.
(Optional) Create a Lambda function and a rule that allows Amazon EventBridge to invoke your Lambda function when an instance is put into a wait state due to a lifecycle hook.
(Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Amazon EC2 Auto Scaling to publish lifecycle notifications to the target.
Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.
If you need more time, record the lifecycle action heartbeat to keep the instance in a wait state.
If you finish before the timeout period ends, send a callback by using the CompleteLifecycleAction API call.
For more information, see Amazon EC2 Auto Scaling lifecycle hooks in the Amazon EC2 Auto Scaling User Guide.
", - "CreateAutoScalingGroup": "We strongly recommend using a launch template when calling this operation to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2.
Creates an Auto Scaling group with the specified name and attributes.
If you exceed your maximum limit of Auto Scaling groups, the call fails. To query this limit, call the DescribeAccountLimits API. For information about updating this limit, see Amazon EC2 Auto Scaling service quotas in the Amazon EC2 Auto Scaling User Guide.
For introductory exercises for creating an Auto Scaling group, see Getting started with Amazon EC2 Auto Scaling and Tutorial: Set up a scaled and load-balanced application in the Amazon EC2 Auto Scaling User Guide. For more information, see Auto Scaling groups in the Amazon EC2 Auto Scaling User Guide.
Every Auto Scaling group has three size parameters (DesiredCapacity, MaxSize, and MinSize). Usually, you set these sizes based on a specific number of instances. However, if you configure a mixed instances policy that defines weights for the instance types, you must specify these sizes with the same units that you use for weighting instances.
Creates a launch configuration.
If you exceed your maximum limit of launch configurations, the call fails. To query this limit, call the DescribeAccountLimits API. For information about updating this limit, see Amazon EC2 Auto Scaling service quotas in the Amazon EC2 Auto Scaling User Guide.
For more information, see Launch configurations in the Amazon EC2 Auto Scaling User Guide.
", - "CreateOrUpdateTags": "Creates or updates tags for the specified Auto Scaling group.
When you specify a tag with a key that already exists, the operation overwrites the previous tag definition, and you do not get an error message.
For more information, see Tagging Auto Scaling groups and instances in the Amazon EC2 Auto Scaling User Guide.
", + "CreateAutoScalingGroup": "We strongly recommend using a launch template when calling this operation to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2.
Creates an Auto Scaling group with the specified name and attributes.
If you exceed your maximum limit of Auto Scaling groups, the call fails. To query this limit, call the DescribeAccountLimits API. For information about updating this limit, see Quotas for Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
For introductory exercises for creating an Auto Scaling group, see Getting started with Amazon EC2 Auto Scaling and Tutorial: Set up a scaled and load-balanced application in the Amazon EC2 Auto Scaling User Guide. For more information, see Auto Scaling groups in the Amazon EC2 Auto Scaling User Guide.
Every Auto Scaling group has three size properties (DesiredCapacity, MaxSize, and MinSize). Usually, you set these sizes based on a specific number of instances. However, if you configure a mixed instances policy that defines weights for the instance types, you must specify these sizes with the same units that you use for weighting instances.
Creates a launch configuration.
If you exceed your maximum limit of launch configurations, the call fails. To query this limit, call the DescribeAccountLimits API. For information about updating this limit, see Quotas for Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
For more information, see Launch configurations in the Amazon EC2 Auto Scaling User Guide.
", + "CreateOrUpdateTags": "Creates or updates tags for the specified Auto Scaling group.
When you specify a tag with a key that already exists, the operation overwrites the previous tag definition, and you do not get an error message.
For more information, see Tag Auto Scaling groups and instances in the Amazon EC2 Auto Scaling User Guide.
", "DeleteAutoScalingGroup": "Deletes the specified Auto Scaling group.
If the group has instances or scaling activities in progress, you must specify the option to force the deletion in order for it to succeed.
If the group has policies, deleting the group deletes the policies, the underlying alarm actions, and any alarm that no longer has an associated action.
To remove instances from the Auto Scaling group before deleting it, call the DetachInstances API with the list of instances and the option to decrement the desired capacity. This ensures that Amazon EC2 Auto Scaling does not launch replacement instances.
To terminate all instances before deleting the Auto Scaling group, call the UpdateAutoScalingGroup API and set the minimum size and desired capacity of the Auto Scaling group to zero.
", "DeleteLaunchConfiguration": "Deletes the specified launch configuration.
The launch configuration must not be attached to an Auto Scaling group. When this call completes, the launch configuration is no longer available for use.
", "DeleteLifecycleHook": "Deletes the specified lifecycle hook.
If there are any outstanding lifecycle actions, they are completed first (ABANDON for launching instances, CONTINUE for terminating instances).
Deletes the specified scheduled action.
", "DeleteTags": "Deletes the specified tags.
", "DeleteWarmPool": "Deletes the warm pool for the specified Auto Scaling group.
For more information, see Warm pools for Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
", - "DescribeAccountLimits": "Describes the current Amazon EC2 Auto Scaling resource quotas for your account.
When you establish an Amazon Web Services account, the account has initial quotas on the maximum number of Auto Scaling groups and launch configurations that you can create in a given Region. For more information, see Amazon EC2 Auto Scaling service quotas in the Amazon EC2 Auto Scaling User Guide.
", + "DescribeAccountLimits": "Describes the current Amazon EC2 Auto Scaling resource quotas for your account.
When you establish an Amazon Web Services account, the account has initial quotas on the maximum number of Auto Scaling groups and launch configurations that you can create in a given Region. For more information, see Quotas for Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
", "DescribeAdjustmentTypes": "Describes the available adjustment types for step scaling and simple scaling policies.
The following adjustment types are supported:
ChangeInCapacity
ExactCapacity
PercentChangeInCapacity
Gets information about the Auto Scaling groups in the account and Region.
If you specify Auto Scaling group names, the output includes information for only the specified Auto Scaling groups. If you specify filters, the output includes information for only those Auto Scaling groups that meet the filter criteria. If you do not specify group names or filters, the output includes information for all Auto Scaling groups.
This operation also returns information about instances in Auto Scaling groups. To retrieve information about the instances in a warm pool, you must call the DescribeWarmPool API.
", "DescribeAutoScalingInstances": "Gets information about the Auto Scaling instances in the account and Region.
", @@ -29,22 +29,22 @@ "DescribeLaunchConfigurations": "Gets information about the launch configurations in the account and Region.
", "DescribeLifecycleHookTypes": "Describes the available types of lifecycle hooks.
The following hook types are supported:
autoscaling:EC2_INSTANCE_LAUNCHING
autoscaling:EC2_INSTANCE_TERMINATING
Gets information about the lifecycle hooks for the specified Auto Scaling group.
", - "DescribeLoadBalancerTargetGroups": "Gets information about the load balancer target groups for the specified Auto Scaling group.
To determine the availability of registered instances, use the State element in the response. When you attach a target group to an Auto Scaling group, the initial State value is Adding. The state transitions to Added after all Auto Scaling instances are registered with the target group. If Elastic Load Balancing health checks are enabled for the Auto Scaling group, the state transitions to InService after at least one Auto Scaling instance passes the health check. When the target group is in the InService state, Amazon EC2 Auto Scaling can terminate and replace any instances that are reported as unhealthy. If no registered instances pass the health checks, the target group doesn't enter the InService state.
Target groups also have an InService state if you attach them in the CreateAutoScalingGroup API call. If your target group state is InService, but it is not working properly, check the scaling activities by calling DescribeScalingActivities and take any corrective actions necessary.
For help with failed health checks, see Troubleshooting Amazon EC2 Auto Scaling: Health checks in the Amazon EC2 Auto Scaling User Guide. For more information, see Elastic Load Balancing and Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
", - "DescribeLoadBalancers": "Gets information about the load balancers for the specified Auto Scaling group.
This operation describes only Classic Load Balancers. If you have Application Load Balancers, Network Load Balancers, or Gateway Load Balancers, use the DescribeLoadBalancerTargetGroups API instead.
To determine the availability of registered instances, use the State element in the response. When you attach a load balancer to an Auto Scaling group, the initial State value is Adding. The state transitions to Added after all Auto Scaling instances are registered with the load balancer. If Elastic Load Balancing health checks are enabled for the Auto Scaling group, the state transitions to InService after at least one Auto Scaling instance passes the health check. When the load balancer is in the InService state, Amazon EC2 Auto Scaling can terminate and replace any instances that are reported as unhealthy. If no registered instances pass the health checks, the load balancer doesn't enter the InService state.
Load balancers also have an InService state if you attach them in the CreateAutoScalingGroup API call. If your load balancer state is InService, but it is not working properly, check the scaling activities by calling DescribeScalingActivities and take any corrective actions necessary.
For help with failed health checks, see Troubleshooting Amazon EC2 Auto Scaling: Health checks in the Amazon EC2 Auto Scaling User Guide. For more information, see Elastic Load Balancing and Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
", - "DescribeMetricCollectionTypes": "Describes the available CloudWatch metrics for Amazon EC2 Auto Scaling.
The GroupStandbyInstances metric is not returned by default. You must explicitly request this metric when calling the EnableMetricsCollection API.
Gets information about the Elastic Load Balancing target groups for the specified Auto Scaling group.
To determine the attachment status of the target group, use the State element in the response. When you attach a target group to an Auto Scaling group, the initial State value is Adding. The state transitions to Added after all Auto Scaling instances are registered with the target group. If Elastic Load Balancing health checks are enabled for the Auto Scaling group, the state transitions to InService after at least one Auto Scaling instance passes the health check. When the target group is in the InService state, Amazon EC2 Auto Scaling can terminate and replace any instances that are reported as unhealthy. If no registered instances pass the health checks, the target group doesn't enter the InService state.
Target groups also have an InService state if you attach them in the CreateAutoScalingGroup API call. If your target group state is InService, but it is not working properly, check the scaling activities by calling DescribeScalingActivities and take any corrective actions necessary.
For help with failed health checks, see Troubleshooting Amazon EC2 Auto Scaling: Health checks in the Amazon EC2 Auto Scaling User Guide. For more information, see Use Elastic Load Balancing to distribute traffic across the instances in your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
", + "DescribeLoadBalancers": "Gets information about the load balancers for the specified Auto Scaling group.
This operation describes only Classic Load Balancers. If you have Application Load Balancers, Network Load Balancers, or Gateway Load Balancer, use the DescribeLoadBalancerTargetGroups API instead.
To determine the attachment status of the load balancer, use the State element in the response. When you attach a load balancer to an Auto Scaling group, the initial State value is Adding. The state transitions to Added after all Auto Scaling instances are registered with the load balancer. If Elastic Load Balancing health checks are enabled for the Auto Scaling group, the state transitions to InService after at least one Auto Scaling instance passes the health check. When the load balancer is in the InService state, Amazon EC2 Auto Scaling can terminate and replace any instances that are reported as unhealthy. If no registered instances pass the health checks, the load balancer doesn't enter the InService state.
Load balancers also have an InService state if you attach them in the CreateAutoScalingGroup API call. If your load balancer state is InService, but it is not working properly, check the scaling activities by calling DescribeScalingActivities and take any corrective actions necessary.
For help with failed health checks, see Troubleshooting Amazon EC2 Auto Scaling: Health checks in the Amazon EC2 Auto Scaling User Guide. For more information, see Use Elastic Load Balancing to distribute traffic across the instances in your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
", + "DescribeMetricCollectionTypes": "Describes the available CloudWatch metrics for Amazon EC2 Auto Scaling.
", "DescribeNotificationConfigurations": "Gets information about the Amazon SNS notifications that are configured for one or more Auto Scaling groups.
", "DescribePolicies": "Gets information about the scaling policies in the account and Region.
", "DescribeScalingActivities": "Gets information about the scaling activities in the account and Region.
When scaling events occur, you see a record of the scaling activity in the scaling activities. For more information, see Verifying a scaling activity for an Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
If the scaling event succeeds, the value of the StatusCode element in the response is Successful. If an attempt to launch instances failed, the StatusCode value is Failed or Cancelled and the StatusMessage element in the response indicates the cause of the failure. For help interpreting the StatusMessage, see Troubleshooting Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
Describes the scaling process types for use with the ResumeProcesses and SuspendProcesses APIs.
", "DescribeScheduledActions": "Gets information about the scheduled actions that haven't run or that have not reached their end time.
To describe the scaling activities for scheduled actions that have already run, call the DescribeScalingActivities API.
", - "DescribeTags": "Describes the specified tags.
You can use filters to limit the results. For example, you can query for the tags for a specific Auto Scaling group. You can specify multiple values for a filter. A tag must match at least one of the specified values for it to be included in the results.
You can also specify multiple filters. The result includes information for a particular tag only if it matches all the filters. If there's no match, no special message is returned.
For more information, see Tagging Auto Scaling groups and instances in the Amazon EC2 Auto Scaling User Guide.
", - "DescribeTerminationPolicyTypes": "Describes the termination policies supported by Amazon EC2 Auto Scaling.
For more information, see Controlling which Auto Scaling instances terminate during scale in in the Amazon EC2 Auto Scaling User Guide.
", + "DescribeTags": "Describes the specified tags.
You can use filters to limit the results. For example, you can query for the tags for a specific Auto Scaling group. You can specify multiple values for a filter. A tag must match at least one of the specified values for it to be included in the results.
You can also specify multiple filters. The result includes information for a particular tag only if it matches all the filters. If there's no match, no special message is returned.
For more information, see Tag Auto Scaling groups and instances in the Amazon EC2 Auto Scaling User Guide.
", + "DescribeTerminationPolicyTypes": "Describes the termination policies supported by Amazon EC2 Auto Scaling.
For more information, see Work with Amazon EC2 Auto Scaling termination policies in the Amazon EC2 Auto Scaling User Guide.
", "DescribeWarmPool": "Gets information about a warm pool and its instances.
For more information, see Warm pools for Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
", "DetachInstances": "Removes one or more instances from the specified Auto Scaling group.
After the instances are detached, you can manage them independent of the Auto Scaling group.
If you do not specify the option to decrement the desired capacity, Amazon EC2 Auto Scaling launches instances to replace the ones that are detached.
If there is a Classic Load Balancer attached to the Auto Scaling group, the instances are deregistered from the load balancer. If there are target groups attached to the Auto Scaling group, the instances are deregistered from the target groups.
For more information, see Detach EC2 instances from your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
", - "DetachLoadBalancerTargetGroups": "Detaches one or more target groups from the specified Auto Scaling group.
", - "DetachLoadBalancers": "Detaches one or more Classic Load Balancers from the specified Auto Scaling group.
This operation detaches only Classic Load Balancers. If you have Application Load Balancers, Network Load Balancers, or Gateway Load Balancers, use the DetachLoadBalancerTargetGroups API instead.
When you detach a load balancer, it enters the Removing state while deregistering the instances in the group. When all instances are deregistered, then you can no longer describe the load balancer using the DescribeLoadBalancers API call. The instances remain running.
Disables group metrics for the specified Auto Scaling group.
", - "EnableMetricsCollection": "Enables group metrics for the specified Auto Scaling group. For more information, see Monitoring CloudWatch metrics for your Auto Scaling groups and instances in the Amazon EC2 Auto Scaling User Guide.
", + "DetachLoadBalancerTargetGroups": "Detaches one or more target groups from the specified Auto Scaling group.
When you detach a target group, it enters the Removing state while deregistering the instances in the group. When all instances are deregistered, then you can no longer describe the target group using the DescribeLoadBalancerTargetGroups API call. The instances remain running.
Detaches one or more Classic Load Balancers from the specified Auto Scaling group.
This operation detaches only Classic Load Balancers. If you have Application Load Balancers, Network Load Balancers, or Gateway Load Balancer, use the DetachLoadBalancerTargetGroups API instead.
When you detach a load balancer, it enters the Removing state while deregistering the instances in the group. When all instances are deregistered, then you can no longer describe the load balancer using the DescribeLoadBalancers API call. The instances remain running.
Disables group metrics collection for the specified Auto Scaling group.
", + "EnableMetricsCollection": "Enables group metrics collection for the specified Auto Scaling group.
You can use these metrics to track changes in an Auto Scaling group and to set alarms on threshold values. You can view group metrics using the Amazon EC2 Auto Scaling console or the CloudWatch console. For more information, see Monitor CloudWatch metrics for your Auto Scaling groups and instances in the Amazon EC2 Auto Scaling User Guide.
", "EnterStandby": "Moves the specified instances into the standby state.
If you choose to decrement the desired capacity of the Auto Scaling group, the instances can enter standby as long as the desired capacity of the Auto Scaling group after the instances are placed into standby is equal to or greater than the minimum capacity of the group.
If you choose not to decrement the desired capacity of the Auto Scaling group, the Auto Scaling group launches new instances to replace the instances on standby.
For more information, see Temporarily removing instances from your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
", "ExecutePolicy": "Executes the specified policy. This can be useful for testing the design of your scaling policy.
", "ExitStandby": "Moves the specified instances out of the standby state.
After you put the instances back in service, the desired capacity is incremented.
For more information, see Temporarily removing instances from your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
", @@ -52,7 +52,7 @@ "PutLifecycleHook": "Creates or updates a lifecycle hook for the specified Auto Scaling group.
Lifecycle hooks let you create solutions that are aware of events in the Auto Scaling instance lifecycle, and then perform a custom action on instances when the corresponding lifecycle event occurs.
This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:
(Optional) Create a launch template or launch configuration with a user data script that runs while an instance is in a wait state due to a lifecycle hook.
(Optional) Create a Lambda function and a rule that allows Amazon EventBridge to invoke your Lambda function when an instance is put into a wait state due to a lifecycle hook.
(Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Amazon EC2 Auto Scaling to publish lifecycle notifications to the target.
Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.
If you need more time, record the lifecycle action heartbeat to keep the instance in a wait state using the RecordLifecycleActionHeartbeat API call.
If you finish before the timeout period ends, send a callback by using the CompleteLifecycleAction API call.
For more information, see Amazon EC2 Auto Scaling lifecycle hooks in the Amazon EC2 Auto Scaling User Guide.
If you exceed your maximum limit of lifecycle hooks, which by default is 50 per Auto Scaling group, the call fails.
You can view the lifecycle hooks for an Auto Scaling group using the DescribeLifecycleHooks API call. If you are no longer using a lifecycle hook, you can delete it by calling the DeleteLifecycleHook API.
", "PutNotificationConfiguration": "Configures an Auto Scaling group to send notifications when specified events take place. Subscribers to the specified topic can have messages delivered to an endpoint such as a web server or an email address.
This configuration overwrites any existing configuration.
For more information, see Getting Amazon SNS notifications when your Auto Scaling group scales in the Amazon EC2 Auto Scaling User Guide.
If you exceed your maximum limit of SNS topics, which is 10 per Auto Scaling group, the call fails.
", "PutScalingPolicy": "Creates or updates a scaling policy for an Auto Scaling group. Scaling policies are used to scale an Auto Scaling group based on configurable metrics. If no policies are defined, the dynamic scaling and predictive scaling features are not used.
For more information about using dynamic scaling, see Target tracking scaling policies and Step and simple scaling policies in the Amazon EC2 Auto Scaling User Guide.
For more information about using predictive scaling, see Predictive scaling for Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
You can view the scaling policies for an Auto Scaling group using the DescribePolicies API call. If you are no longer using a scaling policy, you can delete it by calling the DeletePolicy API.
", - "PutScheduledUpdateGroupAction": "Creates or updates a scheduled scaling action for an Auto Scaling group.
For more information, see Scheduled scaling in the Amazon EC2 Auto Scaling User Guide.
You can view the scheduled actions for an Auto Scaling group using the DescribeScheduledActions API call. If you are no longer using a scheduled action, you can delete it by calling the DeleteScheduledAction API.
", + "PutScheduledUpdateGroupAction": "Creates or updates a scheduled scaling action for an Auto Scaling group.
For more information, see Scheduled scaling in the Amazon EC2 Auto Scaling User Guide.
You can view the scheduled actions for an Auto Scaling group using the DescribeScheduledActions API call. If you are no longer using a scheduled action, you can delete it by calling the DeleteScheduledAction API.
If you try to schedule your action in the past, Amazon EC2 Auto Scaling returns an error message.
", "PutWarmPool": "Creates or updates a warm pool for the specified Auto Scaling group. A warm pool is a pool of pre-initialized EC2 instances that sits alongside the Auto Scaling group. Whenever your application needs to scale out, the Auto Scaling group can draw on the warm pool to meet its new desired capacity. For more information and example configurations, see Warm pools for Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
This operation must be called from the Region in which the Auto Scaling group was created. This operation cannot be called on an Auto Scaling group that has a mixed instances policy or a launch template or launch configuration that requests Spot Instances.
You can view the instances in the warm pool using the DescribeWarmPool API call. If you are no longer using a warm pool, you can delete it by calling the DeleteWarmPool API.
", "RecordLifecycleActionHeartbeat": "Records a heartbeat for the lifecycle action associated with the specified token or instance. This extends the timeout by the length of time defined using the PutLifecycleHook API call.
This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:
(Optional) Create a launch template or launch configuration with a user data script that runs while an instance is in a wait state due to a lifecycle hook.
(Optional) Create a Lambda function and a rule that allows Amazon EventBridge to invoke your Lambda function when an instance is put into a wait state due to a lifecycle hook.
(Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Amazon EC2 Auto Scaling to publish lifecycle notifications to the target.
Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.
If you need more time, record the lifecycle action heartbeat to keep the instance in a wait state.
If you finish before the timeout period ends, send a callback by using the CompleteLifecycleAction API call.
For more information, see Amazon EC2 Auto Scaling lifecycle hooks in the Amazon EC2 Auto Scaling User Guide.
", "ResumeProcesses": "Resumes the specified suspended auto scaling processes, or all suspended process, for the specified Auto Scaling group.
For more information, see Suspending and resuming scaling processes in the Amazon EC2 Auto Scaling User Guide.
", @@ -62,7 +62,7 @@ "StartInstanceRefresh": "Starts a new instance refresh operation. An instance refresh performs a rolling replacement of all or some instances in an Auto Scaling group. Each instance is terminated first and then replaced, which temporarily reduces the capacity available within your Auto Scaling group.
This operation is part of the instance refresh feature in Amazon EC2 Auto Scaling, which helps you update instances in your Auto Scaling group. This feature is helpful, for example, when you have a new AMI or a new user data script. You just need to create a new launch template that specifies the new AMI or user data script. Then start an instance refresh to immediately begin the process of updating instances in the group.
If the call succeeds, it creates a new instance refresh request with a unique ID that you can use to track its progress. To query its status, call the DescribeInstanceRefreshes API. To describe the instance refreshes that have already run, call the DescribeInstanceRefreshes API. To cancel an instance refresh operation in progress, use the CancelInstanceRefresh API.
", "SuspendProcesses": "Suspends the specified auto scaling processes, or all processes, for the specified Auto Scaling group.
If you suspend either the Launch or Terminate process types, it can prevent other process types from functioning properly. For more information, see Suspending and resuming scaling processes in the Amazon EC2 Auto Scaling User Guide.
To resume processes that have been suspended, call the ResumeProcesses API.
", "TerminateInstanceInAutoScalingGroup": "Terminates the specified instance and optionally adjusts the desired group size. This operation cannot be called on instances in a warm pool.
This call simply makes a termination request. The instance is not terminated immediately. When an instance is terminated, the instance status changes to terminated. You can't connect to or start an instance after you've terminated it.
If you do not specify the option to decrement the desired capacity, Amazon EC2 Auto Scaling launches instances to replace the ones that are terminated.
By default, Amazon EC2 Auto Scaling balances instances across all Availability Zones. If you decrement the desired capacity, your Auto Scaling group can become unbalanced between Availability Zones. Amazon EC2 Auto Scaling tries to rebalance the group, and rebalancing might terminate instances in other zones. For more information, see Rebalancing activities in the Amazon EC2 Auto Scaling User Guide.
", - "UpdateAutoScalingGroup": "We strongly recommend that all Auto Scaling groups use launch templates to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2.
Updates the configuration for the specified Auto Scaling group.
To update an Auto Scaling group, specify the name of the group and the parameter that you want to change. Any parameters that you don't specify are not changed by this update request. The new settings take effect on any scaling activities after this call returns.
If you associate a new launch configuration or template with an Auto Scaling group, all new instances will get the updated configuration. Existing instances continue to run with the configuration that they were originally launched with. When you update a group to specify a mixed instances policy instead of a launch configuration or template, existing instances may be replaced to match the new purchasing options that you specified in the policy. For example, if the group currently has 100% On-Demand capacity and the policy specifies 50% Spot capacity, this means that half of your instances will be gradually terminated and relaunched as Spot Instances. When replacing instances, Amazon EC2 Auto Scaling launches new instances before terminating the old ones, so that updating your group does not compromise the performance or availability of your application.
Note the following about changing DesiredCapacity, MaxSize, or MinSize:
If a scale-in activity occurs as a result of a new DesiredCapacity value that is lower than the current size of the group, the Auto Scaling group uses its termination policy to determine which instances to terminate.
If you specify a new value for MinSize without specifying a value for DesiredCapacity, and the new MinSize is larger than the current size of the group, this sets the group's DesiredCapacity to the new MinSize value.
If you specify a new value for MaxSize without specifying a value for DesiredCapacity, and the new MaxSize is smaller than the current size of the group, this sets the group's DesiredCapacity to the new MaxSize value.
To see which parameters have been set, call the DescribeAutoScalingGroups API. To view the scaling policies for an Auto Scaling group, call the DescribePolicies API. If the group has scaling policies, you can update them by calling the PutScalingPolicy API.
" + "UpdateAutoScalingGroup": "We strongly recommend that all Auto Scaling groups use launch templates to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2.
Updates the configuration for the specified Auto Scaling group.
To update an Auto Scaling group, specify the name of the group and the property that you want to change. Any properties that you don't specify are not changed by this update request. The new settings take effect on any scaling activities after this call returns.
If you associate a new launch configuration or template with an Auto Scaling group, all new instances will get the updated configuration. Existing instances continue to run with the configuration that they were originally launched with. When you update a group to specify a mixed instances policy instead of a launch configuration or template, existing instances may be replaced to match the new purchasing options that you specified in the policy. For example, if the group currently has 100% On-Demand capacity and the policy specifies 50% Spot capacity, this means that half of your instances will be gradually terminated and relaunched as Spot Instances. When replacing instances, Amazon EC2 Auto Scaling launches new instances before terminating the old ones, so that updating your group does not compromise the performance or availability of your application.
Note the following about changing DesiredCapacity, MaxSize, or MinSize:
If a scale-in activity occurs as a result of a new DesiredCapacity value that is lower than the current size of the group, the Auto Scaling group uses its termination policy to determine which instances to terminate.
If you specify a new value for MinSize without specifying a value for DesiredCapacity, and the new MinSize is larger than the current size of the group, this sets the group's DesiredCapacity to the new MinSize value.
If you specify a new value for MaxSize without specifying a value for DesiredCapacity, and the new MaxSize is smaller than the current size of the group, this sets the group's DesiredCapacity to the new MaxSize value.
To see which properties have been set, call the DescribeAutoScalingGroups API. To view the scaling policies for an Auto Scaling group, call the DescribePolicies API. If the group has scaling policies, you can update them by calling the PutScalingPolicy API.
" }, "shapes": { "AcceleratorCountRequest": { @@ -142,7 +142,7 @@ "ActivityIds": { "base": null, "refs": { - "DescribeScalingActivitiesType$ActivityIds": "The activity IDs of the desired scaling activities. If you omit this parameter, all activities for the past six weeks are described. If unknown activities are requested, they are ignored with no error. If you specify an Auto Scaling group, the results are limited to that group.
Array Members: Maximum number of 50 IDs.
" + "DescribeScalingActivitiesType$ActivityIds": "The activity IDs of the desired scaling activities. If you omit this property, all activities for the past six weeks are described. If unknown activities are requested, they are ignored with no error. If you specify an Auto Scaling group, the results are limited to that group.
Array Members: Maximum number of 50 IDs.
" } }, "ActivityType": { @@ -195,8 +195,8 @@ "AssociatePublicIpAddress": { "base": null, "refs": { - "CreateLaunchConfigurationType$AssociatePublicIpAddress": "For Auto Scaling groups that are running in a virtual private cloud (VPC), specifies whether to assign a public IP address to the group's instances. If you specify true, each instance in the Auto Scaling group receives a unique public IP address. For more information, see Launching Auto Scaling instances in a VPC in the Amazon EC2 Auto Scaling User Guide.
If you specify this parameter, you must specify at least one subnet for VPCZoneIdentifier when you create your group.
If the instance is launched into a default subnet, the default is to assign a public IP address, unless you disabled the option to assign a public IP address on the subnet. If the instance is launched into a nondefault subnet, the default is not to assign a public IP address, unless you enabled the option to assign a public IP address on the subnet.
For Auto Scaling groups that are running in a VPC, specifies whether to assign a public IP address to the group's instances. For more information, see Launching Auto Scaling instances in a VPC in the Amazon EC2 Auto Scaling User Guide.
" + "CreateLaunchConfigurationType$AssociatePublicIpAddress": "Specifies whether to assign a public IPv4 address to the group's instances. If the instance is launched into a default subnet, the default is to assign a public IPv4 address, unless you disabled the option to assign a public IPv4 address on the subnet. If the instance is launched into a nondefault subnet, the default is not to assign a public IPv4 address, unless you enabled the option to assign a public IPv4 address on the subnet.
If you specify true, each instance in the Auto Scaling group receives a unique public IPv4 address. For more information, see Launching Auto Scaling instances in a VPC in the Amazon EC2 Auto Scaling User Guide.
If you specify this property, you must specify at least one subnet for VPCZoneIdentifier when you create your group.
Specifies whether to assign a public IPv4 address to the group's instances. If the instance is launched into a default subnet, the default is to assign a public IPv4 address, unless you disabled the option to assign a public IPv4 address on the subnet. If the instance is launched into a nondefault subnet, the default is not to assign a public IPv4 address, unless you enabled the option to assign a public IPv4 address on the subnet. For more information, see Launching Auto Scaling instances in a VPC in the Amazon EC2 Auto Scaling User Guide.
" } }, "AttachInstancesQuery": { @@ -235,7 +235,7 @@ "refs": { "AutoScalingGroup$DesiredCapacity": "The desired size of the group.
", "CreateAutoScalingGroupType$DesiredCapacity": "The desired capacity is the initial capacity of the Auto Scaling group at the time of its creation and the capacity it attempts to maintain. It can scale beyond this capacity if you configure auto scaling. This number must be greater than or equal to the minimum size of the group and less than or equal to the maximum size of the group. If you do not specify a desired capacity, the default is the minimum size of the group.
", - "PutScheduledUpdateGroupActionType$DesiredCapacity": "The desired capacity is the initial capacity of the Auto Scaling group after the scheduled action runs and the capacity it attempts to maintain. It can scale beyond this capacity if you add more scaling conditions.
", + "PutScheduledUpdateGroupActionType$DesiredCapacity": "The desired capacity is the initial capacity of the Auto Scaling group after the scheduled action runs and the capacity it attempts to maintain. It can scale beyond this capacity if you add more scaling conditions.
You must specify at least one of the following properties: MaxSize, MinSize, or DesiredCapacity.
The desired capacity is the initial capacity of the Auto Scaling group after the scheduled action runs and the capacity it attempts to maintain.
", "ScheduledUpdateGroupActionRequest$DesiredCapacity": "The desired capacity is the initial capacity of the Auto Scaling group after the scheduled action runs and the capacity it attempts to maintain.
", "SetDesiredCapacityType$DesiredCapacity": "The desired capacity is the initial capacity of the Auto Scaling group after this operation completes and the capacity it attempts to maintain.
", @@ -267,7 +267,7 @@ "AutoScalingGroupNames": { "base": null, "refs": { - "AutoScalingGroupNamesType$AutoScalingGroupNames": "The names of the Auto Scaling groups. By default, you can only specify up to 50 names. You can optionally increase this limit using the MaxRecords parameter.
If you omit this parameter, all Auto Scaling groups are described.
", + "AutoScalingGroupNamesType$AutoScalingGroupNames": "The names of the Auto Scaling groups. By default, you can only specify up to 50 names. You can optionally increase this limit using the MaxRecords property.
If you omit this property, all Auto Scaling groups are described.
", "DescribeNotificationConfigurationsType$AutoScalingGroupNames": "The name of the Auto Scaling group.
" } }, @@ -328,7 +328,7 @@ "base": null, "refs": { "AutoScalingGroup$AvailabilityZones": "One or more Availability Zones for the group.
", - "CreateAutoScalingGroupType$AvailabilityZones": "A list of Availability Zones where instances in the Auto Scaling group can be created. This parameter is optional if you specify one or more subnets for VPCZoneIdentifier.
Conditional: If your account supports EC2-Classic and VPC, this parameter is required to launch instances into EC2-Classic.
", + "CreateAutoScalingGroupType$AvailabilityZones": "A list of Availability Zones where instances in the Auto Scaling group can be created. Used for launching into the default VPC subnet in each Availability Zone when not using the VPCZoneIdentifier property, or for attaching a network interface when an existing network interface ID is specified in a launch template.
One or more Availability Zones for the group.
" } }, @@ -373,7 +373,7 @@ "BlockDeviceEbsEncrypted": { "base": null, "refs": { - "Ebs$Encrypted": "Specifies whether the volume should be encrypted. Encrypted EBS volumes can only be attached to instances that support Amazon EBS encryption. For more information, see Supported instance types. If your AMI uses encrypted volumes, you can also only launch it on supported instance types.
If you are creating a volume from a snapshot, you cannot create an unencrypted volume from an encrypted snapshot. Also, you cannot specify a KMS key ID when using a launch configuration.
If you enable encryption by default, the EBS volumes that you create are always encrypted, either using the Amazon Web Services managed KMS key or a customer-managed KMS key, regardless of whether the snapshot was encrypted.
For more information, see Using Amazon Web Services KMS keys to encrypt Amazon EBS volumes in the Amazon EC2 Auto Scaling User Guide.
Specifies whether the volume should be encrypted. Encrypted EBS volumes can only be attached to instances that support Amazon EBS encryption. For more information, see Supported instance types. If your AMI uses encrypted volumes, you can also only launch it on supported instance types.
If you are creating a volume from a snapshot, you cannot create an unencrypted volume from an encrypted snapshot. Also, you cannot specify a KMS key ID when using a launch configuration.
If you enable encryption by default, the EBS volumes that you create are always encrypted, either using the Amazon Web Services managed KMS key or a customer-managed KMS key, regardless of whether the snapshot was encrypted.
For more information, see Use Amazon Web Services KMS keys to encrypt Amazon EBS volumes in the Amazon EC2 Auto Scaling User Guide.
The volume type. For more information, see Amazon EBS volume types in the Amazon EC2 User Guide for Linux Instances.
Valid Values: standard | io1 | gp2 | st1 | sc1 | gp3
The volume type. For more information, see Amazon EBS volume types in the Amazon EC2 User Guide for Linux Instances.
Valid values: standard | io1 | gp2 | st1 | sc1 | gp3
A block device mapping, which specifies the block devices for the instance. You can specify virtual devices and EBS volumes. For more information, see Block Device Mapping in the Amazon EC2 User Guide for Linux Instances.
", - "LaunchConfiguration$BlockDeviceMappings": "A block device mapping, which specifies the block devices for the instance. For more information, see Block Device Mapping in the Amazon EC2 User Guide for Linux Instances.
" + "CreateLaunchConfigurationType$BlockDeviceMappings": "The block device mapping entries that define the block devices to attach to the instances at launch. By default, the block devices specified in the block device mapping for the AMI are used. For more information, see Block device mappings in the Amazon EC2 User Guide for Linux Instances.
", + "LaunchConfiguration$BlockDeviceMappings": "The block device mapping entries that define the block devices to attach to the instances at launch. By default, the block devices specified in the block device mapping for the AMI are used. For more information, see Block Device Mapping in the Amazon EC2 User Guide for Linux Instances.
" } }, "BurstablePerformance": { @@ -439,8 +439,8 @@ "base": null, "refs": { "AutoScalingGroup$CapacityRebalance": "Indicates whether Capacity Rebalancing is enabled.
", - "CreateAutoScalingGroupType$CapacityRebalance": "Indicates whether Capacity Rebalancing is enabled. Otherwise, Capacity Rebalancing is disabled. When you turn on Capacity Rebalancing, Amazon EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon EC2 notifies that a Spot Instance is at an elevated risk of interruption. After launching a new instance, it then terminates an old instance. For more information, see Amazon EC2 Auto Scaling Capacity Rebalancing in the Amazon EC2 Auto Scaling User Guide.
", - "UpdateAutoScalingGroupType$CapacityRebalance": "Enables or disables Capacity Rebalancing. For more information, see Amazon EC2 Auto Scaling Capacity Rebalancing in the Amazon EC2 Auto Scaling User Guide.
" + "CreateAutoScalingGroupType$CapacityRebalance": "Indicates whether Capacity Rebalancing is enabled. Otherwise, Capacity Rebalancing is disabled. When you turn on Capacity Rebalancing, Amazon EC2 Auto Scaling attempts to launch a Spot Instance whenever Amazon EC2 notifies that a Spot Instance is at an elevated risk of interruption. After launching a new instance, it then terminates an old instance. For more information, see Use Capacity Rebalancing to handle Amazon EC2 Spot Interruptions in the in the Amazon EC2 Auto Scaling User Guide.
", + "UpdateAutoScalingGroupType$CapacityRebalance": "Enables or disables Capacity Rebalancing. For more information, see Use Capacity Rebalancing to handle Amazon EC2 Spot Interruptions in the Amazon EC2 Auto Scaling User Guide.
" } }, "CheckpointDelay": { @@ -458,8 +458,8 @@ "ClassicLinkVPCSecurityGroups": { "base": null, "refs": { - "CreateLaunchConfigurationType$ClassicLinkVPCSecurityGroups": "EC2-Classic retires on August 15, 2022. This parameter is not supported after that date.
The IDs of one or more security groups for the specified ClassicLink-enabled VPC. For more information, see ClassicLink in the Amazon EC2 User Guide for Linux Instances.
If you specify the ClassicLinkVPCId parameter, you must specify this parameter.
EC2-Classic retires on August 15, 2022. This parameter is not supported after that date.
The IDs of one or more security groups for the VPC specified in ClassicLinkVPCId.
EC2-Classic retires on August 15, 2022. This property is not supported after that date.
The IDs of one or more security groups for the specified ClassicLink-enabled VPC.
If you specify the ClassicLinkVPCId property, you must specify ClassicLinkVPCSecurityGroups.
EC2-Classic retires on August 15, 2022. This property is not supported after that date.
The IDs of one or more security groups for the VPC specified in ClassicLinkVPCId.
Represents a CloudWatch metric of your choosing for a target tracking scaling policy to use with Amazon EC2 Auto Scaling.
To create your customized metric specification:
Add values for each required parameter from CloudWatch. You can use an existing metric, or a new metric that you create. To use your own metric, you must first publish the metric to CloudWatch. For more information, see Publish custom metrics in the Amazon CloudWatch User Guide.
Choose a metric that changes proportionally with capacity. The value of the metric should increase or decrease in inverse proportion to the number of capacity units. That is, the value of the metric should decrease when capacity increases.
For more information about the CloudWatch terminology below, see Amazon CloudWatch concepts.
Each individual service provides information about the metrics, namespace, and dimensions they use. For more information, see Amazon Web Services services that publish CloudWatch metrics in the Amazon CloudWatch User Guide.
Represents a CloudWatch metric of your choosing for a target tracking scaling policy to use with Amazon EC2 Auto Scaling.
To create your customized metric specification:
Add values for each required property from CloudWatch. You can use an existing metric, or a new metric that you create. To use your own metric, you must first publish the metric to CloudWatch. For more information, see Publish custom metrics in the Amazon CloudWatch User Guide.
Choose a metric that changes proportionally with capacity. The value of the metric should increase or decrease in inverse proportion to the number of capacity units. That is, the value of the metric should decrease when capacity increases.
For more information about the CloudWatch terminology below, see Amazon CloudWatch concepts.
Each individual service provides information about the metrics, namespace, and dimensions they use. For more information, see Amazon Web Services services that publish CloudWatch metrics in the Amazon CloudWatch User Guide.
A customized metric. You must specify either a predefined metric or a customized metric.
" } @@ -742,7 +742,7 @@ "Ebs": { "base": "Describes information used to set up an Amazon EBS volume specified in a block device mapping.
", "refs": { - "BlockDeviceMapping$Ebs": "Parameters used to automatically set up EBS volumes when an instance is launched.
You can specify either VirtualName or Ebs, but not both.
Information to attach an EBS volume to an instance at launch.
" } }, "EbsOptimized": { @@ -758,7 +758,7 @@ } }, "EnabledMetric": { - "base": "Describes an enabled metric.
", + "base": "Describes an enabled Auto Scaling group metric.
", "refs": { "EnabledMetrics$member": null } @@ -827,7 +827,7 @@ } }, "Filter": { - "base": "Describes a filter that is used to return a more specific list of results from a describe operation.
If you specify multiple filters, the filters are automatically logically joined with an AND, and the request returns only the results that match all of the specified filters.
For more information, see Tagging Auto Scaling groups and instances in the Amazon EC2 Auto Scaling User Guide.
", + "base": "Describes a filter that is used to return a more specific list of results from a describe operation.
If you specify multiple filters, the filters are automatically logically joined with an AND, and the request returns only the results that match all of the specified filters.
For more information, see Tag Auto Scaling groups and instances in the Amazon EC2 Auto Scaling User Guide.
", "refs": { "Filters$member": null } @@ -842,7 +842,7 @@ "ForceDelete": { "base": null, "refs": { - "DeleteAutoScalingGroupType$ForceDelete": "Specifies that the group is to be deleted along with all instances associated with the group, without waiting for all instances to be terminated. This parameter also deletes any outstanding lifecycle actions associated with the group.
", + "DeleteAutoScalingGroupType$ForceDelete": "Specifies that the group is to be deleted along with all instances associated with the group, without waiting for all instances to be terminated. This action also deletes any outstanding lifecycle actions associated with the group.
", "DeleteWarmPoolType$ForceDelete": "Specifies that the warm pool is to be deleted along with all of its associated instances, without waiting for all instances to be terminated. This parameter also deletes any outstanding lifecycle actions associated with the warm pool instances.
" } }, @@ -866,16 +866,16 @@ "base": null, "refs": { "AutoScalingGroup$HealthCheckGracePeriod": "The duration of the health check grace period, in seconds.
", - "CreateAutoScalingGroupType$HealthCheckGracePeriod": "
The amount of time, in seconds, that Amazon EC2 Auto Scaling waits before checking the health status of an EC2 instance that has come into service and marking it unhealthy due to a failed Elastic Load Balancing or custom health check. This is useful if your instances do not immediately pass these health checks after they enter the InService state. For more information, see Health check grace period in the Amazon EC2 Auto Scaling User Guide.
Default: 0 seconds
The amount of time, in seconds, that Amazon EC2 Auto Scaling waits before checking the health status of an EC2 instance that has come into service and marking it unhealthy due to a failed Elastic Load Balancing or custom health check. This is useful if your instances do not immediately pass these health checks after they enter the InService state. For more information, see Health check grace period in the Amazon EC2 Auto Scaling User Guide.
Default: 0 seconds
The amount of time, in seconds, that Amazon EC2 Auto Scaling waits before checking the health status of an EC2 instance that has come into service and marking it unhealthy due to a failed Elastic Load Balancing or custom health check. This is useful if your instances do not immediately pass these health checks after they enter the InService state. For more information, see Health check grace period in the Amazon EC2 Auto Scaling User Guide.
The maximum time, in seconds, that can elapse before the lifecycle hook times out. If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the action that you specified in the DefaultResult parameter.
The maximum time, in seconds, that can elapse before the lifecycle hook times out.
If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the action that you specified in the DefaultResult parameter. You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.
The maximum time, in seconds, that can elapse before the lifecycle hook times out. The range is from 30 to 7200 seconds. The default value is 3600 seconds (1 hour).
If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the action that you specified in the DefaultResult parameter. You can prevent the lifecycle hook from timing out by calling the RecordLifecycleActionHeartbeat API.
The maximum time, in seconds, that can elapse before the lifecycle hook times out. If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the action that you specified in the DefaultResult property.
The maximum time, in seconds, that can elapse before the lifecycle hook times out. The range is from 30 to 7200 seconds. The default value is 3600 seconds (1 hour).
The maximum time, in seconds, that can elapse before the lifecycle hook times out. The range is from 30 to 7200 seconds. The default value is 3600 seconds (1 hour).
The IDs of the instances. You can specify up to 20 instances.
", - "DescribeAutoScalingInstancesType$InstanceIds": "The IDs of the instances. If you omit this parameter, all Auto Scaling instances are described. If you specify an ID that does not exist, it is ignored with no error.
Array Members: Maximum number of 50 items.
", + "DescribeAutoScalingInstancesType$InstanceIds": "The IDs of the instances. If you omit this property, all Auto Scaling instances are described. If you specify an ID that does not exist, it is ignored with no error.
Array Members: Maximum number of 50 items.
", "DetachInstancesQuery$InstanceIds": "The IDs of the instances. You can specify up to 20 instances.
", "EnterStandbyQuery$InstanceIds": "The IDs of the instances. You can specify up to 20 instances.
", "ExitStandbyQuery$InstanceIds": "The IDs of the instances. You can specify up to 20 instances.
", @@ -1006,7 +1006,7 @@ "InstanceRefreshes": { "base": null, "refs": { - "DescribeInstanceRefreshesAnswer$InstanceRefreshes": "The instance refreshes for the specified group.
" + "DescribeInstanceRefreshesAnswer$InstanceRefreshes": "The instance refreshes for the specified group, sorted by creation timestamp in descending order.
" } }, "InstanceRequirements": { @@ -1032,7 +1032,7 @@ "InstancesDistribution": { "base": "Describes an instances distribution for an Auto Scaling group.
", "refs": { - "MixedInstancesPolicy$InstancesDistribution": "Specifies the instances distribution.
" + "MixedInstancesPolicy$InstancesDistribution": "The instances distribution.
" } }, "InstancesToUpdate": { @@ -1071,7 +1071,7 @@ "LaunchConfigurationNames": { "base": null, "refs": { - "LaunchConfigurationNamesType$LaunchConfigurationNames": "The launch configuration names. If you omit this parameter, all launch configurations are described.
Array Members: Maximum number of 50 items.
" + "LaunchConfigurationNamesType$LaunchConfigurationNames": "The launch configuration names. If you omit this property, all launch configurations are described.
Array Members: Maximum number of 50 items.
" } }, "LaunchConfigurationNamesType": { @@ -1093,7 +1093,7 @@ "LaunchTemplate": { "base": "Describes a launch template and overrides. You specify these properties as part of a mixed instances policy.
", "refs": { - "MixedInstancesPolicy$LaunchTemplate": "Specifies the launch template to use and the instance types (overrides) that are used to launch EC2 instances to fulfill On-Demand and Spot capacities. Required when creating a mixed instances policy.
" + "MixedInstancesPolicy$LaunchTemplate": "One or more launch templates and the instance types (overrides) that are used to launch EC2 instances to fulfill On-Demand and Spot capacities.
" } }, "LaunchTemplateName": { @@ -1113,7 +1113,7 @@ "refs": { "AutoScalingGroup$LaunchTemplate": "The launch template for the group.
", "AutoScalingInstanceDetails$LaunchTemplate": "The launch template for the instance.
", - "CreateAutoScalingGroupType$LaunchTemplate": "Parameters used to specify the launch template and version to use to launch instances.
Conditional: You must specify either a launch template (LaunchTemplate or MixedInstancesPolicy) or a launch configuration (LaunchConfigurationName or InstanceId).
The launch template that is specified must be configured for use with an Auto Scaling group. For more information, see Creating a launch template for an Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
Information used to specify the launch template and version to use to launch instances.
Conditional: You must specify either a launch template (LaunchTemplate or MixedInstancesPolicy) or a launch configuration (LaunchConfigurationName or InstanceId).
The launch template that is specified must be configured for use with an Auto Scaling group. For more information, see Creating a launch template for an Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
The launch template for the instance.
", "LaunchTemplate$LaunchTemplateSpecification": "The launch template to use.
", @@ -1124,10 +1124,10 @@ "LifecycleActionResult": { "base": null, "refs": { - "CompleteLifecycleActionType$LifecycleActionResult": "The action for the group to take. This parameter can be either CONTINUE or ABANDON.
Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. The possible values are CONTINUE and ABANDON.
Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. The valid values are CONTINUE and ABANDON. The default value is ABANDON.
Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. This parameter can be either CONTINUE or ABANDON. The default value is ABANDON.
The action for the group to take. You can specify either CONTINUE or ABANDON.
The action the Auto Scaling group takes when the lifecycle hook timeout elapses or if an unexpected failure occurs.
Valid values: CONTINUE | ABANDON
The action the Auto Scaling group takes when the lifecycle hook timeout elapses or if an unexpected failure occurs. The default value is ABANDON.
Valid values: CONTINUE | ABANDON
The action the Auto Scaling group takes when the lifecycle hook timeout elapses or if an unexpected failure occurs. The default value is ABANDON.
Valid values: CONTINUE | ABANDON
The names of one or more lifecycle hooks. If you omit this parameter, all lifecycle hooks are described.
" + "DescribeLifecycleHooksType$LifecycleHookNames": "The names of one or more lifecycle hooks. If you omit this property, all lifecycle hooks are described.
" } }, "LifecycleHookSpecification": { @@ -1158,7 +1158,7 @@ "LifecycleHookSpecifications": { "base": null, "refs": { - "CreateAutoScalingGroupType$LifecycleHookSpecificationList": "One or more lifecycle hooks for the group, which specify actions to perform when Amazon EC2 Auto Scaling launches or terminates instances.
" + "CreateAutoScalingGroupType$LifecycleHookSpecificationList": "One or more lifecycle hooks to add to the Auto Scaling group before instances are launched.
" } }, "LifecycleHooks": { @@ -1176,9 +1176,9 @@ "LifecycleTransition": { "base": null, "refs": { - "LifecycleHook$LifecycleTransition": "The state of the EC2 instance to which to attach the lifecycle hook. The following are possible values:
autoscaling:EC2_INSTANCE_LAUNCHING
autoscaling:EC2_INSTANCE_TERMINATING
The state of the EC2 instance to which you want to attach the lifecycle hook. The valid values are:
autoscaling:EC2_INSTANCE_LAUNCHING
autoscaling:EC2_INSTANCE_TERMINATING
The instance state to which you want to attach the lifecycle hook. The valid values are:
autoscaling:EC2_INSTANCE_LAUNCHING
autoscaling:EC2_INSTANCE_TERMINATING
Required for new lifecycle hooks, but optional when updating existing hooks.
" + "LifecycleHook$LifecycleTransition": "The lifecycle transition.
Valid values: autoscaling:EC2_INSTANCE_LAUNCHING | autoscaling:EC2_INSTANCE_TERMINATING
The lifecycle transition. For Auto Scaling groups, there are two major lifecycle transitions.
To create a lifecycle hook for scale-out events, specify autoscaling:EC2_INSTANCE_LAUNCHING.
To create a lifecycle hook for scale-in events, specify autoscaling:EC2_INSTANCE_TERMINATING.
The lifecycle transition. For Auto Scaling groups, there are two major lifecycle transitions.
To create a lifecycle hook for scale-out events, specify autoscaling:EC2_INSTANCE_LAUNCHING.
To create a lifecycle hook for scale-in events, specify autoscaling:EC2_INSTANCE_TERMINATING.
Required for new lifecycle hooks, but optional when updating existing hooks.
" } }, "LimitExceededFault": { @@ -1191,7 +1191,7 @@ "refs": { "AttachLoadBalancersType$LoadBalancerNames": "The names of the load balancers. You can specify up to 10 load balancers.
", "AutoScalingGroup$LoadBalancerNames": "One or more load balancers associated with the group.
", - "CreateAutoScalingGroupType$LoadBalancerNames": "A list of Classic Load Balancers associated with this Auto Scaling group. For Application Load Balancers, Network Load Balancers, and Gateway Load Balancers, specify the TargetGroupARNs property instead.
A list of Classic Load Balancers associated with this Auto Scaling group. For Application Load Balancers, Network Load Balancers, and Gateway Load Balancer, specify the TargetGroupARNs property instead.
The names of the load balancers. You can specify up to 10 load balancers.
" } }, @@ -1246,7 +1246,7 @@ "LocalStorageTypes": { "base": null, "refs": { - "InstanceRequirements$LocalStorageTypes": "Indicates the type of local storage that is required.
For instance types with hard disk drive (HDD) storage, specify hdd.
For instance types with solid state drive (SSD) storage, specify sdd.
Default: Any local storage type
" + "InstanceRequirements$LocalStorageTypes": "Indicates the type of local storage that is required.
For instance types with hard disk drive (HDD) storage, specify hdd.
For instance types with solid state drive (SSD) storage, specify ssd.
Default: Any local storage type
" } }, "MaxGroupPreparedCapacity": { @@ -1320,7 +1320,7 @@ "MetricCollectionTypes": { "base": null, "refs": { - "DescribeMetricCollectionTypesAnswer$Metrics": "One or more metrics.
" + "DescribeMetricCollectionTypesAnswer$Metrics": "The metrics.
" } }, "MetricDataQueries": { @@ -1428,8 +1428,8 @@ "Metrics": { "base": null, "refs": { - "DisableMetricsCollectionQuery$Metrics": "Specifies one or more of the following metrics:
GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupStandbyInstances
GroupTerminatingInstances
GroupTotalInstances
GroupInServiceCapacity
GroupPendingCapacity
GroupStandbyCapacity
GroupTerminatingCapacity
GroupTotalCapacity
WarmPoolDesiredCapacity
WarmPoolWarmedCapacity
WarmPoolPendingCapacity
WarmPoolTerminatingCapacity
WarmPoolTotalCapacity
GroupAndWarmPoolDesiredCapacity
GroupAndWarmPoolTotalCapacity
If you omit this parameter, all metrics are disabled.
", - "EnableMetricsCollectionQuery$Metrics": "Specifies which group-level metrics to start collecting. You can specify one or more of the following metrics:
GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupStandbyInstances
GroupTerminatingInstances
GroupTotalInstances
The instance weighting feature supports the following additional metrics:
GroupInServiceCapacity
GroupPendingCapacity
GroupStandbyCapacity
GroupTerminatingCapacity
GroupTotalCapacity
The warm pools feature supports the following additional metrics:
WarmPoolDesiredCapacity
WarmPoolWarmedCapacity
WarmPoolPendingCapacity
WarmPoolTerminatingCapacity
WarmPoolTotalCapacity
GroupAndWarmPoolDesiredCapacity
GroupAndWarmPoolTotalCapacity
If you omit this parameter, all metrics are enabled.
" + "DisableMetricsCollectionQuery$Metrics": "Identifies the metrics to disable.
You can specify one or more of the following metrics:
GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupStandbyInstances
GroupTerminatingInstances
GroupTotalInstances
GroupInServiceCapacity
GroupPendingCapacity
GroupStandbyCapacity
GroupTerminatingCapacity
GroupTotalCapacity
WarmPoolDesiredCapacity
WarmPoolWarmedCapacity
WarmPoolPendingCapacity
WarmPoolTerminatingCapacity
WarmPoolTotalCapacity
GroupAndWarmPoolDesiredCapacity
GroupAndWarmPoolTotalCapacity
If you omit this property, all metrics are disabled.
For more information, see Auto Scaling group metrics in the Amazon EC2 Auto Scaling User Guide.
", + "EnableMetricsCollectionQuery$Metrics": "Identifies the metrics to enable.
You can specify one or more of the following metrics:
GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupStandbyInstances
GroupTerminatingInstances
GroupTotalInstances
GroupInServiceCapacity
GroupPendingCapacity
GroupStandbyCapacity
GroupTerminatingCapacity
GroupTotalCapacity
WarmPoolDesiredCapacity
WarmPoolWarmedCapacity
WarmPoolPendingCapacity
WarmPoolTerminatingCapacity
WarmPoolTotalCapacity
GroupAndWarmPoolDesiredCapacity
GroupAndWarmPoolTotalCapacity
If you specify Granularity and don't specify any metrics, all metrics are enabled.
For more information, see Auto Scaling group metrics in the Amazon EC2 Auto Scaling User Guide.
" } }, "MinAdjustmentMagnitude": { @@ -1449,7 +1449,7 @@ "MixedInstanceSpotPrice": { "base": null, "refs": { - "InstancesDistribution$SpotMaxPrice": "The maximum price per unit hour that you are willing to pay for a Spot Instance. If you keep the value at its default (unspecified), Amazon EC2 Auto Scaling uses the On-Demand price as the maximum Spot price. To remove a value that you previously set, include the property but specify an empty string (\"\") for the value.
" + "InstancesDistribution$SpotMaxPrice": "The maximum price per unit hour that you are willing to pay for a Spot Instance. If you keep the value at its default (unspecified), Amazon EC2 Auto Scaling uses the On-Demand price as the maximum Spot price. To remove a value that you previously set, include the property but specify an empty string (\"\") for the value.
If your maximum price is lower than the Spot price for the instance types that you selected, your Spot Instances are not launched.
Valid Range: Minimum value of 0.001
" } }, "MixedInstancesPolicy": { @@ -1476,7 +1476,7 @@ "NoDevice": { "base": null, "refs": { - "BlockDeviceMapping$NoDevice": "Setting this value to true suppresses the specified device included in the block device mapping of the AMI.
If NoDevice is true for the root device, instances might fail the EC2 health check. In that case, Amazon EC2 Auto Scaling launches replacement instances.
If you specify NoDevice, you cannot specify Ebs.
Setting this value to true prevents a volume that is included in the block device mapping of the AMI from being mapped to the specified device name at launch.
If NoDevice is true for the root device, instances might fail the EC2 health check. In that case, Amazon EC2 Auto Scaling launches replacement instances.
The ARN of the target that Amazon EC2 Auto Scaling sends notifications to when an instance is in the transition state for the lifecycle hook. The notification target can be either an SQS queue or an SNS topic.
", - "LifecycleHookSpecification$NotificationTargetARN": "The ARN of the target that Amazon EC2 Auto Scaling sends notifications to when an instance is in the transition state for the lifecycle hook. The notification target can be either an SQS queue or an SNS topic.
", - "PutLifecycleHookType$NotificationTargetARN": "The ARN of the notification target that Amazon EC2 Auto Scaling uses to notify you when an instance is in the transition state for the lifecycle hook. This target can be either an SQS queue or an SNS topic.
If you specify an empty string, this overrides the current ARN.
This operation uses the JSON format when sending notifications to an Amazon SQS queue, and an email key-value pair format when sending notifications to an Amazon SNS topic.
When you specify a notification target, Amazon EC2 Auto Scaling sends it a test message. Test messages contain the following additional key-value pair: \"Event\": \"autoscaling:TEST_NOTIFICATION\".
The ARN of the target that Amazon EC2 Auto Scaling sends notifications to when an instance is in a wait state for the lifecycle hook.
", + "LifecycleHookSpecification$NotificationTargetARN": "The Amazon Resource Name (ARN) of the notification target that Amazon EC2 Auto Scaling sends notifications to when an instance is in a wait state for the lifecycle hook. You can specify an Amazon SNS topic or an Amazon SQS queue.
", + "PutLifecycleHookType$NotificationTargetARN": "The Amazon Resource Name (ARN) of the notification target that Amazon EC2 Auto Scaling uses to notify you when an instance is in a wait state for the lifecycle hook. You can specify either an Amazon SNS topic or an Amazon SQS queue.
If you specify an empty string, this overrides the current ARN.
This operation uses the JSON format when sending notifications to an Amazon SQS queue, and an email key-value pair format when sending notifications to an Amazon SNS topic.
When you specify a notification target, Amazon EC2 Auto Scaling sends it a test message. Test messages contain the following additional key-value pair: \"Event\": \"autoscaling:TEST_NOTIFICATION\".
The memory maximum in MiB.
", "BaselineEbsBandwidthMbpsRequest$Min": "The minimum value in Mbps.
", "BaselineEbsBandwidthMbpsRequest$Max": "The maximum value in Mbps.
", - "InstanceRequirements$SpotMaxPricePercentageOverLowestPrice": "The price protection threshold for Spot Instances. This is the maximum you’ll pay for a Spot Instance, expressed as a percentage higher than the cheapest M, C, or R instance type with your specified attributes. When Amazon EC2 Auto Scaling selects instance types with your attributes, we will exclude instance types whose price is higher than your threshold. The parameter accepts an integer, which Amazon EC2 Auto Scaling interprets as a percentage. To turn off price protection, specify a high value, such as 999999.
If you set DesiredCapacityType to vcpu or memory-mib, the price protection threshold is applied based on the per vCPU or per memory price instead of the per instance price.
Default: 100
The price protection threshold for On-Demand Instances. This is the maximum you’ll pay for an On-Demand Instance, expressed as a percentage higher than the cheapest M, C, or R instance type with your specified attributes. When Amazon EC2 Auto Scaling selects instance types with your attributes, we will exclude instance types whose price is higher than your threshold. The parameter accepts an integer, which Amazon EC2 Auto Scaling interprets as a percentage. To turn off price protection, specify a high value, such as 999999.
If you set DesiredCapacityType to vcpu or memory-mib, the price protection threshold is applied based on the per vCPU or per memory price instead of the per instance price.
Default: 20
The price protection threshold for Spot Instances. This is the maximum you’ll pay for a Spot Instance, expressed as a percentage higher than the least expensive current generation M, C, or R instance type with your specified attributes. When Amazon EC2 Auto Scaling selects instance types with your attributes, we will exclude instance types whose price is higher than your threshold. The parameter accepts an integer, which Amazon EC2 Auto Scaling interprets as a percentage. To turn off price protection, specify a high value, such as 999999.
If you set DesiredCapacityType to vcpu or memory-mib, the price protection threshold is applied based on the per vCPU or per memory price instead of the per instance price.
Default: 100
The price protection threshold for On-Demand Instances. This is the maximum you’ll pay for an On-Demand Instance, expressed as a percentage higher than the least expensive current generation M, C, or R instance type with your specified attributes. When Amazon EC2 Auto Scaling selects instance types with your attributes, we will exclude instance types whose price is higher than your threshold. The parameter accepts an integer, which Amazon EC2 Auto Scaling interprets as a percentage. To turn off price protection, specify a high value, such as 999999.
If you set DesiredCapacityType to vcpu or memory-mib, the price protection threshold is applied based on the per vCPU or per memory price instead of the per instance price.
Default: 20
The memory minimum in MiB.
", "MemoryMiBRequest$Max": "The memory maximum in MiB.
", "NetworkInterfaceCountRequest$Min": "The minimum number of network interfaces.
", @@ -1584,13 +1584,13 @@ "refs": { "PutScalingPolicyType$ScalingAdjustment": "The amount by which to scale, based on the specified adjustment type. A positive value adds to the current capacity while a negative number removes from the current capacity. For exact capacity, you must specify a positive value.
Required if the policy type is SimpleScaling. (Not used with any other policy type.)
The amount by which to scale, based on the specified adjustment type. A positive value adds to the current capacity while a negative number removes from the current capacity.
", - "StepAdjustment$ScalingAdjustment": "The amount by which to scale, based on the specified adjustment type. A positive value adds to the current capacity while a negative number removes from the current capacity.
" + "StepAdjustment$ScalingAdjustment": "The amount by which to scale, based on the specified adjustment type. A positive value adds to the current capacity while a negative number removes from the current capacity.
The amount by which to scale. The adjustment is based on the value that you specified in the AdjustmentType property (either an absolute number or a percentage). A positive value adds to the current capacity and a negative number subtracts from the current capacity.
The names of one or more policies. If you omit this parameter, all policies are described. If a group name is provided, the results are limited to that group. If you specify an unknown policy name, it is ignored with no error.
Array Members: Maximum number of 50 items.
" + "DescribePoliciesType$PolicyNames": "The names of one or more policies. If you omit this property, all policies are described. If a group name is provided, the results are limited to that group. If you specify an unknown policy name, it is ignored with no error.
Array Members: Maximum number of 50 items.
" } }, "PolicyTypes": { @@ -1720,7 +1720,7 @@ "ProcessNames": { "base": null, "refs": { - "ScalingProcessQuery$ScalingProcesses": "One or more of the following processes:
Launch
Terminate
AddToLoadBalancer
AlarmNotification
AZRebalance
HealthCheck
InstanceRefresh
ReplaceUnhealthy
ScheduledActions
If you omit this parameter, all processes are specified.
" + "ScalingProcessQuery$ScalingProcesses": "One or more of the following processes:
Launch
Terminate
AddToLoadBalancer
AlarmNotification
AZRebalance
HealthCheck
InstanceRefresh
ReplaceUnhealthy
ScheduledActions
If you omit this property, all processes are specified.
" } }, "ProcessType": { @@ -1841,7 +1841,7 @@ "AutoScalingGroup$AutoScalingGroupARN": "The Amazon Resource Name (ARN) of the Auto Scaling group.
", "AutoScalingGroup$ServiceLinkedRoleARN": "The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling group uses to call other Amazon Web Services on your behalf.
", "CompleteLifecycleActionType$AutoScalingGroupName": "The name of the Auto Scaling group.
", - "CreateAutoScalingGroupType$ServiceLinkedRoleARN": "The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling group uses to call other Amazon Web Services on your behalf. By default, Amazon EC2 Auto Scaling uses a service-linked role named AWSServiceRoleForAutoScaling, which it creates if it does not exist. For more information, see Service-linked roles in the Amazon EC2 Auto Scaling User Guide.
The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling group uses to call other Amazon Web Services service on your behalf. By default, Amazon EC2 Auto Scaling uses a service-linked role named AWSServiceRoleForAutoScaling, which it creates if it does not exist. For more information, see Service-linked roles in the Amazon EC2 Auto Scaling User Guide.
The name or Amazon Resource Name (ARN) of the policy.
", "ExecutePolicyType$PolicyName": "The name or ARN of the policy.
", "LaunchConfiguration$LaunchConfigurationARN": "The Amazon Resource Name (ARN) of the launch configuration.
", @@ -1904,7 +1904,7 @@ "base": null, "refs": { "BatchDeleteScheduledActionType$ScheduledActionNames": "The names of the scheduled actions to delete. The maximum number allowed is 50.
", - "DescribeScheduledActionsType$ScheduledActionNames": "The names of one or more scheduled actions. If you omit this parameter, all scheduled actions are described. If you specify an unknown scheduled action, it is ignored with no error.
Array Members: Maximum number of 50 actions.
" + "DescribeScheduledActionsType$ScheduledActionNames": "The names of one or more scheduled actions. If you omit this property, all scheduled actions are described. If you specify an unknown scheduled action, it is ignored with no error.
Array Members: Maximum number of 50 actions.
" } }, "ScheduledActionsType": { @@ -1939,7 +1939,7 @@ "SecurityGroups": { "base": null, "refs": { - "CreateLaunchConfigurationType$SecurityGroups": "A list that contains the security groups to assign to the instances in the Auto Scaling group.
[EC2-VPC] Specify the security group IDs. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.
[EC2-Classic] Specify either the security group names or the security group IDs. For more information, see Amazon EC2 Security Groups in the Amazon EC2 User Guide for Linux Instances.
", + "CreateLaunchConfigurationType$SecurityGroups": "A list that contains the security group IDs to assign to the instances in the Auto Scaling group. For more information, see Control traffic to resources using security groups in the Amazon Virtual Private Cloud User Guide.
", "LaunchConfiguration$SecurityGroups": "A list that contains the security groups to assign to the instances in the Auto Scaling group. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.
" } }, @@ -1997,7 +1997,7 @@ "SpotPrice": { "base": null, "refs": { - "CreateLaunchConfigurationType$SpotPrice": "The maximum hourly price to be paid for any Spot Instance launched to fulfill the request. Spot Instances are launched when the price you specify exceeds the current Spot price. For more information, see Requesting Spot Instances in the Amazon EC2 Auto Scaling User Guide.
When you change your maximum price by creating a new launch configuration, running instances will continue to run as long as the maximum price for those running instances is higher than the current Spot price.
The maximum hourly price to be paid for any Spot Instance launched to fulfill the request. Spot Instances are launched when the price you specify exceeds the current Spot price. For more information, see Request Spot Instances for fault-tolerant and flexible applications in the Amazon EC2 Auto Scaling User Guide.
Valid Range: Minimum value of 0.001
When you change your maximum price by creating a new launch configuration, running instances will continue to run as long as the maximum price for those running instances is higher than the current Spot price.
The maximum hourly price to be paid for any Spot Instance launched to fulfill the request. Spot Instances are launched when the price you specify exceeds the current Spot price. For more information, see Requesting Spot Instances in the Amazon EC2 Auto Scaling User Guide.
" } }, @@ -2072,7 +2072,7 @@ "Tags": { "base": null, "refs": { - "CreateAutoScalingGroupType$Tags": "One or more tags. You can tag your Auto Scaling group and propagate the tags to the Amazon EC2 instances it launches. Tags are not propagated to Amazon EBS volumes. To add tags to Amazon EBS volumes, specify the tags in a launch template but use caution. If the launch template specifies an instance tag with a key that is also specified for the Auto Scaling group, Amazon EC2 Auto Scaling overrides the value of that instance tag with the value specified by the Auto Scaling group. For more information, see Tagging Auto Scaling groups and instances in the Amazon EC2 Auto Scaling User Guide.
", + "CreateAutoScalingGroupType$Tags": "One or more tags. You can tag your Auto Scaling group and propagate the tags to the Amazon EC2 instances it launches. Tags are not propagated to Amazon EBS volumes. To add tags to Amazon EBS volumes, specify the tags in a launch template but use caution. If the launch template specifies an instance tag with a key that is also specified for the Auto Scaling group, Amazon EC2 Auto Scaling overrides the value of that instance tag with the value specified by the Auto Scaling group. For more information, see Tag Auto Scaling groups and instances in the Amazon EC2 Auto Scaling User Guide.
", "CreateOrUpdateTagsType$Tags": "One or more tags.
", "DeleteTagsType$Tags": "One or more tags.
" } @@ -2087,14 +2087,14 @@ "refs": { "AttachLoadBalancerTargetGroupsType$TargetGroupARNs": "The Amazon Resource Names (ARN) of the target groups. You can specify up to 10 target groups. To get the ARN of a target group, use the Elastic Load Balancing DescribeTargetGroups API operation.
", "AutoScalingGroup$TargetGroupARNs": "The Amazon Resource Names (ARN) of the target groups for your load balancer.
", - "CreateAutoScalingGroupType$TargetGroupARNs": "The Amazon Resource Names (ARN) of the target groups to associate with the Auto Scaling group. Instances are registered as targets in a target group, and traffic is routed to the target group. For more information, see Elastic Load Balancing and Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
", + "CreateAutoScalingGroupType$TargetGroupARNs": "The Amazon Resource Names (ARN) of the target groups to associate with the Auto Scaling group. Instances are registered as targets with the target groups. The target groups receive incoming traffic and route requests to one or more registered targets. For more information, see Use Elastic Load Balancing to distribute traffic across the instances in your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.
", "DetachLoadBalancerTargetGroupsType$TargetGroupARNs": "The Amazon Resource Names (ARN) of the target groups. You can specify up to 10 target groups.
" } }, "TargetTrackingConfiguration": { "base": "Represents a target tracking scaling policy configuration to use with Amazon EC2 Auto Scaling.
", "refs": { - "PutScalingPolicyType$TargetTrackingConfiguration": "A target tracking scaling policy. Provides support for predefined or custom metrics.
The following predefined metrics are available:
ASGAverageCPUUtilization
ASGAverageNetworkIn
ASGAverageNetworkOut
ALBRequestCountPerTarget
If you specify ALBRequestCountPerTarget for the metric, you must specify the ResourceLabel parameter with the PredefinedMetricSpecification.
For more information, see TargetTrackingConfiguration in the Amazon EC2 Auto Scaling API Reference.
Required if the policy type is TargetTrackingScaling.
A target tracking scaling policy. Provides support for predefined or custom metrics.
The following predefined metrics are available:
ASGAverageCPUUtilization
ASGAverageNetworkIn
ASGAverageNetworkOut
ALBRequestCountPerTarget
If you specify ALBRequestCountPerTarget for the metric, you must specify the ResourceLabel property with the PredefinedMetricSpecification.
For more information, see TargetTrackingConfiguration in the Amazon EC2 Auto Scaling API Reference.
Required if the policy type is TargetTrackingScaling.
A target tracking scaling policy.
" } }, @@ -2107,9 +2107,9 @@ "base": null, "refs": { "AutoScalingGroup$TerminationPolicies": "The termination policies for the group.
", - "CreateAutoScalingGroupType$TerminationPolicies": "A policy or a list of policies that are used to select the instance to terminate. These policies are executed in the order that you list them. For more information, see Controlling which Auto Scaling instances terminate during scale in in the Amazon EC2 Auto Scaling User Guide.
", + "CreateAutoScalingGroupType$TerminationPolicies": "A policy or a list of policies that are used to select the instance to terminate. These policies are executed in the order that you list them. For more information, see Work with Amazon EC2 Auto Scaling termination policies in the Amazon EC2 Auto Scaling User Guide.
Valid values: Default | AllocationStrategy | ClosestToNextInstanceHour | NewestInstance | OldestInstance | OldestLaunchConfiguration | OldestLaunchTemplate | arn:aws:lambda:region:account-id:function:my-function:my-alias
The termination policies supported by Amazon EC2 Auto Scaling: OldestInstance, OldestLaunchConfiguration, NewestInstance, ClosestToNextInstanceHour, Default, OldestLaunchTemplate, and AllocationStrategy.
A policy or a list of policies that are used to select the instances to terminate. The policies are executed in the order that you list them. For more information, see Controlling which Auto Scaling instances terminate during scale in in the Amazon EC2 Auto Scaling User Guide.
" + "UpdateAutoScalingGroupType$TerminationPolicies": "A policy or a list of policies that are used to select the instances to terminate. The policies are executed in the order that you list them. For more information, see Work with Amazon EC2 Auto Scaling termination policies in the Amazon EC2 Auto Scaling User Guide.
Valid values: Default | AllocationStrategy | ClosestToNextInstanceHour | NewestInstance | OldestInstance | OldestLaunchConfiguration | OldestLaunchTemplate | arn:aws:lambda:region:account-id:function:my-function:my-alias
The start time of the activity.
", "Activity$EndTime": "The end time of the activity.
", "AutoScalingGroup$CreatedTime": "The date and time the group was created.
", - "DescribeScheduledActionsType$StartTime": "The earliest scheduled start time to return. If scheduled action names are provided, this parameter is ignored.
", - "DescribeScheduledActionsType$EndTime": "The latest scheduled start time to return. If scheduled action names are provided, this parameter is ignored.
", + "DescribeScheduledActionsType$StartTime": "The earliest scheduled start time to return. If scheduled action names are provided, this property is ignored.
", + "DescribeScheduledActionsType$EndTime": "The latest scheduled start time to return. If scheduled action names are provided, this property is ignored.
", "GetPredictiveScalingForecastAnswer$UpdateTime": "The time the forecast was made.
", "GetPredictiveScalingForecastType$StartTime": "The inclusive start time of the time range for the forecast data to get. At most, the date and time can be one year before the current date and time.
", "GetPredictiveScalingForecastType$EndTime": "The exclusive end time of the time range for the forecast data to get. The maximum time duration between the start and end time is 30 days.
Although this parameter can accept a date and time that is more than two days in the future, the availability of forecast data has limits. Amazon EC2 Auto Scaling only issues forecasts for periods of two days in advance.
", @@ -2127,10 +2127,10 @@ "InstanceRefresh$EndTime": "The date and time at which the instance refresh ended.
", "LaunchConfiguration$CreatedTime": "The creation date and time for the launch configuration.
", "PredictiveScalingForecastTimestamps$member": null, - "PutScheduledUpdateGroupActionType$Time": "This parameter is no longer used.
", - "PutScheduledUpdateGroupActionType$StartTime": "The date and time for this action to start, in YYYY-MM-DDThh:mm:ssZ format in UTC/GMT only and in quotes (for example, \"2019-06-01T00:00:00Z\").
If you specify Recurrence and StartTime, Amazon EC2 Auto Scaling performs the action at this time, and then performs the action based on the specified recurrence.
If you try to schedule your action in the past, Amazon EC2 Auto Scaling returns an error message.
", - "PutScheduledUpdateGroupActionType$EndTime": "The date and time for the recurring schedule to end, in UTC.
", - "ScheduledUpdateGroupAction$Time": "This parameter is no longer used.
", + "PutScheduledUpdateGroupActionType$Time": "This property is no longer used.
", + "PutScheduledUpdateGroupActionType$StartTime": "The date and time for this action to start, in YYYY-MM-DDThh:mm:ssZ format in UTC/GMT only and in quotes (for example, \"2021-06-01T00:00:00Z\").
If you specify Recurrence and StartTime, Amazon EC2 Auto Scaling performs the action at this time, and then performs the action based on the specified recurrence.
The date and time for the recurring schedule to end, in UTC. For example, \"2021-06-01T00:00:00Z\".
This property is no longer used.
", "ScheduledUpdateGroupAction$StartTime": "The date and time in UTC for this action to start. For example, \"2019-06-01T00:00:00Z\".
The date and time in UTC for the recurring schedule to end. For example, \"2019-06-01T00:00:00Z\".
The date and time for the action to start, in YYYY-MM-DDThh:mm:ssZ format in UTC/GMT only and in quotes (for example, \"2019-06-01T00:00:00Z\").
If you specify Recurrence and StartTime, Amazon EC2 Auto Scaling performs the action at this time, and then performs the action based on the specified recurrence.
If you try to schedule the action in the past, Amazon EC2 Auto Scaling returns an error message.
", @@ -2221,8 +2221,8 @@ "DescribeWarmPoolType$NextToken": "The token for the next set of instances to return. (You received this token from a previous call.)
", "FailedScheduledUpdateGroupActionRequest$ErrorMessage": "The error message accompanying the error code.
", "Filter$Name": "The name of the filter.
The valid values for Name depend on which API operation you're using with the filter (DescribeAutoScalingGroups or DescribeTags).
DescribeAutoScalingGroups
Valid values for Name include the following:
tag-key - Accepts tag keys. The results only include information about the Auto Scaling groups associated with these tag keys.
tag-value - Accepts tag values. The results only include information about the Auto Scaling groups associated with these tag values.
tag:<key> - Accepts the key/value combination of the tag. Use the tag key in the filter name and the tag value as the filter value. The results only include information about the Auto Scaling groups associated with the specified key/value combination.
DescribeTags
Valid values for Name include the following:
auto-scaling-group - Accepts the names of Auto Scaling groups. The results only include information about the tags associated with these Auto Scaling groups.
key - Accepts tag keys. The results only include information about the tags associated with these tag keys.
value - Accepts tag values. The results only include information about the tags associated with these tag values.
propagate-at-launch - Accepts a Boolean value, which specifies whether tags propagate to instances at launch. The results only include information about the tags associated with the specified Boolean value.
The order of the launch template overrides to use in fulfilling On-Demand capacity.
If you specify lowest-price, Amazon EC2 Auto Scaling uses price to determine the order, launching the lowest price first.
If you specify prioritized, Amazon EC2 Auto Scaling uses the priority that you assigned to each launch template override, launching the highest priority first. If all your On-Demand capacity cannot be fulfilled using your highest priority instance, then Amazon EC2 Auto Scaling launches the remaining capacity using the second priority instance type, and so on.
Default: lowest-price for Auto Scaling groups that specify InstanceRequirements in the overrides and prioritized for Auto Scaling groups that don't.
Indicates how to allocate instances across Spot Instance pools.
If the allocation strategy is lowest-price, the Auto Scaling group launches instances using the Spot pools with the lowest price, and evenly allocates your instances across the number of Spot pools that you specify.
If the allocation strategy is capacity-optimized (recommended), the Auto Scaling group launches instances using Spot pools that are optimally chosen based on the available Spot capacity. Alternatively, you can use capacity-optimized-prioritized and set the order of instance types in the list of launch template overrides from highest to lowest priority (from first to last in the list). Amazon EC2 Auto Scaling honors the instance type priorities on a best-effort basis but optimizes for capacity first.
Default: lowest-price
The order of the launch template overrides to use in fulfilling On-Demand capacity.
If you specify lowest-price, Amazon EC2 Auto Scaling uses price to determine the order, launching the lowest price first.
If you specify prioritized, Amazon EC2 Auto Scaling uses the priority that you assigned to each launch template override, launching the highest priority first. If all your On-Demand capacity cannot be fulfilled using your highest priority instance, then Amazon EC2 Auto Scaling launches the remaining capacity using the second priority instance type, and so on.
Default: lowest-price for Auto Scaling groups that specify InstanceRequirements in the overrides and prioritized for Auto Scaling groups that don't.
Valid values: lowest-price | prioritized
Indicates how to allocate instances across Spot Instance pools.
If the allocation strategy is lowest-price, the Auto Scaling group launches instances using the Spot pools with the lowest price, and evenly allocates your instances across the number of Spot pools that you specify.
If the allocation strategy is capacity-optimized (recommended), the Auto Scaling group launches instances using Spot pools that are optimally chosen based on the available Spot capacity. Alternatively, you can use capacity-optimized-prioritized and set the order of instance types in the list of launch template overrides from highest to lowest priority (from first to last in the list). Amazon EC2 Auto Scaling honors the instance type priorities on a best-effort basis but optimizes for capacity first.
Default: lowest-price
Valid values: lowest-price | capacity-optimized | capacity-optimized-prioritized
The token for the next set of items to return. (You received this token from a previous call.)
", "LaunchConfigurationsType$NextToken": "A string that indicates that the response contains more items than can be returned in a single response. To receive additional items, specify this string for the NextToken value when requesting the next set of items. This value is null when there are no more items to return.
A string that indicates that the response contains more items than can be returned in a single response. To receive additional items, specify this string for the NextToken value when requesting the next set of items. This value is null when there are no more items to return.
The name or the Amazon Resource Name (ARN) of the instance profile associated with the IAM role for the instance. The instance profile contains the IAM role.
For more information, see IAM role for applications that run on Amazon EC2 instances in the Amazon EC2 Auto Scaling User Guide.
", + "CreateLaunchConfigurationType$IamInstanceProfile": "The name or the Amazon Resource Name (ARN) of the instance profile associated with the IAM role for the instance. The instance profile contains the IAM role. For more information, see IAM role for applications that run on Amazon EC2 instances in the Amazon EC2 Auto Scaling User Guide.
", "LaunchConfiguration$IamInstanceProfile": "The name or the Amazon Resource Name (ARN) of the instance profile associated with the IAM role for the instance. The instance profile contains the IAM role. For more information, see IAM role for applications that run on Amazon EC2 instances in the Amazon EC2 Auto Scaling User Guide.
", "TerminationPolicies$member": null } @@ -2265,7 +2265,7 @@ "AutoScalingInstanceDetails$InstanceId": "The ID of the instance.
", "CompleteLifecycleActionType$InstanceId": "The ID of the instance.
", "CreateAutoScalingGroupType$InstanceId": "The ID of the instance used to base the launch configuration on. If specified, Amazon EC2 Auto Scaling uses the configuration values from the specified instance to create a new launch configuration. To get the instance ID, use the Amazon EC2 DescribeInstances API operation. For more information, see Creating an Auto Scaling group using an EC2 instance in the Amazon EC2 Auto Scaling User Guide.
", - "CreateLaunchConfigurationType$InstanceId": "The ID of the instance to use to create the launch configuration. The new launch configuration derives attributes from the instance, except for the block device mapping.
To create a launch configuration with a block device mapping or override any other instance attributes, specify them as part of the same request.
For more information, see Creating a launch configuration using an EC2 instance in the Amazon EC2 Auto Scaling User Guide.
If you do not specify InstanceId, you must specify both ImageId and InstanceType.
The ID of the instance to use to create the launch configuration. The new launch configuration derives attributes from the instance, except for the block device mapping.
To create a launch configuration with a block device mapping or override any other instance attributes, specify them as part of the same request.
For more information, see Creating a launch configuration using an EC2 instance in the Amazon EC2 Auto Scaling User Guide.
", "Instance$InstanceId": "The ID of the instance.
", "InstanceIds$member": null, "RecordLifecycleActionHeartbeatType$InstanceId": "The ID of the instance.
", @@ -2277,8 +2277,8 @@ "base": null, "refs": { "AutoScalingGroup$VPCZoneIdentifier": "One or more subnet IDs, if applicable, separated by commas.
", - "CreateAutoScalingGroupType$VPCZoneIdentifier": "A comma-separated list of subnet IDs for a virtual private cloud (VPC) where instances in the Auto Scaling group can be created. If you specify VPCZoneIdentifier with AvailabilityZones, the subnets that you specify for this parameter must reside in those Availability Zones.
Conditional: If your account supports EC2-Classic and VPC, this parameter is required to launch instances into a VPC.
", - "UpdateAutoScalingGroupType$VPCZoneIdentifier": "A comma-separated list of subnet IDs for a virtual private cloud (VPC). If you specify VPCZoneIdentifier with AvailabilityZones, the subnets that you specify for this parameter must reside in those Availability Zones.
A comma-separated list of subnet IDs for a virtual private cloud (VPC) where instances in the Auto Scaling group can be created. If you specify VPCZoneIdentifier with AvailabilityZones, the subnets that you specify must reside in those Availability Zones.
A comma-separated list of subnet IDs for a virtual private cloud (VPC). If you specify VPCZoneIdentifier with AvailabilityZones, the subnets that you specify must reside in those Availability Zones.
The name of the Auto Scaling group.
", "BatchPutScheduledUpdateGroupActionType$AutoScalingGroupName": "The name of the Auto Scaling group.
", - "BlockDeviceMapping$VirtualName": "The name of the virtual device (for example, ephemeral0).
You can specify either VirtualName or Ebs, but not both.
The device name exposed to the EC2 instance (for example, /dev/sdh or xvdh). For more information, see Device Naming on Linux Instances in the Amazon EC2 User Guide for Linux Instances.
The name of the instance store volume (virtual device) to attach to an instance at launch. The name must be in the form ephemeralX where X is a number starting from zero (0), for example, ephemeral0.
The device name assigned to the volume (for example, /dev/sdh or xvdh). For more information, see Device naming on Linux instances in the Amazon EC2 User Guide for Linux Instances.
To define a block device mapping, set the device name and exactly one of the following properties: Ebs, NoDevice, or VirtualName.
The instance refresh ID.
", "CancelInstanceRefreshType$AutoScalingGroupName": "The name of the Auto Scaling group.
", "ClassicLinkVPCSecurityGroups$member": null, "CreateAutoScalingGroupType$AutoScalingGroupName": "The name of the Auto Scaling group. This name must be unique per Region per account.
", "CreateAutoScalingGroupType$LaunchConfigurationName": "The name of the launch configuration to use to launch instances.
Conditional: You must specify either a launch template (LaunchTemplate or MixedInstancesPolicy) or a launch configuration (LaunchConfigurationName or InstanceId).
The name of an existing placement group into which to launch your instances. For more information, see Placement groups in the Amazon EC2 User Guide for Linux Instances.
A cluster placement group is a logical grouping of instances within a single Availability Zone. You cannot specify multiple Availability Zones and a cluster placement group.
The name of the placement group into which to launch your instances. For more information, see Placement groups in the Amazon EC2 User Guide for Linux Instances.
A cluster placement group is a logical grouping of instances within a single Availability Zone. You cannot specify multiple Availability Zones and a cluster placement group.
The unit of measurement for the value specified for desired capacity. Amazon EC2 Auto Scaling supports DesiredCapacityType for attribute-based instance type selection only. For more information, see Creating an Auto Scaling group using attribute-based instance type selection in the Amazon EC2 Auto Scaling User Guide.
By default, Amazon EC2 Auto Scaling specifies units, which translates into number of instances.
Valid values: units | vcpu | memory-mib
The name of the launch configuration. This name must be unique per Region per account.
", - "CreateLaunchConfigurationType$ImageId": "The ID of the Amazon Machine Image (AMI) that was assigned during registration. For more information, see Finding an AMI in the Amazon EC2 User Guide for Linux Instances.
If you do not specify InstanceId, you must specify ImageId.
The name of the key pair. For more information, see Amazon EC2 Key Pairs in the Amazon EC2 User Guide for Linux Instances.
", - "CreateLaunchConfigurationType$ClassicLinkVPCId": "EC2-Classic retires on August 15, 2022. This parameter is not supported after that date.
The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. For more information, see ClassicLink in the Amazon EC2 User Guide for Linux Instances.
", - "CreateLaunchConfigurationType$InstanceType": "Specifies the instance type of the EC2 instance.
For information about available instance types, see Available Instance Types in the Amazon EC2 User Guide for Linux Instances.
If you do not specify InstanceId, you must specify InstanceType.
The ID of the kernel associated with the AMI.
", - "CreateLaunchConfigurationType$RamdiskId": "The ID of the RAM disk to select.
", + "CreateLaunchConfigurationType$ImageId": "The ID of the Amazon Machine Image (AMI) that was assigned during registration. For more information, see Finding a Linux AMI in the Amazon EC2 User Guide for Linux Instances.
If you specify InstanceId, an ImageId is not required.
The name of the key pair. For more information, see Amazon EC2 key pairs and Linux instances in the Amazon EC2 User Guide for Linux Instances.
", + "CreateLaunchConfigurationType$ClassicLinkVPCId": "EC2-Classic retires on August 15, 2022. This property is not supported after that date.
The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. For more information, see ClassicLink in the Amazon EC2 User Guide for Linux Instances.
", + "CreateLaunchConfigurationType$InstanceType": "Specifies the instance type of the EC2 instance. For information about available instance types, see Available instance types in the Amazon EC2 User Guide for Linux Instances.
If you specify InstanceId, an InstanceType is not required.
The ID of the kernel associated with the AMI.
We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see User provided kernels in the Amazon EC2 User Guide for Linux Instances.
The ID of the RAM disk to select.
We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see User provided kernels in the Amazon EC2 User Guide for Linux Instances.
The name of the Auto Scaling group.
", "DeleteLifecycleHookType$AutoScalingGroupName": "The name of the Auto Scaling group.
", "DeleteNotificationConfigurationType$AutoScalingGroupName": "The name of the Auto Scaling group.
", @@ -2345,8 +2345,8 @@ "DisableMetricsCollectionQuery$AutoScalingGroupName": "The name of the Auto Scaling group.
", "Ebs$SnapshotId": "The snapshot ID of the volume to use.
You must specify either a VolumeSize or a SnapshotId.
The name of the Auto Scaling group.
", - "EnableMetricsCollectionQuery$Granularity": "The granularity to associate with the metrics to collect. The only valid value is 1Minute.
One of the following metrics:
GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupStandbyInstances
GroupTerminatingInstances
GroupTotalInstances
GroupInServiceCapacity
GroupPendingCapacity
GroupStandbyCapacity
GroupTerminatingCapacity
GroupTotalCapacity
WarmPoolDesiredCapacity
WarmPoolWarmedCapacity
WarmPoolPendingCapacity
WarmPoolTerminatingCapacity
WarmPoolTotalCapacity
GroupAndWarmPoolDesiredCapacity
GroupAndWarmPoolTotalCapacity
The frequency at which Amazon EC2 Auto Scaling sends aggregated data to CloudWatch. The only valid value is 1Minute.
One of the following metrics:
GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupStandbyInstances
GroupTerminatingInstances
GroupTotalInstances
GroupInServiceCapacity
GroupPendingCapacity
GroupStandbyCapacity
GroupTerminatingCapacity
GroupTotalCapacity
WarmPoolDesiredCapacity
WarmPoolWarmedCapacity
WarmPoolPendingCapacity
WarmPoolTerminatingCapacity
WarmPoolTotalCapacity
GroupAndWarmPoolDesiredCapacity
GroupAndWarmPoolTotalCapacity
For more information, see Auto Scaling group metrics in the Amazon EC2 Auto Scaling User Guide.
", "EnabledMetric$Granularity": "The granularity of the metric. The only valid value is 1Minute.
The name of the Auto Scaling group.
", "ExecutePolicyType$AutoScalingGroupName": "The name of the Auto Scaling group.
", @@ -2363,10 +2363,10 @@ "InstanceRefreshInProgressFault$message": null, "InvalidNextToken$message": "", "LaunchConfiguration$LaunchConfigurationName": "The name of the launch configuration.
", - "LaunchConfiguration$ImageId": "The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances. For more information, see Finding an AMI in the Amazon EC2 User Guide for Linux Instances.
", + "LaunchConfiguration$ImageId": "The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances. For more information, see Find a Linux AMI in the Amazon EC2 User Guide for Linux Instances.
", "LaunchConfiguration$KeyName": "The name of the key pair.
For more information, see Amazon EC2 Key Pairs in the Amazon EC2 User Guide for Linux Instances.
", - "LaunchConfiguration$ClassicLinkVPCId": "EC2-Classic retires on August 15, 2022. This parameter is not supported after that date.
The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to.
", - "LaunchConfiguration$InstanceType": "The instance type for the instances.
For information about available instance types, see Available Instance Types in the Amazon EC2 User Guide for Linux Instances.
", + "LaunchConfiguration$ClassicLinkVPCId": "EC2-Classic retires on August 15, 2022. This property is not supported after that date.
The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to.
", + "LaunchConfiguration$InstanceType": "The instance type for the instances. For information about available instance types, see Available instance types in the Amazon EC2 User Guide for Linux Instances.
", "LaunchConfiguration$KernelId": "The ID of the kernel associated with the AMI.
", "LaunchConfiguration$RamdiskId": "The ID of the RAM disk associated with the AMI.
", "LaunchConfigurationNameType$LaunchConfigurationName": "The name of the launch configuration.
", @@ -2376,7 +2376,7 @@ "LaunchTemplateSpecification$Version": "The version number, $Latest, or $Default. To get the version number, use the Amazon EC2 DescribeLaunchTemplateVersions API operation. New launch template versions can be created using the Amazon EC2 CreateLaunchTemplateVersion API. If the value is $Latest, Amazon EC2 Auto Scaling selects the latest version of the launch template when launching instances. If the value is $Default, Amazon EC2 Auto Scaling selects the default version of the launch template when launching instances. The default value is $Default.
The name of the Auto Scaling group for the lifecycle hook.
", "LifecycleHook$RoleARN": "The ARN of the IAM role that allows the Auto Scaling group to publish to the specified notification target (an Amazon SNS topic or an Amazon SQS queue).
", - "LifecycleHookSpecification$RoleARN": "The ARN of the IAM role that allows the Auto Scaling group to publish to the specified notification target.
Valid only if the notification target is an Amazon SNS topic or an Amazon SQS queue. Required for new lifecycle hooks, but optional when updating existing hooks.
", + "LifecycleHookSpecification$RoleARN": "The ARN of the IAM role that allows the Auto Scaling group to publish to the specified notification target. For information about creating this role, see Configure a notification target for a lifecycle hook in the Amazon EC2 Auto Scaling User Guide.
Valid only if the notification target is an Amazon SNS topic or an Amazon SQS queue.
", "LimitExceededFault$message": "", "LoadBalancerNames$member": null, "LoadBalancerState$LoadBalancerName": "The name of the load balancer.
", @@ -2435,7 +2435,7 @@ "base": null, "refs": { "AutoScalingGroup$HealthCheckType": "The service to use for the health checks. The valid values are EC2 and ELB. If you configure an Auto Scaling group to use ELB health checks, it considers the instance unhealthy if it fails either the EC2 status checks or the load balancer health checks.
The lifecycle state for the instance. The Quarantined state is not used. For information about lifecycle states, see Instance lifecycle in the Amazon EC2 Auto Scaling User Guide.
Valid Values: 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
The lifecycle state for the instance. The Quarantined state is not used. For information about lifecycle states, see Instance lifecycle in the Amazon EC2 Auto Scaling User Guide.
Valid values: 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
The last reported health status of this instance. \"Healthy\" means that the instance is healthy and should remain in service. \"Unhealthy\" means that the instance is unhealthy and Amazon EC2 Auto Scaling should terminate and replace it.
", "AutoScalingInstanceDetails$WeightedCapacity": "The number of capacity units contributed by the instance based on its instance type.
Valid Range: Minimum value of 1. Maximum value of 999.
", "CreateAutoScalingGroupType$HealthCheckType": "The service to use for the health checks. The valid values are EC2 (default) and ELB. If you configure an Auto Scaling group to use load balancer (ELB) health checks, it considers the instance unhealthy if it fails either the EC2 status checks or the load balancer health checks. For more information, see Health checks for Auto Scaling instances in the Amazon EC2 Auto Scaling User Guide.
The tenancy of the instance. An instance with dedicated tenancy runs on isolated, single-tenant hardware and can only be launched into a VPC.
To launch dedicated instances into a shared tenancy VPC (a VPC with the instance placement tenancy attribute set to default), you must set the value of this parameter to dedicated.
If you specify PlacementTenancy, you must specify at least one subnet for VPCZoneIdentifier when you create your group.
For more information, see Configuring instance tenancy with Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
Valid Values: default | dedicated
The tenancy of the instance, either default or dedicated. An instance with dedicated tenancy runs on isolated, single-tenant hardware and can only be launched into a VPC. To launch dedicated instances into a shared tenancy VPC (a VPC with the instance placement tenancy attribute set to default), you must set the value of this property to dedicated. For more information, see Configuring instance tenancy with Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
If you specify PlacementTenancy, you must specify at least one subnet for VPCZoneIdentifier when you create your group.
Valid values: default | dedicated
The error code.
", "LaunchConfiguration$PlacementTenancy": "The tenancy of the instance, either default or dedicated. An instance with dedicated tenancy runs on isolated, single-tenant hardware and can only be launched into a VPC.
For more information, see Configuring instance tenancy with Amazon EC2 Auto Scaling in the Amazon EC2 Auto Scaling User Guide.
", "PolicyTypes$member": null, diff --git a/service/autoscaling/api.go b/service/autoscaling/api.go index 30eb4b1b985..0f68b2557dc 100644 --- a/service/autoscaling/api.go +++ b/service/autoscaling/api.go @@ -175,8 +175,8 @@ func (c *AutoScaling) AttachLoadBalancerTargetGroupsRequest(input *AttachLoadBal // This operation is additive and does not detach existing target groups or // Classic Load Balancers from the Auto Scaling group. // -// For more information, see Elastic Load Balancing and Amazon EC2 Auto Scaling -// (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) +// For more information, see Use Elastic Load Balancing to distribute traffic +// across the instances in your Auto Scaling group (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) // in the Amazon EC2 Auto Scaling User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -270,14 +270,14 @@ func (c *AutoScaling) AttachLoadBalancersRequest(input *AttachLoadBalancersInput // Classic Load Balancers. // // To describe the load balancers for an Auto Scaling group, call the DescribeLoadBalancers -// API. To detach the load balancer from the Auto Scaling group, call the DetachLoadBalancers +// API. To detach a load balancer from the Auto Scaling group, call the DetachLoadBalancers // API. // // This operation is additive and does not detach existing Classic Load Balancers // or target groups from the Auto Scaling group. // -// For more information, see Elastic Load Balancing and Amazon EC2 Auto Scaling -// (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) +// For more information, see Use Elastic Load Balancing to distribute traffic +// across the instances in your Auto Scaling group (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) // in the Amazon EC2 Auto Scaling User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -745,7 +745,7 @@ func (c *AutoScaling) CreateAutoScalingGroupRequest(input *CreateAutoScalingGrou // // If you exceed your maximum limit of Auto Scaling groups, the call fails. // To query this limit, call the DescribeAccountLimits API. For information -// about updating this limit, see Amazon EC2 Auto Scaling service quotas (https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html) +// about updating this limit, see Quotas for Amazon EC2 Auto Scaling (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-quotas.html) // in the Amazon EC2 Auto Scaling User Guide. // // For introductory exercises for creating an Auto Scaling group, see Getting @@ -755,7 +755,7 @@ func (c *AutoScaling) CreateAutoScalingGroupRequest(input *CreateAutoScalingGrou // Scaling groups (https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroup.html) // in the Amazon EC2 Auto Scaling User Guide. // -// Every Auto Scaling group has three size parameters (DesiredCapacity, MaxSize, +// Every Auto Scaling group has three size properties (DesiredCapacity, MaxSize, // and MinSize). Usually, you set these sizes based on a specific number of // instances. However, if you configure a mixed instances policy that defines // weights for the instance types, you must specify these sizes with the same @@ -857,7 +857,7 @@ func (c *AutoScaling) CreateLaunchConfigurationRequest(input *CreateLaunchConfig // // If you exceed your maximum limit of launch configurations, the call fails. // To query this limit, call the DescribeAccountLimits API. For information -// about updating this limit, see Amazon EC2 Auto Scaling service quotas (https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html) +// about updating this limit, see Quotas for Amazon EC2 Auto Scaling (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-quotas.html) // in the Amazon EC2 Auto Scaling User Guide. // // For more information, see Launch configurations (https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchConfiguration.html) @@ -957,7 +957,7 @@ func (c *AutoScaling) CreateOrUpdateTagsRequest(input *CreateOrUpdateTagsInput) // When you specify a tag with a key that already exists, the operation overwrites // the previous tag definition, and you do not get an error message. // -// For more information, see Tagging Auto Scaling groups and instances (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) +// For more information, see Tag Auto Scaling groups and instances (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html) // in the Amazon EC2 Auto Scaling User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -1764,8 +1764,8 @@ func (c *AutoScaling) DescribeAccountLimitsRequest(input *DescribeAccountLimitsI // // When you establish an Amazon Web Services account, the account has initial // quotas on the maximum number of Auto Scaling groups and launch configurations -// that you can create in a given Region. For more information, see Amazon EC2 -// Auto Scaling service quotas (https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-account-limits.html) +// that you can create in a given Region. For more information, see Quotas for +// Amazon EC2 Auto Scaling (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-quotas.html) // in the Amazon EC2 Auto Scaling User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -2726,10 +2726,10 @@ func (c *AutoScaling) DescribeLoadBalancerTargetGroupsRequest(input *DescribeLoa // DescribeLoadBalancerTargetGroups API operation for Auto Scaling. // -// Gets information about the load balancer target groups for the specified +// Gets information about the Elastic Load Balancing target groups for the specified // Auto Scaling group. // -// To determine the availability of registered instances, use the State element +// To determine the attachment status of the target group, use the State element // in the response. When you attach a target group to an Auto Scaling group, // the initial State value is Adding. The state transitions to Added after all // Auto Scaling instances are registered with the target group. If Elastic Load @@ -2747,8 +2747,9 @@ func (c *AutoScaling) DescribeLoadBalancerTargetGroupsRequest(input *DescribeLoa // // For help with failed health checks, see Troubleshooting Amazon EC2 Auto Scaling: // Health checks (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ts-as-healthchecks.html) -// in the Amazon EC2 Auto Scaling User Guide. For more information, see Elastic -// Load Balancing and Amazon EC2 Auto Scaling (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) +// in the Amazon EC2 Auto Scaling User Guide. For more information, see Use +// Elastic Load Balancing to distribute traffic across the instances in your +// Auto Scaling group (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) // in the Amazon EC2 Auto Scaling User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -2836,10 +2837,10 @@ func (c *AutoScaling) DescribeLoadBalancersRequest(input *DescribeLoadBalancersI // group. // // This operation describes only Classic Load Balancers. If you have Application -// Load Balancers, Network Load Balancers, or Gateway Load Balancers, use the +// Load Balancers, Network Load Balancers, or Gateway Load Balancer, use the // DescribeLoadBalancerTargetGroups API instead. // -// To determine the availability of registered instances, use the State element +// To determine the attachment status of the load balancer, use the State element // in the response. When you attach a load balancer to an Auto Scaling group, // the initial State value is Adding. The state transitions to Added after all // Auto Scaling instances are registered with the load balancer. If Elastic @@ -2857,8 +2858,9 @@ func (c *AutoScaling) DescribeLoadBalancersRequest(input *DescribeLoadBalancersI // // For help with failed health checks, see Troubleshooting Amazon EC2 Auto Scaling: // Health checks (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ts-as-healthchecks.html) -// in the Amazon EC2 Auto Scaling User Guide. For more information, see Elastic -// Load Balancing and Amazon EC2 Auto Scaling (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) +// in the Amazon EC2 Auto Scaling User Guide. For more information, see Use +// Elastic Load Balancing to distribute traffic across the instances in your +// Auto Scaling group (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) // in the Amazon EC2 Auto Scaling User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -2944,9 +2946,6 @@ func (c *AutoScaling) DescribeMetricCollectionTypesRequest(input *DescribeMetric // // Describes the available CloudWatch metrics for Amazon EC2 Auto Scaling. // -// The GroupStandbyInstances metric is not returned by default. You must explicitly -// request this metric when calling the EnableMetricsCollection API. -// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -3707,7 +3706,7 @@ func (c *AutoScaling) DescribeTagsRequest(input *DescribeTagsInput) (req *reques // a particular tag only if it matches all the filters. If there's no match, // no special message is returned. // -// For more information, see Tagging Auto Scaling groups and instances (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) +// For more information, see Tag Auto Scaling groups and instances (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html) // in the Amazon EC2 Auto Scaling User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -3845,8 +3844,8 @@ func (c *AutoScaling) DescribeTerminationPolicyTypesRequest(input *DescribeTermi // // Describes the termination policies supported by Amazon EC2 Auto Scaling. // -// For more information, see Controlling which Auto Scaling instances terminate -// during scale in (https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html) +// For more information, see Work with Amazon EC2 Auto Scaling termination policies +// (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html) // in the Amazon EC2 Auto Scaling User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -4117,6 +4116,11 @@ func (c *AutoScaling) DetachLoadBalancerTargetGroupsRequest(input *DetachLoadBal // // Detaches one or more target groups from the specified Auto Scaling group. // +// When you detach a target group, it enters the Removing state while deregistering +// the instances in the group. When all instances are deregistered, then you +// can no longer describe the target group using the DescribeLoadBalancerTargetGroups +// API call. The instances remain running. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -4200,7 +4204,7 @@ func (c *AutoScaling) DetachLoadBalancersRequest(input *DetachLoadBalancersInput // group. // // This operation detaches only Classic Load Balancers. If you have Application -// Load Balancers, Network Load Balancers, or Gateway Load Balancers, use the +// Load Balancers, Network Load Balancers, or Gateway Load Balancer, use the // DetachLoadBalancerTargetGroups API instead. // // When you detach a load balancer, it enters the Removing state while deregistering @@ -4287,7 +4291,7 @@ func (c *AutoScaling) DisableMetricsCollectionRequest(input *DisableMetricsColle // DisableMetricsCollection API operation for Auto Scaling. // -// Disables group metrics for the specified Auto Scaling group. +// Disables group metrics collection for the specified Auto Scaling group. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -4368,9 +4372,13 @@ func (c *AutoScaling) EnableMetricsCollectionRequest(input *EnableMetricsCollect // EnableMetricsCollection API operation for Auto Scaling. // -// Enables group metrics for the specified Auto Scaling group. For more information, -// see Monitoring CloudWatch metrics for your Auto Scaling groups and instances -// (https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-monitoring.html) +// Enables group metrics collection for the specified Auto Scaling group. +// +// You can use these metrics to track changes in an Auto Scaling group and to +// set alarms on threshold values. You can view group metrics using the Amazon +// EC2 Auto Scaling console or the CloudWatch console. For more information, +// see Monitor CloudWatch metrics for your Auto Scaling groups and instances +// (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html) // in the Amazon EC2 Auto Scaling User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -5150,6 +5158,9 @@ func (c *AutoScaling) PutScheduledUpdateGroupActionRequest(input *PutScheduledUp // API call. If you are no longer using a scheduled action, you can delete it // by calling the DeleteScheduledAction API. // +// If you try to schedule your action in the past, Amazon EC2 Auto Scaling returns +// an error message. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -6114,8 +6125,8 @@ func (c *AutoScaling) UpdateAutoScalingGroupRequest(input *UpdateAutoScalingGrou // // Updates the configuration for the specified Auto Scaling group. // -// To update an Auto Scaling group, specify the name of the group and the parameter -// that you want to change. Any parameters that you don't specify are not changed +// To update an Auto Scaling group, specify the name of the group and the property +// that you want to change. Any properties that you don't specify are not changed // by this update request. The new settings take effect on any scaling activities // after this call returns. // @@ -6147,7 +6158,7 @@ func (c *AutoScaling) UpdateAutoScalingGroupRequest(input *UpdateAutoScalingGrou // of the group, this sets the group's DesiredCapacity to the new MaxSize // value. // -// To see which parameters have been set, call the DescribeAutoScalingGroups +// To see which properties have been set, call the DescribeAutoScalingGroups // API. To view the scaling policies for an Auto Scaling group, call the DescribePolicies // API. If the group has scaling policies, you can update them by calling the // PutScalingPolicy API. @@ -6994,30 +7005,30 @@ func (s *BatchPutScheduledUpdateGroupActionOutput) SetFailedScheduledUpdateGroup type BlockDeviceMapping struct { _ struct{} `type:"structure"` - // The device name exposed to the EC2 instance (for example, /dev/sdh or xvdh). - // For more information, see Device Naming on Linux Instances (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/device_naming.html) + // The device name assigned to the volume (for example, /dev/sdh or xvdh). For + // more information, see Device naming on Linux instances (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/device_naming.html) // in the Amazon EC2 User Guide for Linux Instances. // + // To define a block device mapping, set the device name and exactly one of + // the following properties: Ebs, NoDevice, or VirtualName. + // // DeviceName is a required field DeviceName *string `min:"1" type:"string" required:"true"` - // Parameters used to automatically set up EBS volumes when an instance is launched. - // - // You can specify either VirtualName or Ebs, but not both. + // Information to attach an EBS volume to an instance at launch. Ebs *Ebs `type:"structure"` - // Setting this value to true suppresses the specified device included in the - // block device mapping of the AMI. + // Setting this value to true prevents a volume that is included in the block + // device mapping of the AMI from being mapped to the specified device name + // at launch. // // If NoDevice is true for the root device, instances might fail the EC2 health // check. In that case, Amazon EC2 Auto Scaling launches replacement instances. - // - // If you specify NoDevice, you cannot specify Ebs. NoDevice *bool `type:"boolean"` - // The name of the virtual device (for example, ephemeral0). - // - // You can specify either VirtualName or Ebs, but not both. + // The name of the instance store volume (virtual device) to attach to an instance + // at launch. The name must be in the form ephemeralX where X is a number starting + // from zero (0), for example, ephemeral0. VirtualName *string `min:"1" type:"string"` } @@ -7225,8 +7236,7 @@ type CompleteLifecycleActionInput struct { // The ID of the instance. InstanceId *string `min:"1" type:"string"` - // The action for the group to take. This parameter can be either CONTINUE or - // ABANDON. + // The action for the group to take. You can specify either CONTINUE or ABANDON. // // LifecycleActionResult is a required field LifecycleActionResult *string `type:"string" required:"true"` @@ -7353,20 +7363,19 @@ type CreateAutoScalingGroupInput struct { AutoScalingGroupName *string `min:"1" type:"string" required:"true"` // A list of Availability Zones where instances in the Auto Scaling group can - // be created. This parameter is optional if you specify one or more subnets - // for VPCZoneIdentifier. - // - // Conditional: If your account supports EC2-Classic and VPC, this parameter - // is required to launch instances into EC2-Classic. + // be created. Used for launching into the default VPC subnet in each Availability + // Zone when not using the VPCZoneIdentifier property, or for attaching a network + // interface when an existing network interface ID is specified in a launch + // template. AvailabilityZones []*string `type:"list"` // Indicates whether Capacity Rebalancing is enabled. Otherwise, Capacity Rebalancing // is disabled. When you turn on Capacity Rebalancing, Amazon EC2 Auto Scaling // attempts to launch a Spot Instance whenever Amazon EC2 notifies that a Spot // Instance is at an elevated risk of interruption. After launching a new instance, - // it then terminates an old instance. For more information, see Amazon EC2 - // Auto Scaling Capacity Rebalancing (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html) - // in the Amazon EC2 Auto Scaling User Guide. + // it then terminates an old instance. For more information, see Use Capacity + // Rebalancing to handle Amazon EC2 Spot Interruptions (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html) + // in the in the Amazon EC2 Auto Scaling User Guide. CapacityRebalance *bool `type:"boolean"` // Reserved. @@ -7423,7 +7432,6 @@ type CreateAutoScalingGroupInput struct { // Valid values: units | vcpu | memory-mib DesiredCapacityType *string `min:"1" type:"string"` - // // The amount of time, in seconds, that Amazon EC2 Auto Scaling waits before // checking the health status of an EC2 instance that has come into service // and marking it unhealthy due to a failed Elastic Load Balancing or custom @@ -7459,7 +7467,7 @@ type CreateAutoScalingGroupInput struct { // or InstanceId). LaunchConfigurationName *string `min:"1" type:"string"` - // Parameters used to specify the launch template and version to use to launch + // Information used to specify the launch template and version to use to launch // instances. // // Conditional: You must specify either a launch template (LaunchTemplate or @@ -7472,13 +7480,13 @@ type CreateAutoScalingGroupInput struct { // in the Amazon EC2 Auto Scaling User Guide. LaunchTemplate *LaunchTemplateSpecification `type:"structure"` - // One or more lifecycle hooks for the group, which specify actions to perform - // when Amazon EC2 Auto Scaling launches or terminates instances. + // One or more lifecycle hooks to add to the Auto Scaling group before instances + // are launched. LifecycleHookSpecificationList []*LifecycleHookSpecification `type:"list"` // A list of Classic Load Balancers associated with this Auto Scaling group. // For Application Load Balancers, Network Load Balancers, and Gateway Load - // Balancers, specify the TargetGroupARNs property instead. + // Balancer, specify the TargetGroupARNs property instead. LoadBalancerNames []*string `type:"list"` // The maximum amount of time, in seconds, that an instance can be in service. @@ -7518,8 +7526,8 @@ type CreateAutoScalingGroupInput struct { // in the Amazon EC2 Auto Scaling User Guide. NewInstancesProtectedFromScaleIn *bool `type:"boolean"` - // The name of an existing placement group into which to launch your instances. - // For more information, see Placement groups (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html) + // The name of the placement group into which to launch your instances. For + // more information, see Placement groups (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html) // in the Amazon EC2 User Guide for Linux Instances. // // A cluster placement group is a logical grouping of instances within a single @@ -7528,7 +7536,7 @@ type CreateAutoScalingGroupInput struct { PlacementGroup *string `min:"1" type:"string"` // The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling - // group uses to call other Amazon Web Services on your behalf. By default, + // group uses to call other Amazon Web Services service on your behalf. By default, // Amazon EC2 Auto Scaling uses a service-linked role named AWSServiceRoleForAutoScaling, // which it creates if it does not exist. For more information, see Service-linked // roles (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-service-linked-role.html) @@ -7541,31 +7549,33 @@ type CreateAutoScalingGroupInput struct { // template but use caution. If the launch template specifies an instance tag // with a key that is also specified for the Auto Scaling group, Amazon EC2 // Auto Scaling overrides the value of that instance tag with the value specified - // by the Auto Scaling group. For more information, see Tagging Auto Scaling - // groups and instances (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) + // by the Auto Scaling group. For more information, see Tag Auto Scaling groups + // and instances (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html) // in the Amazon EC2 Auto Scaling User Guide. Tags []*Tag `type:"list"` // The Amazon Resource Names (ARN) of the target groups to associate with the - // Auto Scaling group. Instances are registered as targets in a target group, - // and traffic is routed to the target group. For more information, see Elastic - // Load Balancing and Amazon EC2 Auto Scaling (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) + // Auto Scaling group. Instances are registered as targets with the target groups. + // The target groups receive incoming traffic and route requests to one or more + // registered targets. For more information, see Use Elastic Load Balancing + // to distribute traffic across the instances in your Auto Scaling group (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html) // in the Amazon EC2 Auto Scaling User Guide. TargetGroupARNs []*string `type:"list"` // A policy or a list of policies that are used to select the instance to terminate. // These policies are executed in the order that you list them. For more information, - // see Controlling which Auto Scaling instances terminate during scale in (https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html) + // see Work with Amazon EC2 Auto Scaling termination policies (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html) // in the Amazon EC2 Auto Scaling User Guide. + // + // Valid values: Default | AllocationStrategy | ClosestToNextInstanceHour | + // NewestInstance | OldestInstance | OldestLaunchConfiguration | OldestLaunchTemplate + // | arn:aws:lambda:region:account-id:function:my-function:my-alias TerminationPolicies []*string `type:"list"` // A comma-separated list of subnet IDs for a virtual private cloud (VPC) where // instances in the Auto Scaling group can be created. If you specify VPCZoneIdentifier - // with AvailabilityZones, the subnets that you specify for this parameter must - // reside in those Availability Zones. - // - // Conditional: If your account supports EC2-Classic and VPC, this parameter - // is required to launch instances into a VPC. + // with AvailabilityZones, the subnets that you specify must reside in those + // Availability Zones. VPCZoneIdentifier *string `min:"1" type:"string"` } @@ -7841,30 +7851,30 @@ func (s CreateAutoScalingGroupOutput) GoString() string { type CreateLaunchConfigurationInput struct { _ struct{} `type:"structure"` - // For Auto Scaling groups that are running in a virtual private cloud (VPC), - // specifies whether to assign a public IP address to the group's instances. + // Specifies whether to assign a public IPv4 address to the group's instances. + // If the instance is launched into a default subnet, the default is to assign + // a public IPv4 address, unless you disabled the option to assign a public + // IPv4 address on the subnet. If the instance is launched into a nondefault + // subnet, the default is not to assign a public IPv4 address, unless you enabled + // the option to assign a public IPv4 address on the subnet. + // // If you specify true, each instance in the Auto Scaling group receives a unique - // public IP address. For more information, see Launching Auto Scaling instances + // public IPv4 address. For more information, see Launching Auto Scaling instances // in a VPC (https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html) // in the Amazon EC2 Auto Scaling User Guide. // - // If you specify this parameter, you must specify at least one subnet for VPCZoneIdentifier + // If you specify this property, you must specify at least one subnet for VPCZoneIdentifier // when you create your group. - // - // If the instance is launched into a default subnet, the default is to assign - // a public IP address, unless you disabled the option to assign a public IP - // address on the subnet. If the instance is launched into a nondefault subnet, - // the default is not to assign a public IP address, unless you enabled the - // option to assign a public IP address on the subnet. AssociatePublicIpAddress *bool `type:"boolean"` - // A block device mapping, which specifies the block devices for the instance. - // You can specify virtual devices and EBS volumes. For more information, see - // Block Device Mapping (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html) + // The block device mapping entries that define the block devices to attach + // to the instances at launch. By default, the block devices specified in the + // block device mapping for the AMI are used. For more information, see Block + // device mappings (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html) // in the Amazon EC2 User Guide for Linux Instances. BlockDeviceMappings []*BlockDeviceMapping `type:"list"` - // EC2-Classic retires on August 15, 2022. This parameter is not supported after + // EC2-Classic retires on August 15, 2022. This property is not supported after // that date. // // The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. @@ -7872,14 +7882,13 @@ type CreateLaunchConfigurationInput struct { // in the Amazon EC2 User Guide for Linux Instances. ClassicLinkVPCId *string `min:"1" type:"string"` - // EC2-Classic retires on August 15, 2022. This parameter is not supported after + // EC2-Classic retires on August 15, 2022. This property is not supported after // that date. // // The IDs of one or more security groups for the specified ClassicLink-enabled - // VPC. For more information, see ClassicLink (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html) - // in the Amazon EC2 User Guide for Linux Instances. + // VPC. // - // If you specify the ClassicLinkVPCId parameter, you must specify this parameter. + // If you specify the ClassicLinkVPCId property, you must specify ClassicLinkVPCSecurityGroups. ClassicLinkVPCSecurityGroups []*string `type:"list"` // Specifies whether the launch configuration is optimized for EBS I/O (true) @@ -7896,18 +7905,16 @@ type CreateLaunchConfigurationInput struct { // The name or the Amazon Resource Name (ARN) of the instance profile associated // with the IAM role for the instance. The instance profile contains the IAM - // role. - // - // For more information, see IAM role for applications that run on Amazon EC2 - // instances (https://docs.aws.amazon.com/autoscaling/ec2/userguide/us-iam-role.html) + // role. For more information, see IAM role for applications that run on Amazon + // EC2 instances (https://docs.aws.amazon.com/autoscaling/ec2/userguide/us-iam-role.html) // in the Amazon EC2 Auto Scaling User Guide. IamInstanceProfile *string `min:"1" type:"string"` // The ID of the Amazon Machine Image (AMI) that was assigned during registration. - // For more information, see Finding an AMI (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html) + // For more information, see Finding a Linux AMI (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html) // in the Amazon EC2 User Guide for Linux Instances. // - // If you do not specify InstanceId, you must specify ImageId. + // If you specify InstanceId, an ImageId is not required. ImageId *string `min:"1" type:"string"` // The ID of the instance to use to create the launch configuration. The new @@ -7920,8 +7927,6 @@ type CreateLaunchConfigurationInput struct { // For more information, see Creating a launch configuration using an EC2 instance // (https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-lc-with-instanceID.html) // in the Amazon EC2 Auto Scaling User Guide. - // - // If you do not specify InstanceId, you must specify both ImageId and InstanceType. InstanceId *string `min:"1" type:"string"` // Controls whether instances in this group are launched with detailed (true) @@ -7936,20 +7941,22 @@ type CreateLaunchConfigurationInput struct { // in the Amazon EC2 Auto Scaling User Guide. InstanceMonitoring *InstanceMonitoring `type:"structure"` - // Specifies the instance type of the EC2 instance. - // - // For information about available instance types, see Available Instance Types - // (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes) + // Specifies the instance type of the EC2 instance. For information about available + // instance types, see Available instance types (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes) // in the Amazon EC2 User Guide for Linux Instances. // - // If you do not specify InstanceId, you must specify InstanceType. + // If you specify InstanceId, an InstanceType is not required. InstanceType *string `min:"1" type:"string"` // The ID of the kernel associated with the AMI. + // + // We recommend that you use PV-GRUB instead of kernels and RAM disks. For more + // information, see User provided kernels (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedKernels.html) + // in the Amazon EC2 User Guide for Linux Instances. KernelId *string `min:"1" type:"string"` - // The name of the key pair. For more information, see Amazon EC2 Key Pairs - // (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) + // The name of the key pair. For more information, see Amazon EC2 key pairs + // and Linux instances (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) // in the Amazon EC2 User Guide for Linux Instances. KeyName *string `min:"1" type:"string"` @@ -7964,44 +7971,41 @@ type CreateLaunchConfigurationInput struct { // in the Amazon EC2 Auto Scaling User Guide. MetadataOptions *InstanceMetadataOptions `type:"structure"` - // The tenancy of the instance. An instance with dedicated tenancy runs on isolated, - // single-tenant hardware and can only be launched into a VPC. - // - // To launch dedicated instances into a shared tenancy VPC (a VPC with the instance - // placement tenancy attribute set to default), you must set the value of this - // parameter to dedicated. + // The tenancy of the instance, either default or dedicated. An instance with + // dedicated tenancy runs on isolated, single-tenant hardware and can only be + // launched into a VPC. To launch dedicated instances into a shared tenancy + // VPC (a VPC with the instance placement tenancy attribute set to default), + // you must set the value of this property to dedicated. For more information, + // see Configuring instance tenancy with Amazon EC2 Auto Scaling (https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html) + // in the Amazon EC2 Auto Scaling User Guide. // // If you specify PlacementTenancy, you must specify at least one subnet for // VPCZoneIdentifier when you create your group. // - // For more information, see Configuring instance tenancy with Amazon EC2 Auto - // Scaling (https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-dedicated-instances.html) - // in the Amazon EC2 Auto Scaling User Guide. - // - // Valid Values: default | dedicated + // Valid values: default | dedicated PlacementTenancy *string `min:"1" type:"string"` // The ID of the RAM disk to select. + // + // We recommend that you use PV-GRUB instead of kernels and RAM disks. For more + // information, see User provided kernels (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedKernels.html) + // in the Amazon EC2 User Guide for Linux Instances. RamdiskId *string `min:"1" type:"string"` - // A list that contains the security groups to assign to the instances in the - // Auto Scaling group. - // - // [EC2-VPC] Specify the security group IDs. For more information, see Security - // Groups for Your VPC (https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html) + // A list that contains the security group IDs to assign to the instances in + // the Auto Scaling group. For more information, see Control traffic to resources + // using security groups (https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html) // in the Amazon Virtual Private Cloud User Guide. - // - // [EC2-Classic] Specify either the security group names or the security group - // IDs. For more information, see Amazon EC2 Security Groups (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html) - // in the Amazon EC2 User Guide for Linux Instances. SecurityGroups []*string `type:"list"` // The maximum hourly price to be paid for any Spot Instance launched to fulfill // the request. Spot Instances are launched when the price you specify exceeds - // the current Spot price. For more information, see Requesting Spot Instances - // (https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-launch-spot-instances.html) + // the current Spot price. For more information, see Request Spot Instances + // for fault-tolerant and flexible applications (https://docs.aws.amazon.com/autoscaling/ec2/userguide/launch-template-spot-instances.html) // in the Amazon EC2 Auto Scaling User Guide. // + // Valid Range: Minimum value of 0.001 + // // When you change your maximum price by creating a new launch configuration, // running instances will continue to run as long as the maximum price for those // running instances is higher than the current Spot price. @@ -8314,8 +8318,8 @@ func (s CreateOrUpdateTagsOutput) GoString() string { // // To create your customized metric specification: // -// * Add values for each required parameter from CloudWatch. You can use -// an existing metric, or a new metric that you create. To use your own metric, +// * Add values for each required property from CloudWatch. You can use an +// existing metric, or a new metric that you create. To use your own metric, // you must first publish the metric to CloudWatch. For more information, // see Publish custom metrics (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/publishingMetrics.html) // in the Amazon CloudWatch User Guide. @@ -8451,8 +8455,8 @@ type DeleteAutoScalingGroupInput struct { // Specifies that the group is to be deleted along with all instances associated // with the group, without waiting for all instances to be terminated. This - // parameter also deletes any outstanding lifecycle actions associated with - // the group. + // action also deletes any outstanding lifecycle actions associated with the + // group. ForceDelete *bool `type:"boolean"` } @@ -9243,9 +9247,9 @@ type DescribeAutoScalingGroupsInput struct { // The names of the Auto Scaling groups. By default, you can only specify up // to 50 names. You can optionally increase this limit using the MaxRecords - // parameter. + // property. // - // If you omit this parameter, all Auto Scaling groups are described. + // If you omit this property, all Auto Scaling groups are described. AutoScalingGroupNames []*string `type:"list"` // One or more filters to limit the results based on specific tags. @@ -9350,7 +9354,7 @@ func (s *DescribeAutoScalingGroupsOutput) SetNextToken(v string) *DescribeAutoSc type DescribeAutoScalingInstancesInput struct { _ struct{} `type:"structure"` - // The IDs of the instances. If you omit this parameter, all Auto Scaling instances + // The IDs of the instances. If you omit this property, all Auto Scaling instances // are described. If you specify an ID that does not exist, it is ignored with // no error. // @@ -9579,7 +9583,8 @@ func (s *DescribeInstanceRefreshesInput) SetNextToken(v string) *DescribeInstanc type DescribeInstanceRefreshesOutput struct { _ struct{} `type:"structure"` - // The instance refreshes for the specified group. + // The instance refreshes for the specified group, sorted by creation timestamp + // in descending order. InstanceRefreshes []*InstanceRefresh `type:"list"` // A string that indicates that the response contains more items than can be @@ -9622,7 +9627,7 @@ func (s *DescribeInstanceRefreshesOutput) SetNextToken(v string) *DescribeInstan type DescribeLaunchConfigurationsInput struct { _ struct{} `type:"structure"` - // The launch configuration names. If you omit this parameter, all launch configurations + // The launch configuration names. If you omit this property, all launch configurations // are described. // // Array Members: Maximum number of 50 items. @@ -9779,7 +9784,7 @@ type DescribeLifecycleHooksInput struct { // AutoScalingGroupName is a required field AutoScalingGroupName *string `min:"1" type:"string" required:"true"` - // The names of one or more lifecycle hooks. If you omit this parameter, all + // The names of one or more lifecycle hooks. If you omit this property, all // lifecycle hooks are described. LifecycleHookNames []*string `type:"list"` } @@ -10113,7 +10118,7 @@ type DescribeMetricCollectionTypesOutput struct { // The granularities for the metrics. Granularities []*MetricGranularityType `type:"list"` - // One or more metrics. + // The metrics. Metrics []*MetricCollectionType `type:"list"` } @@ -10257,7 +10262,7 @@ type DescribePoliciesInput struct { // a previous call.) NextToken *string `type:"string"` - // The names of one or more policies. If you omit this parameter, all policies + // The names of one or more policies. If you omit this property, all policies // are described. If a group name is provided, the results are limited to that // group. If you specify an unknown policy name, it is ignored with no error. // @@ -10376,7 +10381,7 @@ func (s *DescribePoliciesOutput) SetScalingPolicies(v []*ScalingPolicy) *Describ type DescribeScalingActivitiesInput struct { _ struct{} `type:"structure"` - // The activity IDs of the desired scaling activities. If you omit this parameter, + // The activity IDs of the desired scaling activities. If you omit this property, // all activities for the past six weeks are described. If unknown activities // are requested, they are ignored with no error. If you specify an Auto Scaling // group, the results are limited to that group. @@ -10566,7 +10571,7 @@ type DescribeScheduledActionsInput struct { AutoScalingGroupName *string `min:"1" type:"string"` // The latest scheduled start time to return. If scheduled action names are - // provided, this parameter is ignored. + // provided, this property is ignored. EndTime *time.Time `type:"timestamp"` // The maximum number of items to return with this call. The default value is @@ -10577,7 +10582,7 @@ type DescribeScheduledActionsInput struct { // a previous call.) NextToken *string `type:"string"` - // The names of one or more scheduled actions. If you omit this parameter, all + // The names of one or more scheduled actions. If you omit this property, all // scheduled actions are described. If you specify an unknown scheduled action, // it is ignored with no error. // @@ -10585,7 +10590,7 @@ type DescribeScheduledActionsInput struct { ScheduledActionNames []*string `type:"list"` // The earliest scheduled start time to return. If scheduled action names are - // provided, this parameter is ignored. + // provided, this property is ignored. StartTime *time.Time `type:"timestamp"` } @@ -11323,7 +11328,9 @@ type DisableMetricsCollectionInput struct { // AutoScalingGroupName is a required field AutoScalingGroupName *string `min:"1" type:"string" required:"true"` - // Specifies one or more of the following metrics: + // Identifies the metrics to disable. + // + // You can specify one or more of the following metrics: // // * GroupMinSize // @@ -11365,7 +11372,10 @@ type DisableMetricsCollectionInput struct { // // * GroupAndWarmPoolTotalCapacity // - // If you omit this parameter, all metrics are disabled. + // If you omit this property, all metrics are disabled. + // + // For more information, see Auto Scaling group metrics (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics) + // in the Amazon EC2 Auto Scaling User Guide. Metrics []*string `type:"list"` } @@ -11460,7 +11470,7 @@ type Ebs struct { // always encrypted, either using the Amazon Web Services managed KMS key or // a customer-managed KMS key, regardless of whether the snapshot was encrypted. // - // For more information, see Using Amazon Web Services KMS keys to encrypt Amazon + // For more information, see Use Amazon Web Services KMS keys to encrypt Amazon // EBS volumes (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-data-protection.html#encryption) // in the Amazon EC2 Auto Scaling User Guide. Encrypted *bool `type:"boolean"` @@ -11512,7 +11522,7 @@ type Ebs struct { // The volume type. For more information, see Amazon EBS volume types (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) // in the Amazon EC2 User Guide for Linux Instances. // - // Valid Values: standard | io1 | gp2 | st1 | sc1 | gp3 + // Valid values: standard | io1 | gp2 | st1 | sc1 | gp3 VolumeType *string `min:"1" type:"string"` } @@ -11609,14 +11619,15 @@ type EnableMetricsCollectionInput struct { // AutoScalingGroupName is a required field AutoScalingGroupName *string `min:"1" type:"string" required:"true"` - // The granularity to associate with the metrics to collect. The only valid - // value is 1Minute. + // The frequency at which Amazon EC2 Auto Scaling sends aggregated data to CloudWatch. + // The only valid value is 1Minute. // // Granularity is a required field Granularity *string `min:"1" type:"string" required:"true"` - // Specifies which group-level metrics to start collecting. You can specify - // one or more of the following metrics: + // Identifies the metrics to enable. + // + // You can specify one or more of the following metrics: // // * GroupMinSize // @@ -11634,8 +11645,6 @@ type EnableMetricsCollectionInput struct { // // * GroupTotalInstances // - // The instance weighting feature supports the following additional metrics: - // // * GroupInServiceCapacity // // * GroupPendingCapacity @@ -11646,8 +11655,6 @@ type EnableMetricsCollectionInput struct { // // * GroupTotalCapacity // - // The warm pools feature supports the following additional metrics: - // // * WarmPoolDesiredCapacity // // * WarmPoolWarmedCapacity @@ -11662,7 +11669,11 @@ type EnableMetricsCollectionInput struct { // // * GroupAndWarmPoolTotalCapacity // - // If you omit this parameter, all metrics are enabled. + // If you specify Granularity and don't specify any metrics, all metrics are + // enabled. + // + // For more information, see Auto Scaling group metrics (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics) + // in the Amazon EC2 Auto Scaling User Guide. Metrics []*string `type:"list"` } @@ -11746,7 +11757,7 @@ func (s EnableMetricsCollectionOutput) GoString() string { return s.String() } -// Describes an enabled metric. +// Describes an enabled Auto Scaling group metric. type EnabledMetric struct { _ struct{} `type:"structure"` @@ -11794,6 +11805,9 @@ type EnabledMetric struct { // * GroupAndWarmPoolDesiredCapacity // // * GroupAndWarmPoolTotalCapacity + // + // For more information, see Auto Scaling group metrics (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html#as-group-metrics) + // in the Amazon EC2 Auto Scaling User Guide. Metric *string `min:"1" type:"string"` } @@ -12205,7 +12219,7 @@ func (s *FailedScheduledUpdateGroupActionRequest) SetScheduledActionName(v strin // joined with an AND, and the request returns only the results that match all // of the specified filters. // -// For more information, see Tagging Auto Scaling groups and instances (https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-tagging.html) +// For more information, see Tag Auto Scaling groups and instances (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html) // in the Amazon EC2 Auto Scaling User Guide. type Filter struct { _ struct{} `type:"structure"` @@ -12954,7 +12968,7 @@ type InstanceDetails struct { // For information about lifecycle states, see Instance lifecycle (https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroupLifecycle.html) // in the Amazon EC2 Auto Scaling User Guide. // - // Valid Values: Pending | Pending:Wait | Pending:Proceed | Quarantined | InService + // Valid values: 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 | @@ -13588,7 +13602,7 @@ type InstanceRequirements struct { // // * For instance types with hard disk drive (HDD) storage, specify hdd. // - // * For instance types with solid state drive (SSD) storage, specify sdd. + // * For instance types with solid state drive (SSD) storage, specify ssd. // // Default: Any local storage type LocalStorageTypes []*string `type:"list" enum:"LocalStorageType"` @@ -13611,12 +13625,12 @@ type InstanceRequirements struct { // The price protection threshold for On-Demand Instances. This is the maximum // you’ll pay for an On-Demand Instance, expressed as a percentage higher - // than the cheapest M, C, or R instance type with your specified attributes. - // When Amazon EC2 Auto Scaling selects instance types with your attributes, - // we will exclude instance types whose price is higher than your threshold. - // The parameter accepts an integer, which Amazon EC2 Auto Scaling interprets - // as a percentage. To turn off price protection, specify a high value, such - // as 999999. + // than the least expensive current generation M, C, or R instance type with + // your specified attributes. When Amazon EC2 Auto Scaling selects instance + // types with your attributes, we will exclude instance types whose price is + // higher than your threshold. The parameter accepts an integer, which Amazon + // EC2 Auto Scaling interprets as a percentage. To turn off price protection, + // specify a high value, such as 999999. // // If you set DesiredCapacityType to vcpu or memory-mib, the price protection // threshold is applied based on the per vCPU or per memory price instead of @@ -13632,12 +13646,13 @@ type InstanceRequirements struct { RequireHibernateSupport *bool `type:"boolean"` // The price protection threshold for Spot Instances. This is the maximum you’ll - // pay for a Spot Instance, expressed as a percentage higher than the cheapest - // M, C, or R instance type with your specified attributes. When Amazon EC2 - // Auto Scaling selects instance types with your attributes, we will exclude - // instance types whose price is higher than your threshold. The parameter accepts - // an integer, which Amazon EC2 Auto Scaling interprets as a percentage. To - // turn off price protection, specify a high value, such as 999999. + // pay for a Spot Instance, expressed as a percentage higher than the least + // expensive current generation M, C, or R instance type with your specified + // attributes. When Amazon EC2 Auto Scaling selects instance types with your + // attributes, we will exclude instance types whose price is higher than your + // threshold. The parameter accepts an integer, which Amazon EC2 Auto Scaling + // interprets as a percentage. To turn off price protection, specify a high + // value, such as 999999. // // If you set DesiredCapacityType to vcpu or memory-mib, the price protection // threshold is applied based on the per vCPU or per memory price instead of @@ -13882,6 +13897,8 @@ type InstancesDistribution struct { // // Default: lowest-price for Auto Scaling groups that specify InstanceRequirements // in the overrides and prioritized for Auto Scaling groups that don't. + // + // Valid values: lowest-price | prioritized OnDemandAllocationStrategy *string `type:"string"` // The minimum amount of the Auto Scaling group's capacity that must be fulfilled @@ -13919,6 +13936,8 @@ type InstancesDistribution struct { // but optimizes for capacity first. // // Default: lowest-price + // + // Valid values: lowest-price | capacity-optimized | capacity-optimized-prioritized SpotAllocationStrategy *string `type:"string"` // The number of Spot Instance pools across which to allocate your Spot Instances. @@ -13934,6 +13953,11 @@ type InstancesDistribution struct { // uses the On-Demand price as the maximum Spot price. To remove a value that // you previously set, include the property but specify an empty string ("") // for the value. + // + // If your maximum price is lower than the Spot price for the instance types + // that you selected, your Spot Instances are not launched. + // + // Valid Range: Minimum value of 0.001 SpotMaxPrice *string `type:"string"` } @@ -13995,24 +14019,30 @@ func (s *InstancesDistribution) SetSpotMaxPrice(v string) *InstancesDistribution type LaunchConfiguration struct { _ struct{} `type:"structure"` - // For Auto Scaling groups that are running in a VPC, specifies whether to assign - // a public IP address to the group's instances. For more information, see Launching - // Auto Scaling instances in a VPC (https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html) + // Specifies whether to assign a public IPv4 address to the group's instances. + // If the instance is launched into a default subnet, the default is to assign + // a public IPv4 address, unless you disabled the option to assign a public + // IPv4 address on the subnet. If the instance is launched into a nondefault + // subnet, the default is not to assign a public IPv4 address, unless you enabled + // the option to assign a public IPv4 address on the subnet. For more information, + // see Launching Auto Scaling instances in a VPC (https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-in-vpc.html) // in the Amazon EC2 Auto Scaling User Guide. AssociatePublicIpAddress *bool `type:"boolean"` - // A block device mapping, which specifies the block devices for the instance. - // For more information, see Block Device Mapping (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html) + // The block device mapping entries that define the block devices to attach + // to the instances at launch. By default, the block devices specified in the + // block device mapping for the AMI are used. For more information, see Block + // Device Mapping (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html) // in the Amazon EC2 User Guide for Linux Instances. BlockDeviceMappings []*BlockDeviceMapping `type:"list"` - // EC2-Classic retires on August 15, 2022. This parameter is not supported after + // EC2-Classic retires on August 15, 2022. This property is not supported after // that date. // // The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. ClassicLinkVPCId *string `min:"1" type:"string"` - // EC2-Classic retires on August 15, 2022. This parameter is not supported after + // EC2-Classic retires on August 15, 2022. This property is not supported after // that date. // // The IDs of one or more security groups for the VPC specified in ClassicLinkVPCId. @@ -14037,7 +14067,7 @@ type LaunchConfiguration struct { IamInstanceProfile *string `min:"1" type:"string"` // The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances. - // For more information, see Finding an AMI (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html) + // For more information, see Find a Linux AMI (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html) // in the Amazon EC2 User Guide for Linux Instances. // // ImageId is a required field @@ -14051,10 +14081,8 @@ type LaunchConfiguration struct { // in the Amazon EC2 Auto Scaling User Guide. InstanceMonitoring *InstanceMonitoring `type:"structure"` - // The instance type for the instances. - // - // For information about available instance types, see Available Instance Types - // (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes) + // The instance type for the instances. For information about available instance + // types, see Available instance types (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes) // in the Amazon EC2 User Guide for Linux Instances. // // InstanceType is a required field @@ -14537,9 +14565,10 @@ type LifecycleHook struct { // The name of the Auto Scaling group for the lifecycle hook. AutoScalingGroupName *string `min:"1" type:"string"` - // Defines the action the Auto Scaling group should take when the lifecycle - // hook timeout elapses or if an unexpected failure occurs. The possible values - // are CONTINUE and ABANDON. + // The action the Auto Scaling group takes when the lifecycle hook timeout elapses + // or if an unexpected failure occurs. + // + // Valid values: CONTINUE | ABANDON DefaultResult *string `type:"string"` // The maximum time, in seconds, that an instance can remain in a wait state. @@ -14549,18 +14578,15 @@ type LifecycleHook struct { // The maximum time, in seconds, that can elapse before the lifecycle hook times // out. If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the - // action that you specified in the DefaultResult parameter. + // action that you specified in the DefaultResult property. HeartbeatTimeout *int64 `type:"integer"` // The name of the lifecycle hook. LifecycleHookName *string `min:"1" type:"string"` - // The state of the EC2 instance to which to attach the lifecycle hook. The - // following are possible values: - // - // * autoscaling:EC2_INSTANCE_LAUNCHING + // The lifecycle transition. // - // * autoscaling:EC2_INSTANCE_TERMINATING + // Valid values: autoscaling:EC2_INSTANCE_LAUNCHING | autoscaling:EC2_INSTANCE_TERMINATING LifecycleTransition *string `type:"string"` // Additional information that is included any time Amazon EC2 Auto Scaling @@ -14568,8 +14594,7 @@ type LifecycleHook struct { NotificationMetadata *string `min:"1" type:"string"` // The ARN of the target that Amazon EC2 Auto Scaling sends notifications to - // when an instance is in the transition state for the lifecycle hook. The notification - // target can be either an SQS queue or an SNS topic. + // when an instance is in a wait state for the lifecycle hook. NotificationTargetARN *string `type:"string"` // The ARN of the IAM role that allows the Auto Scaling group to publish to @@ -14657,17 +14682,15 @@ func (s *LifecycleHook) SetRoleARN(v string) *LifecycleHook { type LifecycleHookSpecification struct { _ struct{} `type:"structure"` - // Defines the action the Auto Scaling group should take when the lifecycle - // hook timeout elapses or if an unexpected failure occurs. The valid values - // are CONTINUE and ABANDON. The default value is ABANDON. + // The action the Auto Scaling group takes when the lifecycle hook timeout elapses + // or if an unexpected failure occurs. The default value is ABANDON. + // + // Valid values: CONTINUE | ABANDON DefaultResult *string `type:"string"` // The maximum time, in seconds, that can elapse before the lifecycle hook times - // out. - // - // If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the action - // that you specified in the DefaultResult parameter. You can prevent the lifecycle - // hook from timing out by calling RecordLifecycleActionHeartbeat. + // out. The range is from 30 to 7200 seconds. The default value is 3600 seconds + // (1 hour). HeartbeatTimeout *int64 `type:"integer"` // The name of the lifecycle hook. @@ -14675,12 +14698,12 @@ type LifecycleHookSpecification struct { // LifecycleHookName is a required field LifecycleHookName *string `min:"1" type:"string" required:"true"` - // The state of the EC2 instance to which you want to attach the lifecycle hook. - // The valid values are: + // The lifecycle transition. For Auto Scaling groups, there are two major lifecycle + // transitions. // - // * autoscaling:EC2_INSTANCE_LAUNCHING + // * To create a lifecycle hook for scale-out events, specify autoscaling:EC2_INSTANCE_LAUNCHING. // - // * autoscaling:EC2_INSTANCE_TERMINATING + // * To create a lifecycle hook for scale-in events, specify autoscaling:EC2_INSTANCE_TERMINATING. // // LifecycleTransition is a required field LifecycleTransition *string `type:"string" required:"true"` @@ -14689,17 +14712,19 @@ type LifecycleHookSpecification struct { // Scaling sends a message to the notification target. NotificationMetadata *string `min:"1" type:"string"` - // The ARN of the target that Amazon EC2 Auto Scaling sends notifications to - // when an instance is in the transition state for the lifecycle hook. The notification - // target can be either an SQS queue or an SNS topic. + // The Amazon Resource Name (ARN) of the notification target that Amazon EC2 + // Auto Scaling sends notifications to when an instance is in a wait state for + // the lifecycle hook. You can specify an Amazon SNS topic or an Amazon SQS + // queue. NotificationTargetARN *string `type:"string"` // The ARN of the IAM role that allows the Auto Scaling group to publish to - // the specified notification target. + // the specified notification target. For information about creating this role, + // see Configure a notification target for a lifecycle hook (https://docs.aws.amazon.com/autoscaling/ec2/userguide/prepare-for-lifecycle-notifications.html#lifecycle-hook-notification-target) + // in the Amazon EC2 Auto Scaling User Guide. // // Valid only if the notification target is an Amazon SNS topic or an Amazon - // SQS queue. Required for new lifecycle hooks, but optional when updating existing - // hooks. + // SQS queue. RoleARN *string `min:"1" type:"string"` } @@ -15535,12 +15560,11 @@ func (s *MetricStat) SetUnit(v string) *MetricStat { type MixedInstancesPolicy struct { _ struct{} `type:"structure"` - // Specifies the instances distribution. + // The instances distribution. InstancesDistribution *InstancesDistribution `type:"structure"` - // Specifies the launch template to use and the instance types (overrides) that - // are used to launch EC2 instances to fulfill On-Demand and Spot capacities. - // Required when creating a mixed instances policy. + // One or more launch templates and the instance types (overrides) that are + // used to launch EC2 instances to fulfill On-Demand and Spot capacities. LaunchTemplate *LaunchTemplate `type:"structure"` } @@ -16596,18 +16620,15 @@ type PutLifecycleHookInput struct { // AutoScalingGroupName is a required field AutoScalingGroupName *string `min:"1" type:"string" required:"true"` - // Defines the action the Auto Scaling group should take when the lifecycle - // hook timeout elapses or if an unexpected failure occurs. This parameter can - // be either CONTINUE or ABANDON. The default value is ABANDON. + // The action the Auto Scaling group takes when the lifecycle hook timeout elapses + // or if an unexpected failure occurs. The default value is ABANDON. + // + // Valid values: CONTINUE | ABANDON DefaultResult *string `type:"string"` // The maximum time, in seconds, that can elapse before the lifecycle hook times // out. The range is from 30 to 7200 seconds. The default value is 3600 seconds // (1 hour). - // - // If the lifecycle hook times out, Amazon EC2 Auto Scaling performs the action - // that you specified in the DefaultResult parameter. You can prevent the lifecycle - // hook from timing out by calling the RecordLifecycleActionHeartbeat API. HeartbeatTimeout *int64 `type:"integer"` // The name of the lifecycle hook. @@ -16615,12 +16636,12 @@ type PutLifecycleHookInput struct { // LifecycleHookName is a required field LifecycleHookName *string `min:"1" type:"string" required:"true"` - // The instance state to which you want to attach the lifecycle hook. The valid - // values are: + // The lifecycle transition. For Auto Scaling groups, there are two major lifecycle + // transitions. // - // * autoscaling:EC2_INSTANCE_LAUNCHING + // * To create a lifecycle hook for scale-out events, specify autoscaling:EC2_INSTANCE_LAUNCHING. // - // * autoscaling:EC2_INSTANCE_TERMINATING + // * To create a lifecycle hook for scale-in events, specify autoscaling:EC2_INSTANCE_TERMINATING. // // Required for new lifecycle hooks, but optional when updating existing hooks. LifecycleTransition *string `type:"string"` @@ -16629,9 +16650,10 @@ type PutLifecycleHookInput struct { // Scaling sends a message to the notification target. NotificationMetadata *string `min:"1" type:"string"` - // The ARN of the notification target that Amazon EC2 Auto Scaling uses to notify - // you when an instance is in the transition state for the lifecycle hook. This - // target can be either an SQS queue or an SNS topic. + // The Amazon Resource Name (ARN) of the notification target that Amazon EC2 + // Auto Scaling uses to notify you when an instance is in a wait state for the + // lifecycle hook. You can specify either an Amazon SNS topic or an Amazon SQS + // queue. // // If you specify an empty string, this overrides the current ARN. // @@ -17002,7 +17024,7 @@ type PutScalingPolicyInput struct { // * ALBRequestCountPerTarget // // If you specify ALBRequestCountPerTarget for the metric, you must specify - // the ResourceLabel parameter with the PredefinedMetricSpecification. + // the ResourceLabel property with the PredefinedMetricSpecification. // // For more information, see TargetTrackingConfiguration (https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_TargetTrackingConfiguration.html) // in the Amazon EC2 Auto Scaling API Reference. @@ -17216,9 +17238,13 @@ type PutScheduledUpdateGroupActionInput struct { // The desired capacity is the initial capacity of the Auto Scaling group after // the scheduled action runs and the capacity it attempts to maintain. It can // scale beyond this capacity if you add more scaling conditions. + // + // You must specify at least one of the following properties: MaxSize, MinSize, + // or DesiredCapacity. DesiredCapacity *int64 `type:"integer"` - // The date and time for the recurring schedule to end, in UTC. + // The date and time for the recurring schedule to end, in UTC. For example, + // "2021-06-01T00:00:00Z". EndTime *time.Time `type:"timestamp"` // The maximum size of the Auto Scaling group. @@ -17244,17 +17270,14 @@ type PutScheduledUpdateGroupActionInput struct { ScheduledActionName *string `min:"1" type:"string" required:"true"` // The date and time for this action to start, in YYYY-MM-DDThh:mm:ssZ format - // in UTC/GMT only and in quotes (for example, "2019-06-01T00:00:00Z"). + // in UTC/GMT only and in quotes (for example, "2021-06-01T00:00:00Z"). // // If you specify Recurrence and StartTime, Amazon EC2 Auto Scaling performs // the action at this time, and then performs the action based on the specified // recurrence. - // - // If you try to schedule your action in the past, Amazon EC2 Auto Scaling returns - // an error message. StartTime *time.Time `type:"timestamp"` - // This parameter is no longer used. + // This property is no longer used. Time *time.Time `type:"timestamp"` // Specifies the time zone for a cron expression. If a time zone is not provided, @@ -17972,7 +17995,7 @@ type ScalingProcessQuery struct { // // * ScheduledActions // - // If you omit this parameter, all processes are specified. + // If you omit this property, all processes are specified. ScalingProcesses []*string `type:"list"` } @@ -18058,7 +18081,7 @@ type ScheduledUpdateGroupAction struct { // The date and time in UTC for this action to start. For example, "2019-06-01T00:00:00Z". StartTime *time.Time `type:"timestamp"` - // This parameter is no longer used. + // This property is no longer used. Time *time.Time `type:"timestamp"` // The time zone for the cron expression. @@ -18779,6 +18802,11 @@ type StepAdjustment struct { // value adds to the current capacity while a negative number removes from the // current capacity. // + // The amount by which to scale. The adjustment is based on the value that you + // specified in the AdjustmentType property (either an absolute number or a + // percentage). A positive value adds to the current capacity and a negative + // number subtracts from the current capacity. + // // ScalingAdjustment is a required field ScalingAdjustment *int64 `type:"integer" required:"true"` } @@ -19298,8 +19326,8 @@ type UpdateAutoScalingGroupInput struct { // One or more Availability Zones for the group. AvailabilityZones []*string `type:"list"` - // Enables or disables Capacity Rebalancing. For more information, see Amazon - // EC2 Auto Scaling Capacity Rebalancing (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html) + // Enables or disables Capacity Rebalancing. For more information, see Use Capacity + // Rebalancing to handle Amazon EC2 Spot Interruptions (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-capacity-rebalancing.html) // in the Amazon EC2 Auto Scaling User Guide. CapacityRebalance *bool `type:"boolean"` @@ -19425,13 +19453,17 @@ type UpdateAutoScalingGroupInput struct { // A policy or a list of policies that are used to select the instances to terminate. // The policies are executed in the order that you list them. For more information, - // see Controlling which Auto Scaling instances terminate during scale in (https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html) + // see Work with Amazon EC2 Auto Scaling termination policies (https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-termination-policies.html) // in the Amazon EC2 Auto Scaling User Guide. + // + // Valid values: Default | AllocationStrategy | ClosestToNextInstanceHour | + // NewestInstance | OldestInstance | OldestLaunchConfiguration | OldestLaunchTemplate + // | arn:aws:lambda:region:account-id:function:my-function:my-alias TerminationPolicies []*string `type:"list"` // A comma-separated list of subnet IDs for a virtual private cloud (VPC). If // you specify VPCZoneIdentifier with AvailabilityZones, the subnets that you - // specify for this parameter must reside in those Availability Zones. + // specify must reside in those Availability Zones. VPCZoneIdentifier *string `min:"1" type:"string"` } diff --git a/service/autoscaling/doc.go b/service/autoscaling/doc.go index 27f32492ddf..114f96ef28b 100644 --- a/service/autoscaling/doc.go +++ b/service/autoscaling/doc.go @@ -3,16 +3,12 @@ // Package autoscaling provides the client and types for making API // requests to Auto Scaling. // -// Amazon EC2 Auto Scaling is designed to automatically launch or terminate +// Amazon EC2 Auto Scaling is designed to automatically launch and terminate // EC2 instances based on user-defined scaling policies, scheduled actions, // and health checks. // -// For more information about Amazon EC2 Auto Scaling, see the Amazon EC2 Auto -// Scaling User Guide (https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html). -// For information about granting IAM users required permissions for calls to -// Amazon EC2 Auto Scaling, see Granting IAM users required permissions for -// Amazon EC2 Auto Scaling resources (https://docs.aws.amazon.com/autoscaling/ec2/APIReference/ec2-auto-scaling-api-permissions.html) -// in the Amazon EC2 Auto Scaling API Reference. +// For more information, see the Amazon EC2 Auto Scaling User Guide (https://docs.aws.amazon.com/autoscaling/ec2/userguide/) +// and the Amazon EC2 Auto Scaling API Reference (https://docs.aws.amazon.com/autoscaling/ec2/APIReference/Welcome.html). // // See https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01 for more information on this service. //