AutoScalingClient

Amazon EC2 Auto Scaling

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.

Properties

Link copied to clipboard
abstract override val config: AutoScalingClient.Config

AutoScalingClient's configuration

Functions

Link copied to clipboard

Attaches one or more EC2 instances to the specified Auto Scaling group.

Link copied to clipboard

This API operation is superseded by AttachTrafficSources, which can attach multiple traffic sources types. We recommend using AttachTrafficSources to simplify how you manage traffic sources. However, we continue to support AttachLoadBalancers. You can use both the original AttachLoadBalancers API operation and AttachTrafficSources on the same Auto Scaling group.

Link copied to clipboard

This API operation is superseded by AttachTrafficSources, which can attach multiple traffic sources types. We recommend using AttachTrafficSources to simplify how you manage traffic sources. However, we continue to support AttachLoadBalancerTargetGroups. You can use both the original AttachLoadBalancerTargetGroups API operation and AttachTrafficSources on the same Auto Scaling group.

Link copied to clipboard

Attaches one or more traffic sources to the specified Auto Scaling group.

Link copied to clipboard

Deletes one or more scheduled actions for the specified Auto Scaling group.

Link copied to clipboard

Creates or updates one or more scheduled scaling actions for an Auto Scaling group.

Link copied to clipboard

Cancels an instance refresh or rollback that is in progress. If an instance refresh or rollback is not in progress, an ActiveInstanceRefreshNotFound error occurs.

Link copied to clipboard

Completes the lifecycle action for the specified token or instance with the specified result.

Link copied to clipboard

We strongly recommend using a launch template when calling this operation to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2.

Link copied to clipboard

Creates a launch configuration.

Link copied to clipboard

Creates or updates tags for the specified Auto Scaling group.

Link copied to clipboard

Deletes the specified Auto Scaling group.

Link copied to clipboard

Deletes the specified launch configuration.

Link copied to clipboard

Deletes the specified lifecycle hook.

Link copied to clipboard
Link copied to clipboard

Deletes the specified scaling policy.

Link copied to clipboard

Deletes the specified scheduled action.

Link copied to clipboard
abstract suspend fun deleteTags(input: DeleteTagsRequest): DeleteTagsResponse

Deletes the specified tags.

Link copied to clipboard

Deletes the warm pool for the specified Auto Scaling group.

Link copied to clipboard
abstract suspend fun describeAccountLimits(input: DescribeAccountLimitsRequest = DescribeAccountLimitsRequest { }): DescribeAccountLimitsResponse

Describes the current Amazon EC2 Auto Scaling resource quotas for your account.

Link copied to clipboard
abstract suspend fun describeAdjustmentTypes(input: DescribeAdjustmentTypesRequest = DescribeAdjustmentTypesRequest { }): DescribeAdjustmentTypesResponse

Describes the available adjustment types for step scaling and simple scaling policies.

Link copied to clipboard
abstract suspend fun describeAutoScalingGroups(input: DescribeAutoScalingGroupsRequest = DescribeAutoScalingGroupsRequest { }): DescribeAutoScalingGroupsResponse

Gets information about the Auto Scaling groups in the account and Region.

Link copied to clipboard
abstract suspend fun describeAutoScalingInstances(input: DescribeAutoScalingInstancesRequest = DescribeAutoScalingInstancesRequest { }): DescribeAutoScalingInstancesResponse

Gets information about the Auto Scaling instances in the account and Region.

Link copied to clipboard
abstract suspend fun describeAutoScalingNotificationTypes(input: DescribeAutoScalingNotificationTypesRequest = DescribeAutoScalingNotificationTypesRequest { }): DescribeAutoScalingNotificationTypesResponse

Describes the notification types that are supported by Amazon EC2 Auto Scaling.

Link copied to clipboard

Gets information about the instance refreshes for the specified Auto Scaling group from the previous six weeks.

Link copied to clipboard
abstract suspend fun describeLaunchConfigurations(input: DescribeLaunchConfigurationsRequest = DescribeLaunchConfigurationsRequest { }): DescribeLaunchConfigurationsResponse

Gets information about the launch configurations in the account and Region.

Link copied to clipboard

Gets information about the lifecycle hooks for the specified Auto Scaling group.

Link copied to clipboard
abstract suspend fun describeLifecycleHookTypes(input: DescribeLifecycleHookTypesRequest = DescribeLifecycleHookTypesRequest { }): DescribeLifecycleHookTypesResponse

