aws-sdk-autoscaling 1.146.0 → 1.147.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d0b64a03b40a2473bcafb6582ae3b225405d6f625758491fa76ee6a88ebfc58
-  data.tar.gz: a9d135ad58a701cd46ec97e8cd0d57566961d5a383c118deeb7af19ee1582d3f
+  metadata.gz: dc660561c07e6db128ddddeb91ef46697a03a3317b940538bfcad409e83994da
+  data.tar.gz: cc46da88ed4a2742f044458bc34b55e44200056df893a099d06712af51146b08
 SHA512:
-  metadata.gz: 40f656a72be96729eeaef269a40f0a7c1afd2aa4222e45fc08276a6f1b0f228039067d53191ab8d6fe676663514239dfb588bd75d741d939b7613d025bc6ba30
-  data.tar.gz: 27167142fd419885c4945c4fe3a5f6ae82b3d055ed656f4b5a0bac73013882aa26ef312468b7db3a160e4834693beb43e7d71a183a78c820dc99cf5bf35ab793
+  metadata.gz: 4140bd9414f9dba3002d05261840b586651c2020e9badf7ce8d1ca7c790ea69203c1e9a6032c9903d9d7455086c8b2ab90759b96b8ae996b471c419ec360a3c4
+  data.tar.gz: 93a50d93e0bb21704b2732e1b3b8b39b48799e9e702d6bf7c2d83caefd24efb4af0e70af2a9a601861c0f3ae545c7a64dbb3ac54748e8892df999e310bcb98e4

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.147.0 (2025-11-18)
+------------------
+
+* Feature - This release adds the new LaunchInstances API, which can launch instances synchronously in an AutoScaling group. The API also returns instances info and launch error back immediately.
+
 1.146.0 (2025-10-22)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.146.0
+1.147.0

data/lib/aws-sdk-autoscaling/client.rb

@@ -5367,6 +5367,97 @@ module Aws::AutoScaling
       req.send_request(options)
     end
 
+    # Launches a specified number of instances in an Auto Scaling group.
+    # Returns instance IDs and other details if launch is successful or
+    # error details if launch is unsuccessful.
+    #
+    # @option params [required, String] :auto_scaling_group_name
+    #   The name of the Auto Scaling group to launch instances into.
+    #
+    # @option params [required, Integer] :requested_capacity
+    #   The number of instances to launch. Although this value can exceed 100
+    #   for instance weights, the actual instance count is limited to 100
+    #   instances per launch.
+    #
+    # @option params [required, String] :client_token
+    #   A unique, case-sensitive identifier to ensure idempotency of the
+    #   request.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @option params [Array<String>] :availability_zones
+    #   The Availability Zones for the instance launch. Must match or be
+    #   included in the Auto Scaling group's Availability Zone configuration.
+    #   Either `AvailabilityZones` or `SubnetIds` must be specified for groups
+    #   with multiple Availability Zone configurations.
+    #
+    # @option params [Array<String>] :availability_zone_ids
+    #   A list of Availability Zone IDs where instances should be launched.
+    #   Must match or be included in the group's AZ configuration. You cannot
+    #   specify both AvailabilityZones and AvailabilityZoneIds. Required for
+    #   multi-AZ groups, optional for single-AZ groups.
+    #
+    # @option params [Array<String>] :subnet_ids
+    #   The subnet IDs for the instance launch. Either `AvailabilityZones` or
+    #   `SubnetIds` must be specified. If both are specified, the subnets must
+    #   reside in the specified Availability Zones.
+    #
+    # @option params [String] :retry_strategy
+    #   Specifies whether to retry asynchronously if the synchronous launch
+    #   fails. Valid values are NONE (default, no async retry) and
+    #   RETRY\_WITH\_GROUP\_CONFIGURATION (increase desired capacity and retry
+    #   with group configuration).
+    #
+    # @return [Types::LaunchInstancesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::LaunchInstancesResult#auto_scaling_group_name #auto_scaling_group_name} => String
+    #   * {Types::LaunchInstancesResult#client_token #client_token} => String
+    #   * {Types::LaunchInstancesResult#instances #instances} => Array&lt;Types::InstanceCollection&gt;
+    #   * {Types::LaunchInstancesResult#errors #errors} => Array&lt;Types::LaunchInstancesError&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.launch_instances({
+    #     auto_scaling_group_name: "XmlStringMaxLen255", # required
+    #     requested_capacity: 1, # required
+    #     client_token: "ClientToken", # required
+    #     availability_zones: ["XmlStringMaxLen255"],
+    #     availability_zone_ids: ["XmlStringMaxLen255"],
+    #     subnet_ids: ["XmlStringMaxLen255"],
+    #     retry_strategy: "retry-with-group-configuration", # accepts retry-with-group-configuration, none
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.auto_scaling_group_name #=> String
+    #   resp.client_token #=> String
+    #   resp.instances #=> Array
+    #   resp.instances[0].instance_type #=> String
+    #   resp.instances[0].market_type #=> String
+    #   resp.instances[0].subnet_id #=> String
+    #   resp.instances[0].availability_zone #=> String
+    #   resp.instances[0].availability_zone_id #=> String
+    #   resp.instances[0].instance_ids #=> Array
+    #   resp.instances[0].instance_ids[0] #=> String
+    #   resp.errors #=> Array
+    #   resp.errors[0].instance_type #=> String
+    #   resp.errors[0].market_type #=> String
+    #   resp.errors[0].subnet_id #=> String
+    #   resp.errors[0].availability_zone #=> String
+    #   resp.errors[0].availability_zone_id #=> String
+    #   resp.errors[0].error_code #=> String
+    #   resp.errors[0].error_message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchInstances AWS API Documentation
+    #
+    # @overload launch_instances(params = {})
+    # @param [Hash] params ({})
+    def launch_instances(params = {}, options = {})
+      req = build_request(:launch_instances, params)
+      req.send_request(options)
+    end
+
     # Creates or updates a lifecycle hook for the specified Auto Scaling
     # group.
     #
