Interface LaunchInstancesRequest.Builder

All Superinterfaces:
AutoScalingRequest.Builder, AwsRequest.Builder, Buildable, CopyableBuilder<LaunchInstancesRequest.Builder,LaunchInstancesRequest>, SdkBuilder<LaunchInstancesRequest.Builder,LaunchInstancesRequest>, SdkPojo, SdkRequest.Builder
Enclosing class:
LaunchInstancesRequest
@Mutable @NotThreadSafe public static interface LaunchInstancesRequest.Builder extends AutoScalingRequest.Builder, SdkPojo, CopyableBuilder<LaunchInstancesRequest.Builder,LaunchInstancesRequest>

  • Method Details

    • autoScalingGroupName

      LaunchInstancesRequest.Builder autoScalingGroupName(String autoScalingGroupName)

      The name of the Auto Scaling group to launch instances into.

      Parameters:
      autoScalingGroupName - The name of the Auto Scaling group to launch instances into.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • requestedCapacity

      LaunchInstancesRequest.Builder requestedCapacity(Integer requestedCapacity)

      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.

      Parameters:
      requestedCapacity - 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • clientToken

      LaunchInstancesRequest.Builder clientToken(String clientToken)

      A unique, case-sensitive identifier to ensure idempotency of the request.

      Parameters:
      clientToken - A unique, case-sensitive identifier to ensure idempotency of the request.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • availabilityZones

      LaunchInstancesRequest.Builder availabilityZones(Collection<String> availabilityZones)

      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.

      Parameters:
      availabilityZones - 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • availabilityZones

      LaunchInstancesRequest.Builder availabilityZones(String... availabilityZones)

      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.

      Parameters:
      availabilityZones - 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • availabilityZoneIds

      LaunchInstancesRequest.Builder availabilityZoneIds(Collection<String> availabilityZoneIds)

      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.

      Parameters:
      availabilityZoneIds - 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • availabilityZoneIds

      LaunchInstancesRequest.Builder availabilityZoneIds(String... availabilityZoneIds)

      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.

      Parameters:
      availabilityZoneIds - 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • subnetIds

      LaunchInstancesRequest.Builder subnetIds(Collection<String> subnetIds)

      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.

      Parameters:
      subnetIds - 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • subnetIds

      LaunchInstancesRequest.Builder subnetIds(String... subnetIds)

      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.

      Parameters:
      subnetIds - 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • retryStrategy

      LaunchInstancesRequest.Builder retryStrategy(String retryStrategy)

      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).

      Parameters:
      retryStrategy - 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).
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • retryStrategy

      LaunchInstancesRequest.Builder retryStrategy(RetryStrategy retryStrategy)

      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).

      Parameters:
      retryStrategy - 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).
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • overrideConfiguration

      LaunchInstancesRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration)
      Description copied from interface: AwsRequest.Builder
      Add an optional request override configuration.
      Specified by:
      overrideConfiguration in interface AwsRequest.Builder
      Parameters:
      overrideConfiguration - The override configuration.
      Returns:
      This object for method chaining.

    • overrideConfiguration

      LaunchInstancesRequest.Builder overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer)
      Description copied from interface: AwsRequest.Builder
      Add an optional request override configuration.
      Specified by:
      overrideConfiguration in interface AwsRequest.Builder
      Parameters:
      builderConsumer - A Consumer to which an empty AwsRequestOverrideConfiguration.Builder will be given.
      Returns:
      This object for method chaining.