Describes the available types of lifecycle hooks.

Link copied to clipboard

This API operation is superseded by DescribeTrafficSources, which can describe multiple traffic sources types. We recommend using DescribeTrafficSources to simplify how you manage traffic sources. However, we continue to support DescribeLoadBalancers. You can use both the original DescribeLoadBalancers API operation and DescribeTrafficSources on the same Auto Scaling group.

Link copied to clipboard

This API operation is superseded by DescribeTrafficSources, which can describe multiple traffic sources types. We recommend using DetachTrafficSources to simplify how you manage traffic sources. However, we continue to support DescribeLoadBalancerTargetGroups. You can use both the original DescribeLoadBalancerTargetGroups API operation and DescribeTrafficSources on the same Auto Scaling group.

Link copied to clipboard
abstract suspend fun describeMetricCollectionTypes(input: DescribeMetricCollectionTypesRequest = DescribeMetricCollectionTypesRequest { }): DescribeMetricCollectionTypesResponse

Describes the available CloudWatch metrics for Amazon EC2 Auto Scaling.

Link copied to clipboard
abstract suspend fun describeNotificationConfigurations(input: DescribeNotificationConfigurationsRequest = DescribeNotificationConfigurationsRequest { }): DescribeNotificationConfigurationsResponse

Gets information about the Amazon SNS notifications that are configured for one or more Auto Scaling groups.

Link copied to clipboard
abstract suspend fun describePolicies(input: DescribePoliciesRequest = DescribePoliciesRequest { }): DescribePoliciesResponse

Gets information about the scaling policies in the account and Region.

Link copied to clipboard
abstract suspend fun describeScalingActivities(input: DescribeScalingActivitiesRequest = DescribeScalingActivitiesRequest { }): DescribeScalingActivitiesResponse

Gets information about the scaling activities in the account and Region.

Link copied to clipboard
abstract suspend fun describeScalingProcessTypes(input: DescribeScalingProcessTypesRequest = DescribeScalingProcessTypesRequest { }): DescribeScalingProcessTypesResponse

Describes the scaling process types for use with the ResumeProcesses and SuspendProcesses APIs.

Link copied to clipboard
abstract suspend fun describeScheduledActions(input: DescribeScheduledActionsRequest = DescribeScheduledActionsRequest { }): DescribeScheduledActionsResponse

Gets information about the scheduled actions that haven't run or that have not reached their end time.

Link copied to clipboard
abstract suspend fun describeTags(input: DescribeTagsRequest = DescribeTagsRequest { }): DescribeTagsResponse

Describes the specified tags.

Link copied to clipboard
abstract suspend fun describeTerminationPolicyTypes(input: DescribeTerminationPolicyTypesRequest = DescribeTerminationPolicyTypesRequest { }): DescribeTerminationPolicyTypesResponse

Describes the termination policies supported by Amazon EC2 Auto Scaling.

Link copied to clipboard

Gets information about the traffic sources for the specified Auto Scaling group.

Link copied to clipboard

Gets information about a warm pool and its instances.

Link copied to clipboard

Removes one or more instances from the specified Auto Scaling group.

Link copied to clipboard

This API operation is superseded by DetachTrafficSources, which can detach multiple traffic sources types. We recommend using DetachTrafficSources to simplify how you manage traffic sources. However, we continue to support DetachLoadBalancers. You can use both the original DetachLoadBalancers API operation and DetachTrafficSources on the same Auto Scaling group.

Link copied to clipboard

This API operation is superseded by DetachTrafficSources, which can detach multiple traffic sources types. We recommend using DetachTrafficSources to simplify how you manage traffic sources. However, we continue to support DetachLoadBalancerTargetGroups. You can use both the original DetachLoadBalancerTargetGroups API operation and DetachTrafficSources on the same Auto Scaling group.

Link copied to clipboard

Detaches one or more traffic sources from the specified Auto Scaling group.

Link copied to clipboard

Disables group metrics collection for the specified Auto Scaling group.

Link copied to clipboard

Enables group metrics collection for the specified Auto Scaling group.

Link copied to clipboard

Moves the specified instances into the standby state.

Link copied to clipboard

Executes the specified policy. This can be useful for testing the design of your scaling policy.

Link copied to clipboard
abstract suspend fun exitStandby(input: ExitStandbyRequest): ExitStandbyResponse