@@ -7493,7 +7584,7 @@ module Aws::AutoScaling
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-autoscaling'
-      context[:gem_version] = '1.146.0'
+      context[:gem_version] = '1.147.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-autoscaling/client_api.rb

@@ -63,8 +63,10 @@ module Aws::AutoScaling
     AutoScalingInstancesType = Shapes::StructureShape.new(name: 'AutoScalingInstancesType')
     AutoScalingNotificationTypes = Shapes::ListShape.new(name: 'AutoScalingNotificationTypes')
     AvailabilityZoneDistribution = Shapes::StructureShape.new(name: 'AvailabilityZoneDistribution')
+    AvailabilityZoneIdsLimit1 = Shapes::ListShape.new(name: 'AvailabilityZoneIdsLimit1')
     AvailabilityZoneImpairmentPolicy = Shapes::StructureShape.new(name: 'AvailabilityZoneImpairmentPolicy')
     AvailabilityZones = Shapes::ListShape.new(name: 'AvailabilityZones')
+    AvailabilityZonesLimit1 = Shapes::ListShape.new(name: 'AvailabilityZonesLimit1')
     BakeTime = Shapes::IntegerShape.new(name: 'BakeTime')
     BareMetal = Shapes::StringShape.new(name: 'BareMetal')
     BaselineEbsBandwidthMbpsRequest = Shapes::StructureShape.new(name: 'BaselineEbsBandwidthMbpsRequest')
@@ -96,6 +98,7 @@ module Aws::AutoScaling
     CheckpointDelay = Shapes::IntegerShape.new(name: 'CheckpointDelay')
     CheckpointPercentages = Shapes::ListShape.new(name: 'CheckpointPercentages')
     ClassicLinkVPCSecurityGroups = Shapes::ListShape.new(name: 'ClassicLinkVPCSecurityGroups')
+    ClientToken = Shapes::StringShape.new(name: 'ClientToken')
     CompleteLifecycleActionAnswer = Shapes::StructureShape.new(name: 'CompleteLifecycleActionAnswer')
     CompleteLifecycleActionType = Shapes::StructureShape.new(name: 'CompleteLifecycleActionType')
     Context = Shapes::StringShape.new(name: 'Context')
