feat(client-auto-scaling): Adds support for metric math for target tracking scaling policies, saving you the cost and effort of publishing a custom metric to CloudWatch. Also adds support for VPC Lattice by adding the Attach/Detach/DescribeTrafficSources APIs and a new health check type to the CreateAutoScalingGroup API.

Author: awstools

clients/client-auto-scaling/src/AutoScaling.ts

@@ -56,6 +56,10 @@ import {
   AttachLoadBalancerTargetGroupsCommandInput,
   AttachLoadBalancerTargetGroupsCommandOutput,
 } from "./commands/AttachLoadBalancerTargetGroupsCommand";
+import {
+  AttachTrafficSourcesCommandInput,
+  AttachTrafficSourcesCommandOutput,
+} from "./commands/AttachTrafficSourcesCommand";
 import {
   BatchDeleteScheduledActionCommandInput,
   BatchDeleteScheduledActionCommandOutput,
@@ -174,6 +178,10 @@ import {
   DescribeTerminationPolicyTypesCommandInput,
   DescribeTerminationPolicyTypesCommandOutput,
 } from "./commands/DescribeTerminationPolicyTypesCommand";
+import {
+  DescribeTrafficSourcesCommandInput,
+  DescribeTrafficSourcesCommandOutput,
+} from "./commands/DescribeTrafficSourcesCommand";
 import { DescribeWarmPoolCommandInput, DescribeWarmPoolCommandOutput } from "./commands/DescribeWarmPoolCommand";
 import { DetachInstancesCommandInput, DetachInstancesCommandOutput } from "./commands/DetachInstancesCommand";
 import {
@@ -184,6 +192,10 @@ import {
   DetachLoadBalancerTargetGroupsCommandInput,
   DetachLoadBalancerTargetGroupsCommandOutput,
 } from "./commands/DetachLoadBalancerTargetGroupsCommand";
+import {
+  DetachTrafficSourcesCommandInput,
+  DetachTrafficSourcesCommandOutput,
+} from "./commands/DetachTrafficSourcesCommand";
 import {
   DisableMetricsCollectionCommandInput,
   DisableMetricsCollectionCommandOutput,
@@ -246,6 +258,7 @@ export type ServiceInputTypes =
   | AttachInstancesCommandInput
   | AttachLoadBalancerTargetGroupsCommandInput
   | AttachLoadBalancersCommandInput
+  | AttachTrafficSourcesCommandInput
   | BatchDeleteScheduledActionCommandInput
   | BatchPutScheduledUpdateGroupActionCommandInput
   | CancelInstanceRefreshCommandInput
@@ -280,10 +293,12 @@ export type ServiceInputTypes =
   | DescribeScheduledActionsCommandInput
   | DescribeTagsCommandInput
   | DescribeTerminationPolicyTypesCommandInput
+  | DescribeTrafficSourcesCommandInput
   | DescribeWarmPoolCommandInput
   | DetachInstancesCommandInput
   | DetachLoadBalancerTargetGroupsCommandInput
   | DetachLoadBalancersCommandInput
+  | DetachTrafficSourcesCommandInput
   | DisableMetricsCollectionCommandInput
   | EnableMetricsCollectionCommandInput
   | EnterStandbyCommandInput
@@ -309,6 +324,7 @@ export type ServiceOutputTypes =
   | AttachInstancesCommandOutput
   | AttachLoadBalancerTargetGroupsCommandOutput
   | AttachLoadBalancersCommandOutput
+  | AttachTrafficSourcesCommandOutput
   | BatchDeleteScheduledActionCommandOutput
   | BatchPutScheduledUpdateGroupActionCommandOutput
   | CancelInstanceRefreshCommandOutput
@@ -343,10 +359,12 @@ export type ServiceOutputTypes =
   | DescribeScheduledActionsCommandOutput
   | DescribeTagsCommandOutput
   | DescribeTerminationPolicyTypesCommandOutput
+  | DescribeTrafficSourcesCommandOutput
   | DescribeWarmPoolCommandOutput
   | DetachInstancesCommandOutput
   | DetachLoadBalancerTargetGroupsCommandOutput
   | DetachLoadBalancersCommandOutput
+  | DetachTrafficSourcesCommandOutput
   | DisableMetricsCollectionCommandOutput
   | EnableMetricsCollectionCommandOutput
   | EnterStandbyCommandOutput
@@ -519,22 +537,9 @@ export interface AutoScalingClientResolvedConfig extends AutoScalingClientResolv
 
 /**
  * <fullname>Amazon EC2 Auto Scaling</fullname>
- *
- *
- *
- *
- *
- *
- *
- *
- *
- *
- *
- *
- *
- *         <p>Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances
+ *          <p>Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances
  *             based on user-defined scaling policies, scheduled actions, and health checks.</p>
- *         <p>For more information, see the <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/">Amazon EC2 Auto Scaling User Guide</a> and the <a href="https://docs.aws.amazon.com/autoscaling/ec2/APIReference/Welcome.html">Amazon EC2 Auto Scaling API Reference</a>.</p>
+ *          <p>For more information, see the <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/">Amazon EC2 Auto Scaling User Guide</a> and the <a href="https://docs.aws.amazon.com/autoscaling/ec2/APIReference/Welcome.html">Amazon EC2 Auto Scaling API Reference</a>.</p>
  */
 export class AutoScalingClient extends __Client<
   __HttpHandlerOptions,

clients/client-auto-scaling/src/AutoScalingClient.ts

@@ -25,14 +25,14 @@ export interface AttachInstancesCommandOutput extends __MetadataBearer {}
 
 /**
  * <p>Attaches one or more EC2 instances to the specified Auto Scaling group.</p>
- *         <p>When you attach instances, Amazon EC2 Auto Scaling increases the desired capacity of the group by the
+ *          <p>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.</p>
- *         <p>If there is a Classic Load Balancer attached to your Auto Scaling group, the instances are
+ *          <p>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.</p>
- *         <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-instance-asg.html">Attach EC2 instances to
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-instance-asg.html">Attach EC2 instances to
  *                 your Auto Scaling group</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

clients/client-auto-scaling/src/commands/AttachInstancesCommand.ts

@@ -32,25 +32,25 @@ export interface AttachLoadBalancerTargetGroupsCommandOutput
 
 /**
  * <p>Attaches one or more target groups to the specified Auto Scaling group.</p>
- *         <p>This operation is used with the following load balancer types: </p>
- *         <ul>
+ *          <p>This operation is used with the following load balancer types: </p>
+ *          <ul>
  *             <li>
- *                 <p>Application Load Balancer - Operates at the application layer (layer 7) and supports HTTP and
+ *                <p>Application Load Balancer - Operates at the application layer (layer 7) and supports HTTP and
  *                     HTTPS. </p>
  *             </li>
  *             <li>
- *                 <p>Network Load Balancer - Operates at the transport layer (layer 4) and supports TCP, TLS, and
+ *                <p>Network Load Balancer - Operates at the transport layer (layer 4) and supports TCP, TLS, and
  *                     UDP. </p>
  *             </li>
  *             <li>
- *                 <p>Gateway Load Balancer - Operates at the network layer (layer 3).</p>
+ *                <p>Gateway Load Balancer - Operates at the network layer (layer 3).</p>
  *             </li>
  *          </ul>
- *         <p>To describe the target groups for an Auto Scaling group, call the <a>DescribeLoadBalancerTargetGroups</a> API. To detach the target group from
+ *          <p>To describe the target groups for an Auto Scaling group, call the <a>DescribeLoadBalancerTargetGroups</a> API. To detach the target group from
  *             the Auto Scaling group, call the <a>DetachLoadBalancerTargetGroups</a> API.</p>
- *         <p>This operation is additive and does not detach existing target groups or Classic Load
+ *          <p>This operation is additive and does not detach existing target groups or Classic Load
  *             Balancers from the Auto Scaling group.</p>
- *         <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html">Use Elastic Load Balancing to
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html">Use Elastic Load Balancing to
  *                 distribute traffic across the instances in your Auto Scaling group</a> in the
  *                 <i>Amazon EC2 Auto Scaling User Guide</i>. </p>
  * @example

clients/client-auto-scaling/src/commands/AttachLoadBalancerTargetGroupsCommand.ts

@@ -31,14 +31,14 @@ export interface AttachLoadBalancersCommandOutput extends AttachLoadBalancersRes
 /**
  * <note>
  *             <p>To attach an Application Load Balancer, Network Load Balancer, or Gateway Load Balancer, use the <a>AttachLoadBalancerTargetGroups</a> API operation instead.</p>
- *         </note>
- *         <p>Attaches one or more Classic Load Balancers to the specified Auto Scaling group. Amazon EC2 Auto Scaling registers the
+ *          </note>
+ *          <p>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.</p>
- *         <p>To describe the load balancers for an Auto Scaling group, call the <a>DescribeLoadBalancers</a> API. To detach a load balancer from the Auto Scaling
+ *          <p>To describe the load balancers for an Auto Scaling group, call the <a>DescribeLoadBalancers</a> API. To detach a load balancer from the Auto Scaling
  *             group, call the <a>DetachLoadBalancers</a> API.</p>
- *         <p>This operation is additive and does not detach existing Classic Load Balancers or
+ *          <p>This operation is additive and does not detach existing Classic Load Balancers or
  *             target groups from the Auto Scaling group.</p>
- *         <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html">Use Elastic Load Balancing to
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html">Use Elastic Load Balancing to
  *                 distribute traffic across the instances in your Auto Scaling group</a> in the
  *                 <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
  * @example

clients/client-auto-scaling/src/commands/AttachLoadBalancersCommand.ts

@@ -0,0 +1,122 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import { AutoScalingClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../AutoScalingClient";
+import {
+  AttachTrafficSourcesResultType,
+  AttachTrafficSourcesResultTypeFilterSensitiveLog,
+  AttachTrafficSourcesType,
+  AttachTrafficSourcesTypeFilterSensitiveLog,
+} from "../models/models_0";
+import {
+  deserializeAws_queryAttachTrafficSourcesCommand,
+  serializeAws_queryAttachTrafficSourcesCommand,
+} from "../protocols/Aws_query";
+
+export interface AttachTrafficSourcesCommandInput extends AttachTrafficSourcesType {}
+export interface AttachTrafficSourcesCommandOutput extends AttachTrafficSourcesResultType, __MetadataBearer {}
+
+/**
+ * <p>
+ *             <b>Reserved for use with Amazon VPC Lattice, which is in preview and subject to change.
+ *             Do not use this API for production workloads. This API is also subject to change.</b>
+ *          </p>
+ *          <p>Attaches one or more traffic sources to the specified Auto Scaling group.</p>
+ *          <p>To describe the traffic sources for an Auto Scaling group, call the <a>DescribeTrafficSources</a> API. To detach a traffic source from the Auto Scaling
+ *             group, call the <a>DetachTrafficSources</a> API.</p>
+ *          <p>This operation is additive and does not detach existing traffic sources from the Auto Scaling
+ *             group.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { AutoScalingClient, AttachTrafficSourcesCommand } from "@aws-sdk/client-auto-scaling"; // ES Modules import
+ * // const { AutoScalingClient, AttachTrafficSourcesCommand } = require("@aws-sdk/client-auto-scaling"); // CommonJS import
+ * const client = new AutoScalingClient(config);
+ * const command = new AttachTrafficSourcesCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link AttachTrafficSourcesCommandInput} for command's `input` shape.
+ * @see {@link AttachTrafficSourcesCommandOutput} for command's `response` shape.
+ * @see {@link AutoScalingClientResolvedConfig | config} for AutoScalingClient's `config` shape.
+ *
+ */
+export class AttachTrafficSourcesCommand extends $Command<
+  AttachTrafficSourcesCommandInput,
+  AttachTrafficSourcesCommandOutput,
+  AutoScalingClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  constructor(readonly input: AttachTrafficSourcesCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: AutoScalingClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<AttachTrafficSourcesCommandInput, AttachTrafficSourcesCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(
+      getEndpointPlugin(configuration, AttachTrafficSourcesCommand.getEndpointParameterInstructions())
+    );
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "AutoScalingClient";
+    const commandName = "AttachTrafficSourcesCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: AttachTrafficSourcesTypeFilterSensitiveLog,
+      outputFilterSensitiveLog: AttachTrafficSourcesResultTypeFilterSensitiveLog,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  private serialize(input: AttachTrafficSourcesCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
+    return serializeAws_queryAttachTrafficSourcesCommand(input, context);
+  }
+
+  private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<AttachTrafficSourcesCommandOutput> {
+    return deserializeAws_queryAttachTrafficSourcesCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}

clients/client-auto-scaling/src/commands/AttachTrafficSourcesCommand.ts

@@ -32,7 +32,7 @@ export interface CancelInstanceRefreshCommandOutput extends CancelInstanceRefres
  * <p>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. </p>
- *         <p>This operation is part of the <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html">instance refresh
+ *          <p>This operation is part of the <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html">instance refresh
  *                 feature</a> in Amazon EC2 Auto Scaling, which helps you update instances in your Auto Scaling group
  *             after you make configuration changes.</p>
  * @example

clients/client-auto-scaling/src/commands/CancelInstanceRefreshCommand.ts

@@ -31,41 +31,41 @@ export interface CompleteLifecycleActionCommandOutput extends CompleteLifecycleA
 /**
  * <p>Completes the lifecycle action for the specified token or instance with the specified
  *             result.</p>
- *         <p>This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling
+ *          <p>This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling
  *             group:</p>
- *         <ol>
+ *          <ol>
  *             <li>
- *                 <p>(Optional) Create a launch template or launch configuration with a user data
+ *                <p>(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.</p>
  *             </li>
  *             <li>
- *                 <p>(Optional) Create a Lambda function and a rule that allows Amazon EventBridge to invoke
+ *                <p>(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.</p>
  *             </li>
  *             <li>
- *                 <p>(Optional) Create a notification target and an IAM role. The target can be
+ *                <p>(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.</p>
  *             </li>
  *             <li>
- *                 <p>Create the lifecycle hook. Specify whether the hook is used when the instances
+ *                <p>Create the lifecycle hook. Specify whether the hook is used when the instances
  *                     launch or terminate.</p>
  *             </li>
  *             <li>
- *                 <p>If you need more time, record the lifecycle action heartbeat to keep the
+ *                <p>If you need more time, record the lifecycle action heartbeat to keep the
  *                     instance in a wait state.</p>
  *             </li>
  *             <li>
- *                 <p>
- *                     <b>If you finish before the timeout period ends, send a
+ *                <p>
+ *                   <b>If you finish before the timeout period ends, send a
  *                         callback by using the <a>CompleteLifecycleAction</a> API
  *                         call.</b>
- *                 </p>
+ *                </p>
  *             </li>
  *          </ol>
- *         <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html">Amazon EC2 Auto Scaling lifecycle
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html">Amazon EC2 Auto Scaling lifecycle
  *                 hooks</a> in the <i>Amazon EC2 Auto Scaling User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.