Moves the specified instances out of the standby state.

Link copied to clipboard

Retrieves the forecast data for a predictive scaling policy.

Link copied to clipboard

Creates or updates a lifecycle hook for the specified Auto Scaling group.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Creates or updates a scheduled scaling action for an Auto Scaling group.

Link copied to clipboard
abstract suspend fun putWarmPool(input: PutWarmPoolRequest): PutWarmPoolResponse

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.

Link copied to clipboard

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.

Link copied to clipboard

Resumes the specified suspended auto scaling processes, or all suspended process, for the specified Auto Scaling group.

Link copied to clipboard

Cancels an instance refresh that is in progress and rolls back any changes that it made. Amazon EC2 Auto Scaling replaces any instances that were replaced during the instance refresh. This restores your Auto Scaling group to the configuration that it was using before the start of the instance refresh.

Link copied to clipboard

Sets the size of the specified Auto Scaling group.

Link copied to clipboard

Sets the health status of the specified instance.

Link copied to clipboard

Updates the instance protection settings of the specified instances. This operation cannot be called on instances in a warm pool.

Link copied to clipboard

Starts an instance refresh.

Link copied to clipboard

Suspends the specified auto scaling processes, or all processes, for the specified Auto Scaling group.

Link copied to clipboard

Terminates the specified instance and optionally adjusts the desired group size. This operation cannot be called on instances in a warm pool.

Link copied to clipboard

We strongly recommend that all Auto Scaling groups use launch templates to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2.

Inherited functions

Link copied to clipboard

Attaches one or more EC2 instances to the specified Auto Scaling group.

Link copied to clipboard

This API operation is superseded by AttachTrafficSources, which can attach multiple traffic sources types. We recommend using AttachTrafficSources to simplify how you manage traffic sources. However, we continue to support AttachLoadBalancers. You can use both the original AttachLoadBalancers API operation and AttachTrafficSources on the same Auto Scaling group.

Link copied to clipboard

This API operation is superseded by AttachTrafficSources, which can attach multiple traffic sources types. We recommend using AttachTrafficSources to simplify how you manage traffic sources. However, we continue to support AttachLoadBalancerTargetGroups. You can use both the original AttachLoadBalancerTargetGroups API operation and AttachTrafficSources on the same Auto Scaling group.

Link copied to clipboard

Attaches one or more traffic sources to the specified Auto Scaling group.

Link copied to clipboard

Deletes one or more scheduled actions for the specified Auto Scaling group.

Link copied to clipboard

Creates or updates one or more scheduled scaling actions for an Auto Scaling group.

Link copied to clipboard

Cancels an instance refresh or rollback that is in progress. If an instance refresh or rollback is not in progress, an ActiveInstanceRefreshNotFound error occurs.

Link copied to clipboard
expect abstract fun close()
Link copied to clipboard

Completes the lifecycle action for the specified token or instance with the specified result.

Link copied to clipboard

We strongly recommend using a launch template when calling this operation to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2.

Link copied to clipboard

Creates a launch configuration.

Link copied to clipboard

Creates or updates tags for the specified Auto Scaling group.

Link copied to clipboard

Deletes the specified Auto Scaling group.

Link copied to clipboard

Deletes the specified launch configuration.

Link copied to clipboard

Deletes the specified lifecycle hook.

Link copied to clipboard
Link copied to clipboard

Deletes the specified scaling policy.

Link copied to clipboard

Deletes the specified scheduled action.

Link copied to clipboard
inline suspend fun AutoScalingClient.deleteTags(crossinline block: DeleteTagsRequest.Builder.() -> Unit): DeleteTagsResponse

Deletes the specified tags.

Link copied to clipboard

Deletes the warm pool for the specified Auto Scaling group.

Link copied to clipboard

Describes the current Amazon EC2 Auto Scaling resource quotas for your account.

Link copied to clipboard

Describes the available adjustment types for step scaling and simple scaling policies.

Link copied to clipboard

Gets information about the Auto Scaling groups in the account and Region.

Link copied to clipboard

Gets information about the Auto Scaling instances in the account and Region.

Link copied to clipboard

Describes the notification types that are supported by Amazon EC2 Auto Scaling.

Link copied to clipboard

Gets information about the instance refreshes for the specified Auto Scaling group from the previous six weeks.

Link copied to clipboard

Gets information about the launch configurations in the account and Region.