@@ -177,10 +180,13 @@ module Aws::AutoScaling
     HealthCheckGracePeriod = Shapes::IntegerShape.new(name: 'HealthCheckGracePeriod')
     HeartbeatTimeout = Shapes::IntegerShape.new(name: 'HeartbeatTimeout')
     HonorCooldown = Shapes::BooleanShape.new(name: 'HonorCooldown')
+    IdempotentParameterMismatchError = Shapes::StructureShape.new(name: 'IdempotentParameterMismatchError', error: {"code" => "IdempotentParameterMismatch", "httpStatusCode" => 400, "senderFault" => true})
     ImpairedZoneHealthCheckBehavior = Shapes::StringShape.new(name: 'ImpairedZoneHealthCheckBehavior')
     IncludeDeletedGroups = Shapes::BooleanShape.new(name: 'IncludeDeletedGroups')
     IncludeInstances = Shapes::BooleanShape.new(name: 'IncludeInstances')
     Instance = Shapes::StructureShape.new(name: 'Instance')
+    InstanceCollection = Shapes::StructureShape.new(name: 'InstanceCollection')
+    InstanceCollections = Shapes::ListShape.new(name: 'InstanceCollections')
     InstanceGeneration = Shapes::StringShape.new(name: 'InstanceGeneration')
     InstanceGenerations = Shapes::ListShape.new(name: 'InstanceGenerations')
     InstanceIds = Shapes::ListShape.new(name: 'InstanceIds')
@@ -216,6 +222,10 @@ module Aws::AutoScaling
     LaunchConfigurationNamesType = Shapes::StructureShape.new(name: 'LaunchConfigurationNamesType')
     LaunchConfigurations = Shapes::ListShape.new(name: 'LaunchConfigurations')
     LaunchConfigurationsType = Shapes::StructureShape.new(name: 'LaunchConfigurationsType')
+    LaunchInstancesError = Shapes::StructureShape.new(name: 'LaunchInstancesError')
+    LaunchInstancesErrors = Shapes::ListShape.new(name: 'LaunchInstancesErrors')
+    LaunchInstancesRequest = Shapes::StructureShape.new(name: 'LaunchInstancesRequest')
+    LaunchInstancesResult = Shapes::StructureShape.new(name: 'LaunchInstancesResult')
     LaunchTemplate = Shapes::StructureShape.new(name: 'LaunchTemplate')
     LaunchTemplateName = Shapes::StringShape.new(name: 'LaunchTemplateName')
     LaunchTemplateOverrides = Shapes::StructureShape.new(name: 'LaunchTemplateOverrides')
@@ -332,9 +342,11 @@ module Aws::AutoScaling
     RefreshInstanceWarmup = Shapes::IntegerShape.new(name: 'RefreshInstanceWarmup')
     RefreshPreferences = Shapes::StructureShape.new(name: 'RefreshPreferences')
     RefreshStrategy = Shapes::StringShape.new(name: 'RefreshStrategy')
+    RequestedCapacity = Shapes::IntegerShape.new(name: 'RequestedCapacity')
     ResourceContentionFault = Shapes::StructureShape.new(name: 'ResourceContentionFault', error: {"code" => "ResourceContention", "httpStatusCode" => 500, "senderFault" => true})
     ResourceInUseFault = Shapes::StructureShape.new(name: 'ResourceInUseFault', error: {"code" => "ResourceInUse", "httpStatusCode" => 400, "senderFault" => true})
     ResourceName = Shapes::StringShape.new(name: 'ResourceName')
+    RetryStrategy = Shapes::StringShape.new(name: 'RetryStrategy')
     ReturnData = Shapes::BooleanShape.new(name: 'ReturnData')
     ReuseOnScaleIn = Shapes::BooleanShape.new(name: 'ReuseOnScaleIn')
     RollbackDetails = Shapes::StructureShape.new(name: 'RollbackDetails')
@@ -371,6 +383,7 @@ module Aws::AutoScaling
     StepAdjustment = Shapes::StructureShape.new(name: 'StepAdjustment')
     StepAdjustments = Shapes::ListShape.new(name: 'StepAdjustments')
     String = Shapes::StringShape.new(name: 'String')
+    SubnetIdsLimit1 = Shapes::ListShape.new(name: 'SubnetIdsLimit1')
     SuspendedProcess = Shapes::StructureShape.new(name: 'SuspendedProcess')
     SuspendedProcesses = Shapes::ListShape.new(name: 'SuspendedProcesses')
     Tag = Shapes::StructureShape.new(name: 'Tag')
@@ -581,12 +594,16 @@ module Aws::AutoScaling
     AvailabilityZoneDistribution.add_member(:capacity_distribution_strategy, Shapes::ShapeRef.new(shape: CapacityDistributionStrategy, location_name: "CapacityDistributionStrategy"))
     AvailabilityZoneDistribution.struct_class = Types::AvailabilityZoneDistribution
 
+    AvailabilityZoneIdsLimit1.member = Shapes::ShapeRef.new(shape: XmlStringMaxLen255)
+
     AvailabilityZoneImpairmentPolicy.add_member(:zonal_shift_enabled, Shapes::ShapeRef.new(shape: ZonalShiftEnabled, location_name: "ZonalShiftEnabled"))
     AvailabilityZoneImpairmentPolicy.add_member(:impaired_zone_health_check_behavior, Shapes::ShapeRef.new(shape: ImpairedZoneHealthCheckBehavior, location_name: "ImpairedZoneHealthCheckBehavior"))
     AvailabilityZoneImpairmentPolicy.struct_class = Types::AvailabilityZoneImpairmentPolicy
 
     AvailabilityZones.member = Shapes::ShapeRef.new(shape: XmlStringMaxLen255)
 
+    AvailabilityZonesLimit1.member = Shapes::ShapeRef.new(shape: XmlStringMaxLen255)
+
     BaselineEbsBandwidthMbpsRequest.add_member(:min, Shapes::ShapeRef.new(shape: NullablePositiveInteger, location_name: "Min"))
     BaselineEbsBandwidthMbpsRequest.add_member(:max, Shapes::ShapeRef.new(shape: NullablePositiveInteger, location_name: "Max"))
     BaselineEbsBandwidthMbpsRequest.struct_class = Types::BaselineEbsBandwidthMbpsRequest
@@ -975,6 +992,9 @@ module Aws::AutoScaling
     GetPredictiveScalingForecastType.add_member(:end_time, Shapes::ShapeRef.new(shape: TimestampType, required: true, location_name: "EndTime"))
     GetPredictiveScalingForecastType.struct_class = Types::GetPredictiveScalingForecastType
 
+    IdempotentParameterMismatchError.add_member(:message, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "Message"))
+    IdempotentParameterMismatchError.struct_class = Types::IdempotentParameterMismatchError
+
     Instance.add_member(:instance_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen19, required: true, location_name: "InstanceId"))
     Instance.add_member(:instance_type, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "InstanceType"))
     Instance.add_member(:availability_zone, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, required: true, location_name: "AvailabilityZone"))
@@ -986,6 +1006,16 @@ module Aws::AutoScaling
     Instance.add_member(:weighted_capacity, Shapes::ShapeRef.new(shape: XmlStringMaxLen32, location_name: "WeightedCapacity"))
     Instance.struct_class = Types::Instance
 
+    InstanceCollection.add_member(:instance_type, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "InstanceType"))
+    InstanceCollection.add_member(:market_type, Shapes::ShapeRef.new(shape: XmlStringMaxLen64, location_name: "MarketType"))
+    InstanceCollection.add_member(:subnet_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "SubnetId"))
+    InstanceCollection.add_member(:availability_zone, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "AvailabilityZone"))
+    InstanceCollection.add_member(:availability_zone_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "AvailabilityZoneId"))
+    InstanceCollection.add_member(:instance_ids, Shapes::ShapeRef.new(shape: InstanceIds, location_name: "InstanceIds"))
+    InstanceCollection.struct_class = Types::InstanceCollection
+
+    InstanceCollections.member = Shapes::ShapeRef.new(shape: InstanceCollection)
+
     InstanceGenerations.member = Shapes::ShapeRef.new(shape: InstanceGeneration)
 
     InstanceIds.member = Shapes::ShapeRef.new(shape: XmlStringMaxLen19)