Link copied to clipboard

Gets information about the lifecycle hooks for the specified Auto Scaling group.

Link copied to clipboard

Describes the available types of lifecycle hooks.

Link copied to clipboard

This API operation is superseded by DescribeTrafficSources, which can describe multiple traffic sources types. We recommend using DescribeTrafficSources to simplify how you manage traffic sources. However, we continue to support DescribeLoadBalancers. You can use both the original DescribeLoadBalancers API operation and DescribeTrafficSources on the same Auto Scaling group.

Link copied to clipboard

This API operation is superseded by DescribeTrafficSources, which can describe multiple traffic sources types. We recommend using DetachTrafficSources to simplify how you manage traffic sources. However, we continue to support DescribeLoadBalancerTargetGroups. You can use both the original DescribeLoadBalancerTargetGroups API operation and DescribeTrafficSources on the same Auto Scaling group.

Link copied to clipboard

Describes the available CloudWatch metrics for Amazon EC2 Auto Scaling.

Link copied to clipboard

Gets information about the Amazon SNS notifications that are configured for one or more Auto Scaling groups.

Link copied to clipboard

Gets information about the scaling policies in the account and Region.

Link copied to clipboard

Gets information about the scaling activities in the account and Region.

Link copied to clipboard

Describes the scaling process types for use with the ResumeProcesses and SuspendProcesses APIs.

Link copied to clipboard

Gets information about the scheduled actions that haven't run or that have not reached their end time.

Link copied to clipboard

Describes the specified tags.

Link copied to clipboard

Describes the termination policies supported by Amazon EC2 Auto Scaling.

Link copied to clipboard

Gets information about the traffic sources for the specified Auto Scaling group.

Link copied to clipboard

Gets information about a warm pool and its instances.

Link copied to clipboard

Removes one or more instances from the specified Auto Scaling group.

Link copied to clipboard

This API operation is superseded by DetachTrafficSources, which can detach multiple traffic sources types. We recommend using DetachTrafficSources to simplify how you manage traffic sources. However, we continue to support DetachLoadBalancers. You can use both the original DetachLoadBalancers API operation and DetachTrafficSources on the same Auto Scaling group.

Link copied to clipboard

This API operation is superseded by DetachTrafficSources, which can detach multiple traffic sources types. We recommend using DetachTrafficSources to simplify how you manage traffic sources. However, we continue to support DetachLoadBalancerTargetGroups. You can use both the original DetachLoadBalancerTargetGroups API operation and DetachTrafficSources on the same Auto Scaling group.

Link copied to clipboard

Detaches one or more traffic sources from the specified Auto Scaling group.

Link copied to clipboard

Disables group metrics collection for the specified Auto Scaling group.

Link copied to clipboard

Enables group metrics collection for the specified Auto Scaling group.

Link copied to clipboard

Moves the specified instances into the standby state.

Link copied to clipboard

Executes the specified policy. This can be useful for testing the design of your scaling policy.

Link copied to clipboard

Moves the specified instances out of the standby state.

Link copied to clipboard

Retrieves the forecast data for a predictive scaling policy.

Link copied to clipboard

Creates or updates a lifecycle hook for the specified Auto Scaling group.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Creates or updates a scheduled scaling action for an Auto Scaling group.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Resumes the specified suspended auto scaling processes, or all suspended process, for the specified Auto Scaling group.

Link copied to clipboard

Cancels an instance refresh that is in progress and rolls back any changes that it made. Amazon EC2 Auto Scaling replaces any instances that were replaced during the instance refresh. This restores your Auto Scaling group to the configuration that it was using before the start of the instance refresh.

Link copied to clipboard

Sets the size of the specified Auto Scaling group.

Link copied to clipboard

Sets the health status of the specified instance.

Link copied to clipboard

Updates the instance protection settings of the specified instances. This operation cannot be called on instances in a warm pool.

Link copied to clipboard

Starts an instance refresh.

Link copied to clipboard

Suspends the specified auto scaling processes, or all processes, for the specified Auto Scaling group.

Link copied to clipboard

Terminates the specified instance and optionally adjusts the desired group size. This operation cannot be called on instances in a warm pool.

Link copied to clipboard

We strongly recommend that all Auto Scaling groups use launch templates to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2.

Link copied to clipboard

Create a copy of the client with one or more configuration values overridden. This method allows the caller to perform scoped config overrides for one or more client operations.