@@ -1119,6 +1149,32 @@ module Aws::AutoScaling
     LaunchConfigurationsType.add_member(:next_token, Shapes::ShapeRef.new(shape: XmlString, location_name: "NextToken"))
     LaunchConfigurationsType.struct_class = Types::LaunchConfigurationsType
 
+    LaunchInstancesError.add_member(:instance_type, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "InstanceType"))
+    LaunchInstancesError.add_member(:market_type, Shapes::ShapeRef.new(shape: XmlStringMaxLen64, location_name: "MarketType"))
+    LaunchInstancesError.add_member(:subnet_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "SubnetId"))
+    LaunchInstancesError.add_member(:availability_zone, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "AvailabilityZone"))
+    LaunchInstancesError.add_member(:availability_zone_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "AvailabilityZoneId"))
+    LaunchInstancesError.add_member(:error_code, Shapes::ShapeRef.new(shape: XmlStringMaxLen64, location_name: "ErrorCode"))
+    LaunchInstancesError.add_member(:error_message, Shapes::ShapeRef.new(shape: XmlString, location_name: "ErrorMessage"))
+    LaunchInstancesError.struct_class = Types::LaunchInstancesError
+
+    LaunchInstancesErrors.member = Shapes::ShapeRef.new(shape: LaunchInstancesError)
+
+    LaunchInstancesRequest.add_member(:auto_scaling_group_name, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, required: true, location_name: "AutoScalingGroupName"))
+    LaunchInstancesRequest.add_member(:requested_capacity, Shapes::ShapeRef.new(shape: RequestedCapacity, required: true, location_name: "RequestedCapacity"))
+    LaunchInstancesRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, required: true, location_name: "ClientToken", metadata: {"idempotencyToken" => true}))
+    LaunchInstancesRequest.add_member(:availability_zones, Shapes::ShapeRef.new(shape: AvailabilityZonesLimit1, location_name: "AvailabilityZones"))
+    LaunchInstancesRequest.add_member(:availability_zone_ids, Shapes::ShapeRef.new(shape: AvailabilityZoneIdsLimit1, location_name: "AvailabilityZoneIds"))
+    LaunchInstancesRequest.add_member(:subnet_ids, Shapes::ShapeRef.new(shape: SubnetIdsLimit1, location_name: "SubnetIds"))
+    LaunchInstancesRequest.add_member(:retry_strategy, Shapes::ShapeRef.new(shape: RetryStrategy, location_name: "RetryStrategy"))
+    LaunchInstancesRequest.struct_class = Types::LaunchInstancesRequest
+
+    LaunchInstancesResult.add_member(:auto_scaling_group_name, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "AutoScalingGroupName"))
+    LaunchInstancesResult.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "ClientToken"))
+    LaunchInstancesResult.add_member(:instances, Shapes::ShapeRef.new(shape: InstanceCollections, location_name: "Instances"))
+    LaunchInstancesResult.add_member(:errors, Shapes::ShapeRef.new(shape: LaunchInstancesErrors, location_name: "Errors"))
+    LaunchInstancesResult.struct_class = Types::LaunchInstancesResult
+
     LaunchTemplate.add_member(:launch_template_specification, Shapes::ShapeRef.new(shape: LaunchTemplateSpecification, location_name: "LaunchTemplateSpecification"))
     LaunchTemplate.add_member(:overrides, Shapes::ShapeRef.new(shape: Overrides, location_name: "Overrides"))
     LaunchTemplate.struct_class = Types::LaunchTemplate
@@ -1518,6 +1574,8 @@ module Aws::AutoScaling
 
     StepAdjustments.member = Shapes::ShapeRef.new(shape: StepAdjustment)
 
+    SubnetIdsLimit1.member = Shapes::ShapeRef.new(shape: XmlStringMaxLen255)
+
     SuspendedProcess.add_member(:process_name, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "ProcessName"))
     SuspendedProcess.add_member(:suspension_reason, Shapes::ShapeRef.new(shape: XmlStringMaxLen255, location_name: "SuspensionReason"))
     SuspendedProcess.struct_class = Types::SuspendedProcess
@@ -2222,6 +2280,16 @@ module Aws::AutoScaling
         o.errors << Shapes::ShapeRef.new(shape: ResourceContentionFault)
       end)
 
+      api.add_operation(:launch_instances, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "LaunchInstances"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: LaunchInstancesRequest)
+        o.output = Shapes::ShapeRef.new(shape: LaunchInstancesResult)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceContentionFault)
+        o.errors << Shapes::ShapeRef.new(shape: IdempotentParameterMismatchError)
+      end)
+
       api.add_operation(:put_lifecycle_hook, Seahorse::Model::Operation.new.tap do |o|
         o.name = "PutLifecycleHook"
         o.http_method = "POST"

data/lib/aws-sdk-autoscaling/errors.rb

@@ -31,6 +31,8 @@ module Aws::AutoScaling
   #    * This error class is not used. `ActiveInstanceRefreshNotFound` is used during parsing instead.
   # * {AlreadyExistsFault}
   #    * This error class is not used. `AlreadyExists` is used during parsing instead.
+  # * {IdempotentParameterMismatchError}
+  #    * This error class is not used. `IdempotentParameterMismatch` is used during parsing instead.
   # * {InstanceRefreshInProgressFault}
   #    * This error class is not used. `InstanceRefreshInProgress` is used during parsing instead.
   # * {InvalidNextToken}
@@ -86,6 +88,23 @@ module Aws::AutoScaling
       end
     end
 
+    # @deprecated This error class is not used during parsing.
+    #   Please use `IdempotentParameterMismatch` instead.
+    class IdempotentParameterMismatchError < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::AutoScaling::Types::IdempotentParameterMismatchError] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     # @deprecated This error class is not used during parsing.
     #   Please use `InstanceRefreshInProgress` instead.
     class InstanceRefreshInProgressFault < ServiceError

data/lib/aws-sdk-autoscaling/types.rb

@@ -3400,6 +3400,21 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
+    # Indicates that the parameters in the current request do not match the
+    # parameters from a previous request with the same client token within
+    # the idempotency window.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/IdempotentParameterMismatchError AWS API Documentation
+    #
+    class IdempotentParameterMismatchError < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes an EC2 instance.
     #
     # @!attribute [rw] instance_id
@@ -3468,6 +3483,47 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
+    # Contains details about a collection of instances launched in the Auto
+    # Scaling group.
+    #
+    # @!attribute [rw] instance_type
+    #   The instance type of the launched instances.
+    #   @return [String]
+    #
+    # @!attribute [rw] market_type
+    #   The market type for the instances (On-Demand or Spot).
+    #   @return [String]
+    #
+    # @!attribute [rw] subnet_id
+    #   The ID of the subnet where the instances were launched.
+    #   @return [String]
+    #
+    # @!attribute [rw] availability_zone
+    #   The Availability Zone where the instances were launched.
+    #   @return [String]
+    #
+    # @!attribute [rw] availability_zone_id
+    #   The Availability Zone ID where the instances in this collection were
+    #   launched.
+    #   @return [String]
+    #
+    # @!attribute [rw] instance_ids
+    #   A list of instance IDs for the successfully launched instances.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/InstanceCollection AWS API Documentation
+    #
+    class InstanceCollection < Struct.new(
+      :instance_type,
+      :market_type,
+      :subnet_id,
+      :availability_zone,
+      :availability_zone_id,
+      :instance_ids)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes an instance maintenance policy.
     #
     # For more information, see [Set instance maintenance policy][1] in the
@@ -4646,6 +4702,146 @@ module Aws::AutoScaling
       include Aws::Structure
     end
 
+    # Contains details about errors encountered during instance launch
+    # attempts.
+    #
+    # @!attribute [rw] instance_type
+    #   The instance type that failed to launch.
+    #   @return [String]
+    #
+    # @!attribute [rw] market_type
+    #   The market type (On-Demand or Spot) that encountered the launch
+    #   error.
+    #   @return [String]
+    #
+    # @!attribute [rw] subnet_id
+    #   The subnet ID where the instance launch was attempted.
+    #   @return [String]
+    #
+    # @!attribute [rw] availability_zone
+    #   The Availability Zone where the instance launch was attempted.
+    #   @return [String]
+    #
+    # @!attribute [rw] availability_zone_id
+    #   The Availability Zone ID where the launch error occurred.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_code
+    #   The error code representing the type of error encountered (e.g.,
+    #   InsufficientInstanceCapacity).
+    #   @return [String]
+    #
+    # @!attribute [rw] error_message
+    #   A descriptive message providing details about the error encountered
+    #   during the launch attempt.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchInstancesError AWS API Documentation
+    #
+    class LaunchInstancesError < Struct.new(
+      :instance_type,
+      :market_type,
+      :subnet_id,
+      :availability_zone,
+      :availability_zone_id,
+      :error_code,
+      :error_message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] auto_scaling_group_name
+    #   The name of the Auto Scaling group to launch instances into.
+    #   @return [String]
+    #
+    # @!attribute [rw] requested_capacity
+    #   The number of instances to launch. Although this value can exceed
+    #   100 for instance weights, the actual instance count is limited to
+    #   100 instances per launch.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] client_token
+    #   A unique, case-sensitive identifier to ensure idempotency of the
+    #   request.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    # @!attribute [rw] availability_zones
+    #   The Availability Zones for the instance launch. Must match or be
+    #   included in the Auto Scaling group's Availability Zone
+    #   configuration. Either `AvailabilityZones` or `SubnetIds` must be
+    #   specified for groups with multiple Availability Zone configurations.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] availability_zone_ids
+    #   A list of Availability Zone IDs where instances should be launched.
+    #   Must match or be included in the group's AZ configuration. You
+    #   cannot specify both AvailabilityZones and AvailabilityZoneIds.
+    #   Required for multi-AZ groups, optional for single-AZ groups.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] subnet_ids
+    #   The subnet IDs for the instance launch. Either `AvailabilityZones`
+    #   or `SubnetIds` must be specified. If both are specified, the subnets
+    #   must reside in the specified Availability Zones.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] retry_strategy
+    #   Specifies whether to retry asynchronously if the synchronous launch
+    #   fails. Valid values are NONE (default, no async retry) and
+    #   RETRY\_WITH\_GROUP\_CONFIGURATION (increase desired capacity and
+    #   retry with group configuration).
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchInstancesRequest AWS API Documentation
+    #
+    class LaunchInstancesRequest < Struct.new(
+      :auto_scaling_group_name,
+      :requested_capacity,
+      :client_token,
+      :availability_zones,
+      :availability_zone_ids,
+      :subnet_ids,
+      :retry_strategy)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] auto_scaling_group_name
+    #   The name of the Auto Scaling group where the instances were
+    #   launched.
+    #   @return [String]
+    #
+    # @!attribute [rw] client_token
+    #   The idempotency token used for the request, either
+    #   customer-specified or auto-generated.
+    #   @return [String]
+    #
+    # @!attribute [rw] instances
+    #   A list of successfully launched instances including details such as
+    #   instance type, Availability Zone, subnet, lifecycle state, and
+    #   instance IDs.
+    #   @return [Array<Types::InstanceCollection>]
+    #
+    # @!attribute [rw] errors
+    #   A list of errors encountered during the launch attempt including
+    #   details about failed instance launches with their corresponding
+    #   error codes and messages.
+    #   @return [Array<Types::LaunchInstancesError>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchInstancesResult AWS API Documentation
+    #
+    class LaunchInstancesResult < Struct.new(
+      :auto_scaling_group_name,
+      :client_token,
+      :instances,
+      :errors)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Use this structure to specify the launch templates and instance types
     # (overrides) for a mixed instances policy.
     #

data/lib/aws-sdk-autoscaling.rb

@@ -65,7 +65,7 @@ module Aws::AutoScaling
   autoload :ScheduledAction, 'aws-sdk-autoscaling/scheduled_action'
   autoload :Tag, 'aws-sdk-autoscaling/tag'
 
-  GEM_VERSION = '1.146.0'
+  GEM_VERSION = '1.147.0'
 
 end
 

data/sig/client.rbs

@@ -844,6 +844,25 @@ module Aws
                                            ) -> _GetPredictiveScalingForecastResponseSuccess
                                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetPredictiveScalingForecastResponseSuccess
 
+      interface _LaunchInstancesResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::LaunchInstancesResult]
+        def auto_scaling_group_name: () -> ::String
+        def client_token: () -> ::String
+        def instances: () -> ::Array[Types::InstanceCollection]
+        def errors: () -> ::Array[Types::LaunchInstancesError]
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/AutoScaling/Client.html#launch_instances-instance_method
+      def launch_instances: (
+                              auto_scaling_group_name: ::String,
+                              requested_capacity: ::Integer,
+                              client_token: ::String,
+                              ?availability_zones: Array[::String],
+                              ?availability_zone_ids: Array[::String],
+                              ?subnet_ids: Array[::String],
+                              ?retry_strategy: ("retry-with-group-configuration" | "none")
+                            ) -> _LaunchInstancesResponseSuccess
+                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _LaunchInstancesResponseSuccess
+
       interface _PutLifecycleHookResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::PutLifecycleHookAnswer]
       end

data/sig/errors.rbs

@@ -17,6 +17,9 @@ module Aws
       class AlreadyExistsFault < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end
+      class IdempotentParameterMismatchError < ::Aws::Errors::ServiceError
+        def message: () -> ::String
+      end
       class InstanceRefreshInProgressFault < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end

data/sig/types.rbs

@@ -707,6 +707,11 @@ module Aws::AutoScaling
       SENSITIVE: []
     end
 
+    class IdempotentParameterMismatchError
+      attr_accessor message: ::String
+      SENSITIVE: []
+    end
+
     class Instance
       attr_accessor instance_id: ::String
       attr_accessor instance_type: ::String
@@ -720,6 +725,16 @@ module Aws::AutoScaling
       SENSITIVE: []
     end
 
+    class InstanceCollection
+      attr_accessor instance_type: ::String
+      attr_accessor market_type: ::String
+      attr_accessor subnet_id: ::String
+      attr_accessor availability_zone: ::String
+      attr_accessor availability_zone_id: ::String
+      attr_accessor instance_ids: ::Array[::String]
+      SENSITIVE: []
+    end
+
     class InstanceMaintenancePolicy
       attr_accessor min_healthy_percentage: ::Integer
       attr_accessor max_healthy_percentage: ::Integer
@@ -873,6 +888,36 @@ module Aws::AutoScaling
       SENSITIVE: []
     end
 
+    class LaunchInstancesError
+      attr_accessor instance_type: ::String
+      attr_accessor market_type: ::String
+      attr_accessor subnet_id: ::String
+      attr_accessor availability_zone: ::String
+      attr_accessor availability_zone_id: ::String
+      attr_accessor error_code: ::String
+      attr_accessor error_message: ::String
+      SENSITIVE: []
+    end
+
+    class LaunchInstancesRequest
+      attr_accessor auto_scaling_group_name: ::String
+      attr_accessor requested_capacity: ::Integer
+      attr_accessor client_token: ::String
+      attr_accessor availability_zones: ::Array[::String]
+      attr_accessor availability_zone_ids: ::Array[::String]
+      attr_accessor subnet_ids: ::Array[::String]
+      attr_accessor retry_strategy: ("retry-with-group-configuration" | "none")
+      SENSITIVE: []
+    end
+
+    class LaunchInstancesResult
+      attr_accessor auto_scaling_group_name: ::String
+      attr_accessor client_token: ::String
+      attr_accessor instances: ::Array[Types::InstanceCollection]
+      attr_accessor errors: ::Array[Types::LaunchInstancesError]
+      SENSITIVE: []
+    end
+
     class LaunchTemplate
       attr_accessor launch_template_specification: Types::LaunchTemplateSpecification
       attr_accessor overrides: ::Array[Types::LaunchTemplateOverrides]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-autoscaling
 version: !ruby/object:Gem::Version
-  version: 1.146.0
+  version: 1.147.0
 platform: ruby
 authors:
 - Amazon Web Services