/*
* Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package com.amazonaws.services.ec2.model;
import java.io.Serializable;
import javax.annotation.Generated;
import com.amazonaws.AmazonWebServiceRequest;
import com.amazonaws.Request;
import com.amazonaws.services.ec2.model.transform.RunInstancesRequestMarshaller;
/**
*
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public class RunInstancesRequest extends AmazonWebServiceRequest implements Serializable, Cloneable, DryRunSupportedRequest
* The block device mapping, which defines the EBS volumes and instance store volumes to attach to the instance at
* launch. For more information, see Block device
* mappings in the Amazon EC2 User Guide.
*
* The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch
* template.
*
* The instance type. For more information, see Instance types in the
* Amazon EC2 User Guide.
*
* The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6
* addresses from the range of your subnet. You cannot specify this option and the option to assign specific IPv6
* addresses in the same request. You can specify this option if you've specified a minimum number of instances to
* launch.
*
* You cannot specify this option and the network interfaces option in the same request.
*
* The IPv6 addresses from the range of the subnet to associate with the primary network interface. You cannot
* specify this option and the option to assign a number of IPv6 addresses in the same request. You cannot specify
* this option if you've specified a minimum number of instances to launch.
*
* You cannot specify this option and the network interfaces option in the same request.
*
* The ID of the kernel.
*
* We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon
* EC2 User Guide.
*
* The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair.
*
* If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured
* to allow users another way to log in.
*
* The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target
* Availability Zone, Amazon EC2 launches the largest possible number of instances above
* Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more
* information about the default limits, and how to request an increase, see How many instances can I run in
* Amazon EC2 in the Amazon EC2 FAQ.
*
* The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can
* launch in the target Availability Zone, Amazon EC2 launches no instances.
*
* Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more
* information about the default limits, and how to request an increase, see How many instances can I run in
* Amazon EC2 in the Amazon EC2 General FAQ.
*
* Specifies whether detailed monitoring is enabled for the instance.
*
* The placement for the instance.
*
* The ID of the RAM disk to select. Some kernels require additional drivers at launch. Check the kernel
* requirements for information about whether you need to specify a RAM disk. To find kernel requirements, go to the
* Amazon Web Services Resource Center and search for the kernel ID.
*
* We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon
* EC2 User Guide.
*
* The IDs of the security groups. You can create a security group using CreateSecurityGroup.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
*
* [Default VPC] The names of the security groups.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
*
* Default: Amazon EC2 uses the default security group.
*
* The ID of the subnet to launch the instance into.
*
* If you specify a network interface, you must specify any subnets as part of the network interface.
*
* The user data script to make available to the instance. For more information, see Run commands on your Linux instance at
* launch and Run
* commands on your Windows instance at launch. If you are using a command line tool, base64-encoding is
* performed for you, and you can load the text from a file. Otherwise, you must provide base64-encoded text. User
* data is limited to 16 KB.
*
* Reserved.
*
* Unique, case-sensitive identifier you provide to ensure the idempotency of the request. If you do not specify a
* client token, a randomly generated token is used for the request to ensure idempotency.
*
* For more information, see Ensuring
* Idempotency.
*
* Constraints: Maximum 64 ASCII characters
*
* If you set this parameter to
* Default:
* Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput
* to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This
* optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized
* instance.
*
* Default:
* The name or Amazon Resource Name (ARN) of an IAM instance profile.
*
* Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the
* operating system command for system shutdown).
*
* Default:
* The network interfaces to associate with the instance. If you specify a network interface, you must specify any
* security groups and subnets as part of the network interface.
*
* The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
*
* Only one private IP address can be designated as primary. You can't specify this option if you've specified the
* option to designate a private IP address as the primary IP address in a network interface specification. You
* cannot specify this option if you're launching more than one instance in the request.
*
* You cannot specify this option and the network interfaces option in the same request.
*
* An elastic GPU to associate with the instance. An Elastic GPU is a GPU resource that you can attach to your
* Windows instance to accelerate the graphics performance of your applications. For more information, see Amazon EC2 Elastic GPUs
* in the Amazon EC2 User Guide.
*
* An elastic inference accelerator to associate with the instance. Elastic inference accelerators are a resource
* you can attach to your Amazon EC2 instances to accelerate your Deep Learning (DL) inference workloads.
*
* You cannot specify accelerators from different generations in the same request.
*
* Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and
* will help current customers migrate their workloads to options that offer better price and performance. After
* April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon
* SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past
* 30-day period are considered current customers and will be able to continue using the service.
*
* The tags to apply to the resources that are created during instance launch.
*
* You can specify tags for the following resources only:
*
* Instances
*
* Volumes
*
* Elastic graphics
*
* Spot Instance requests
*
* Network interfaces
*
* To tag a resource after it has been created, see CreateTags.
*
* The launch template to use to launch the instances. Any parameters that you specify in RunInstances
* override the same parameters in the launch template. You can specify either the name or ID of a launch template,
* but not both.
*
* The market (purchasing) option for the instances.
*
* For RunInstances, persistent Spot Instance requests are only supported when
* InstanceInterruptionBehavior is set to either
* The credit option for CPU usage of the burstable performance instance. Valid values are
* Default:
* For T3 instances with
* The CPU options for the instance. For more information, see Optimize CPU options in
* the Amazon EC2 User Guide.
*
* Information about the Capacity Reservation targeting option. If you do not specify this parameter, the instance's
* Capacity Reservation preference defaults to
* Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance meets the
* hibernation
* prerequisites. For more information, see Hibernate your instance in the
* Amazon EC2 User Guide.
*
* You can't enable hibernation and Amazon Web Services Nitro Enclaves on the same instance.
*
* The license configurations.
*
* The metadata options for the instance. For more information, see Instance metadata and user
* data.
*
* Indicates whether the instance is enabled for Amazon Web Services Nitro Enclaves. For more information, see What is Amazon Web Services Nitro
* Enclaves? in the Amazon Web Services Nitro Enclaves User Guide.
*
* You can't enable Amazon Web Services Nitro Enclaves and hibernation on the same instance.
*
* The options for the instance hostname. The default values are inherited from the subnet. Applies only if creating
* a network interface, not attaching an existing one.
*
* The maintenance and recovery options for the instance.
*
* Indicates whether an instance is enabled for stop protection. For more information, see Stop
* protection.
* MinCount
.
* true
, you can't terminate the instance using the Amazon EC2 console,
* CLI, or API; otherwise, you can. To change this attribute after launch, use ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior
to
* terminate
, you can terminate the instance by running the shutdown command from the instance.
* false
* false
* stop
*
*
* hibernate
or stop
.
* standard
and
* unlimited
. To change this attribute after launch, use
* ModifyInstanceCreditSpecification. For more information, see Burstable
* performance instances in the Amazon EC2 User Guide.
* standard
(T2 instances) or unlimited
(T3/T3a/T4g instances)
* host
tenancy, only standard
is supported.
* open
, which enables it to run in any open Capacity
* Reservation that has matching attributes (instance type, platform, Availability Zone).
*
* Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more
* information about the default limits, and how to request an increase, see How many instances can I
* run in Amazon EC2 in the Amazon EC2 General FAQ.
* @param maxCount
* The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the
* target Availability Zone, Amazon EC2 launches the largest possible number of instances above
* MinCount
.
*
* Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can I * run in Amazon EC2 in the Amazon EC2 FAQ. */ public RunInstancesRequest(String imageId, Integer minCount, Integer maxCount) { setImageId(imageId); setMinCount(minCount); setMaxCount(maxCount); } /** *
* The block device mapping, which defines the EBS volumes and instance store volumes to attach to the instance at * launch. For more information, see Block device * mappings in the Amazon EC2 User Guide. *
* * @return The block device mapping, which defines the EBS volumes and instance store volumes to attach to the * instance at launch. For more information, see Block * device mappings in the Amazon EC2 User Guide. */ public java.util.List* The block device mapping, which defines the EBS volumes and instance store volumes to attach to the instance at * launch. For more information, see Block device * mappings in the Amazon EC2 User Guide. *
* * @param blockDeviceMappings * The block device mapping, which defines the EBS volumes and instance store volumes to attach to the * instance at launch. For more information, see Block device * mappings in the Amazon EC2 User Guide. */ public void setBlockDeviceMappings(java.util.Collection* The block device mapping, which defines the EBS volumes and instance store volumes to attach to the instance at * launch. For more information, see Block device * mappings in the Amazon EC2 User Guide. *
** NOTE: This method appends the values to the existing list (if any). Use * {@link #setBlockDeviceMappings(java.util.Collection)} or {@link #withBlockDeviceMappings(java.util.Collection)} * if you want to override the existing values. *
* * @param blockDeviceMappings * The block device mapping, which defines the EBS volumes and instance store volumes to attach to the * instance at launch. For more information, see Block device * mappings in the Amazon EC2 User Guide. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withBlockDeviceMappings(BlockDeviceMapping... blockDeviceMappings) { if (this.blockDeviceMappings == null) { setBlockDeviceMappings(new com.amazonaws.internal.SdkInternalList* The block device mapping, which defines the EBS volumes and instance store volumes to attach to the instance at * launch. For more information, see Block device * mappings in the Amazon EC2 User Guide. *
* * @param blockDeviceMappings * The block device mapping, which defines the EBS volumes and instance store volumes to attach to the * instance at launch. For more information, see Block device * mappings in the Amazon EC2 User Guide. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withBlockDeviceMappings(java.util.Collection* The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch * template. *
* * @param imageId * The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch * template. */ public void setImageId(String imageId) { this.imageId = imageId; } /** ** The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch * template. *
* * @return The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch * template. */ public String getImageId() { return this.imageId; } /** ** The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch * template. *
* * @param imageId * The ID of the AMI. An AMI ID is required to launch an instance and must be specified here or in a launch * template. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withImageId(String imageId) { setImageId(imageId); return this; } /** ** The instance type. For more information, see Instance types in the * Amazon EC2 User Guide. *
* * @param instanceType * The instance type. For more information, see Instance types in the * Amazon EC2 User Guide. * @see InstanceType */ public void setInstanceType(String instanceType) { this.instanceType = instanceType; } /** ** The instance type. For more information, see Instance types in the * Amazon EC2 User Guide. *
* * @return The instance type. For more information, see Instance types in the * Amazon EC2 User Guide. * @see InstanceType */ public String getInstanceType() { return this.instanceType; } /** ** The instance type. For more information, see Instance types in the * Amazon EC2 User Guide. *
* * @param instanceType * The instance type. For more information, see Instance types in the * Amazon EC2 User Guide. * @return Returns a reference to this object so that method calls can be chained together. * @see InstanceType */ public RunInstancesRequest withInstanceType(String instanceType) { setInstanceType(instanceType); return this; } /** ** The instance type. For more information, see Instance types in the * Amazon EC2 User Guide. *
* * @param instanceType * The instance type. For more information, see Instance types in the * Amazon EC2 User Guide. * @see InstanceType */ public void setInstanceType(InstanceType instanceType) { withInstanceType(instanceType); } /** ** The instance type. For more information, see Instance types in the * Amazon EC2 User Guide. *
* * @param instanceType * The instance type. For more information, see Instance types in the * Amazon EC2 User Guide. * @return Returns a reference to this object so that method calls can be chained together. * @see InstanceType */ public RunInstancesRequest withInstanceType(InstanceType instanceType) { this.instanceType = instanceType.toString(); return this; } /** ** The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 * addresses from the range of your subnet. You cannot specify this option and the option to assign specific IPv6 * addresses in the same request. You can specify this option if you've specified a minimum number of instances to * launch. *
** You cannot specify this option and the network interfaces option in the same request. *
* * @param ipv6AddressCount * The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 * addresses from the range of your subnet. You cannot specify this option and the option to assign specific * IPv6 addresses in the same request. You can specify this option if you've specified a minimum number of * instances to launch. ** You cannot specify this option and the network interfaces option in the same request. */ public void setIpv6AddressCount(Integer ipv6AddressCount) { this.ipv6AddressCount = ipv6AddressCount; } /** *
* The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 * addresses from the range of your subnet. You cannot specify this option and the option to assign specific IPv6 * addresses in the same request. You can specify this option if you've specified a minimum number of instances to * launch. *
** You cannot specify this option and the network interfaces option in the same request. *
* * @return The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 * addresses from the range of your subnet. You cannot specify this option and the option to assign specific * IPv6 addresses in the same request. You can specify this option if you've specified a minimum number of * instances to launch. ** You cannot specify this option and the network interfaces option in the same request. */ public Integer getIpv6AddressCount() { return this.ipv6AddressCount; } /** *
* The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 * addresses from the range of your subnet. You cannot specify this option and the option to assign specific IPv6 * addresses in the same request. You can specify this option if you've specified a minimum number of instances to * launch. *
** You cannot specify this option and the network interfaces option in the same request. *
* * @param ipv6AddressCount * The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 * addresses from the range of your subnet. You cannot specify this option and the option to assign specific * IPv6 addresses in the same request. You can specify this option if you've specified a minimum number of * instances to launch. ** You cannot specify this option and the network interfaces option in the same request. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withIpv6AddressCount(Integer ipv6AddressCount) { setIpv6AddressCount(ipv6AddressCount); return this; } /** *
* The IPv6 addresses from the range of the subnet to associate with the primary network interface. You cannot * specify this option and the option to assign a number of IPv6 addresses in the same request. You cannot specify * this option if you've specified a minimum number of instances to launch. *
** You cannot specify this option and the network interfaces option in the same request. *
* * @return The IPv6 addresses from the range of the subnet to associate with the primary network interface. You * cannot specify this option and the option to assign a number of IPv6 addresses in the same request. You * cannot specify this option if you've specified a minimum number of instances to launch. *
* You cannot specify this option and the network interfaces option in the same request.
*/
public java.util.List
* The IPv6 addresses from the range of the subnet to associate with the primary network interface. You cannot
* specify this option and the option to assign a number of IPv6 addresses in the same request. You cannot specify
* this option if you've specified a minimum number of instances to launch.
*
* You cannot specify this option and the network interfaces option in the same request.
*
* You cannot specify this option and the network interfaces option in the same request.
*/
public void setIpv6Addresses(java.util.Collection
* The IPv6 addresses from the range of the subnet to associate with the primary network interface. You cannot
* specify this option and the option to assign a number of IPv6 addresses in the same request. You cannot specify
* this option if you've specified a minimum number of instances to launch.
*
* You cannot specify this option and the network interfaces option in the same request.
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setIpv6Addresses(java.util.Collection)} or {@link #withIpv6Addresses(java.util.Collection)} if you want
* to override the existing values.
*
* You cannot specify this option and the network interfaces option in the same request.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withIpv6Addresses(InstanceIpv6Address... ipv6Addresses) {
if (this.ipv6Addresses == null) {
setIpv6Addresses(new com.amazonaws.internal.SdkInternalList
* The IPv6 addresses from the range of the subnet to associate with the primary network interface. You cannot
* specify this option and the option to assign a number of IPv6 addresses in the same request. You cannot specify
* this option if you've specified a minimum number of instances to launch.
*
* You cannot specify this option and the network interfaces option in the same request.
*
* You cannot specify this option and the network interfaces option in the same request.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withIpv6Addresses(java.util.Collection
* The ID of the kernel.
*
* We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon
* EC2 User Guide.
*
* We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the * Amazon EC2 User Guide. *
*/ public void setKernelId(String kernelId) { this.kernelId = kernelId; } /** ** The ID of the kernel. *
** We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon * EC2 User Guide. *
** We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the * Amazon EC2 User Guide. *
*/ public String getKernelId() { return this.kernelId; } /** ** The ID of the kernel. *
** We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon * EC2 User Guide. *
** We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the * Amazon EC2 User Guide. *
* @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withKernelId(String kernelId) { setKernelId(kernelId); return this; } /** ** The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair. *
** If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured * to allow users another way to log in. *
** If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is * configured to allow users another way to log in. *
*/ public void setKeyName(String keyName) { this.keyName = keyName; } /** ** The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair. *
** If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured * to allow users another way to log in. *
** If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is * configured to allow users another way to log in. *
*/ public String getKeyName() { return this.keyName; } /** ** The name of the key pair. You can create a key pair using CreateKeyPair or ImportKeyPair. *
** If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is configured * to allow users another way to log in. *
** If you do not specify a key pair, you can't connect to the instance unless you choose an AMI that is * configured to allow users another way to log in. *
* @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withKeyName(String keyName) { setKeyName(keyName); return this; } /** *
* The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target
* Availability Zone, Amazon EC2 launches the largest possible number of instances above MinCount
.
*
* Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can I run in * Amazon EC2 in the Amazon EC2 FAQ. *
* * @param maxCount * The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the * target Availability Zone, Amazon EC2 launches the largest possible number of instances above *MinCount
.
* * Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can I * run in Amazon EC2 in the Amazon EC2 FAQ. */ public void setMaxCount(Integer maxCount) { this.maxCount = maxCount; } /** *
* The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target
* Availability Zone, Amazon EC2 launches the largest possible number of instances above MinCount
.
*
* Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can I run in * Amazon EC2 in the Amazon EC2 FAQ. *
* * @return The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in * the target Availability Zone, Amazon EC2 launches the largest possible number of instances above *MinCount
.
* * Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can * I run in Amazon EC2 in the Amazon EC2 FAQ. */ public Integer getMaxCount() { return this.maxCount; } /** *
* The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the target
* Availability Zone, Amazon EC2 launches the largest possible number of instances above MinCount
.
*
* Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can I run in * Amazon EC2 in the Amazon EC2 FAQ. *
* * @param maxCount * The maximum number of instances to launch. If you specify more instances than Amazon EC2 can launch in the * target Availability Zone, Amazon EC2 launches the largest possible number of instances above *MinCount
.
* * Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can I * run in Amazon EC2 in the Amazon EC2 FAQ. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withMaxCount(Integer maxCount) { setMaxCount(maxCount); return this; } /** *
* The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can * launch in the target Availability Zone, Amazon EC2 launches no instances. *
** Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can I run in * Amazon EC2 in the Amazon EC2 General FAQ. *
* * @param minCount * The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 * can launch in the target Availability Zone, Amazon EC2 launches no instances. ** Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can I * run in Amazon EC2 in the Amazon EC2 General FAQ. */ public void setMinCount(Integer minCount) { this.minCount = minCount; } /** *
* The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can * launch in the target Availability Zone, Amazon EC2 launches no instances. *
** Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can I run in * Amazon EC2 in the Amazon EC2 General FAQ. *
* * @return The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon * EC2 can launch in the target Availability Zone, Amazon EC2 launches no instances. ** Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can * I run in Amazon EC2 in the Amazon EC2 General FAQ. */ public Integer getMinCount() { return this.minCount; } /** *
* The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 can * launch in the target Availability Zone, Amazon EC2 launches no instances. *
** Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can I run in * Amazon EC2 in the Amazon EC2 General FAQ. *
* * @param minCount * The minimum number of instances to launch. If you specify a minimum that is more instances than Amazon EC2 * can launch in the target Availability Zone, Amazon EC2 launches no instances. ** Constraints: Between 1 and the maximum number you're allowed for the specified instance type. For more * information about the default limits, and how to request an increase, see How many instances can I * run in Amazon EC2 in the Amazon EC2 General FAQ. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withMinCount(Integer minCount) { setMinCount(minCount); return this; } /** *
* Specifies whether detailed monitoring is enabled for the instance. *
* * @param monitoring * Specifies whether detailed monitoring is enabled for the instance. */ public void setMonitoring(Boolean monitoring) { this.monitoring = monitoring; } /** ** Specifies whether detailed monitoring is enabled for the instance. *
* * @return Specifies whether detailed monitoring is enabled for the instance. */ public Boolean getMonitoring() { return this.monitoring; } /** ** Specifies whether detailed monitoring is enabled for the instance. *
* * @param monitoring * Specifies whether detailed monitoring is enabled for the instance. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withMonitoring(Boolean monitoring) { setMonitoring(monitoring); return this; } /** ** Specifies whether detailed monitoring is enabled for the instance. *
* * @return Specifies whether detailed monitoring is enabled for the instance. */ public Boolean isMonitoring() { return this.monitoring; } /** ** The placement for the instance. *
* * @param placement * The placement for the instance. */ public void setPlacement(Placement placement) { this.placement = placement; } /** ** The placement for the instance. *
* * @return The placement for the instance. */ public Placement getPlacement() { return this.placement; } /** ** The placement for the instance. *
* * @param placement * The placement for the instance. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withPlacement(Placement placement) { setPlacement(placement); return this; } /** ** The ID of the RAM disk to select. Some kernels require additional drivers at launch. Check the kernel * requirements for information about whether you need to specify a RAM disk. To find kernel requirements, go to the * Amazon Web Services Resource Center and search for the kernel ID. *
** We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon * EC2 User Guide. *
** We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the * Amazon EC2 User Guide. *
*/ public void setRamdiskId(String ramdiskId) { this.ramdiskId = ramdiskId; } /** ** The ID of the RAM disk to select. Some kernels require additional drivers at launch. Check the kernel * requirements for information about whether you need to specify a RAM disk. To find kernel requirements, go to the * Amazon Web Services Resource Center and search for the kernel ID. *
** We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon * EC2 User Guide. *
** We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the * Amazon EC2 User Guide. *
*/ public String getRamdiskId() { return this.ramdiskId; } /** ** The ID of the RAM disk to select. Some kernels require additional drivers at launch. Check the kernel * requirements for information about whether you need to specify a RAM disk. To find kernel requirements, go to the * Amazon Web Services Resource Center and search for the kernel ID. *
** We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the Amazon * EC2 User Guide. *
** We recommend that you use PV-GRUB instead of kernels and RAM disks. For more information, see PV-GRUB in the * Amazon EC2 User Guide. *
* @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withRamdiskId(String ramdiskId) { setRamdiskId(ramdiskId); return this; } /** ** The IDs of the security groups. You can create a security group using CreateSecurityGroup. *
** If you specify a network interface, you must specify any security groups as part of the network interface. *
* * @return The IDs of the security groups. You can create a security group using CreateSecurityGroup. *
* If you specify a network interface, you must specify any security groups as part of the network
* interface.
*/
public java.util.List
* The IDs of the security groups. You can create a security group using CreateSecurityGroup.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
*/
public void setSecurityGroupIds(java.util.Collection
* The IDs of the security groups. You can create a security group using CreateSecurityGroup.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setSecurityGroupIds(java.util.Collection)} or {@link #withSecurityGroupIds(java.util.Collection)} if you
* want to override the existing values.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withSecurityGroupIds(String... securityGroupIds) {
if (this.securityGroupIds == null) {
setSecurityGroupIds(new com.amazonaws.internal.SdkInternalList
* The IDs of the security groups. You can create a security group using CreateSecurityGroup.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withSecurityGroupIds(java.util.Collection
* [Default VPC] The names of the security groups.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
*
* Default: Amazon EC2 uses the default security group.
*
* If you specify a network interface, you must specify any security groups as part of the network * interface. *
*
* Default: Amazon EC2 uses the default security group.
*/
public java.util.List
* [Default VPC] The names of the security groups.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
*
* Default: Amazon EC2 uses the default security group.
*
* If you specify a network interface, you must specify any security groups as part of the network interface. *
*
* Default: Amazon EC2 uses the default security group.
*/
public void setSecurityGroups(java.util.Collection
* [Default VPC] The names of the security groups.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
*
* Default: Amazon EC2 uses the default security group.
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setSecurityGroups(java.util.Collection)} or {@link #withSecurityGroups(java.util.Collection)} if you want
* to override the existing values.
*
* If you specify a network interface, you must specify any security groups as part of the network interface. *
*
* Default: Amazon EC2 uses the default security group.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withSecurityGroups(String... securityGroups) {
if (this.securityGroups == null) {
setSecurityGroups(new com.amazonaws.internal.SdkInternalList
* [Default VPC] The names of the security groups.
*
* If you specify a network interface, you must specify any security groups as part of the network interface.
*
* Default: Amazon EC2 uses the default security group.
*
* If you specify a network interface, you must specify any security groups as part of the network interface. *
*
* Default: Amazon EC2 uses the default security group.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withSecurityGroups(java.util.Collection
* The ID of the subnet to launch the instance into.
*
* If you specify a network interface, you must specify any subnets as part of the network interface.
*
* If you specify a network interface, you must specify any subnets as part of the network interface. */ public void setSubnetId(String subnetId) { this.subnetId = subnetId; } /** *
* The ID of the subnet to launch the instance into. *
** If you specify a network interface, you must specify any subnets as part of the network interface. *
* * @return The ID of the subnet to launch the instance into. ** If you specify a network interface, you must specify any subnets as part of the network interface. */ public String getSubnetId() { return this.subnetId; } /** *
* The ID of the subnet to launch the instance into. *
** If you specify a network interface, you must specify any subnets as part of the network interface. *
* * @param subnetId * The ID of the subnet to launch the instance into. ** If you specify a network interface, you must specify any subnets as part of the network interface. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withSubnetId(String subnetId) { setSubnetId(subnetId); return this; } /** *
* The user data script to make available to the instance. For more information, see Run commands on your Linux instance at * launch and Run * commands on your Windows instance at launch. If you are using a command line tool, base64-encoding is * performed for you, and you can load the text from a file. Otherwise, you must provide base64-encoded text. User * data is limited to 16 KB. *
* * @param userData * The user data script to make available to the instance. For more information, see Run commands on your Linux * instance at launch and Run commands on * your Windows instance at launch. If you are using a command line tool, base64-encoding is performed * for you, and you can load the text from a file. Otherwise, you must provide base64-encoded text. User data * is limited to 16 KB. */ public void setUserData(String userData) { this.userData = userData; } /** ** The user data script to make available to the instance. For more information, see Run commands on your Linux instance at * launch and Run * commands on your Windows instance at launch. If you are using a command line tool, base64-encoding is * performed for you, and you can load the text from a file. Otherwise, you must provide base64-encoded text. User * data is limited to 16 KB. *
* * @return The user data script to make available to the instance. For more information, see Run commands on your Linux * instance at launch and Run commands on * your Windows instance at launch. If you are using a command line tool, base64-encoding is performed * for you, and you can load the text from a file. Otherwise, you must provide base64-encoded text. User * data is limited to 16 KB. */ public String getUserData() { return this.userData; } /** ** The user data script to make available to the instance. For more information, see Run commands on your Linux instance at * launch and Run * commands on your Windows instance at launch. If you are using a command line tool, base64-encoding is * performed for you, and you can load the text from a file. Otherwise, you must provide base64-encoded text. User * data is limited to 16 KB. *
* * @param userData * The user data script to make available to the instance. For more information, see Run commands on your Linux * instance at launch and Run commands on * your Windows instance at launch. If you are using a command line tool, base64-encoding is performed * for you, and you can load the text from a file. Otherwise, you must provide base64-encoded text. User data * is limited to 16 KB. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withUserData(String userData) { setUserData(userData); return this; } /** ** Reserved. *
* * @param additionalInfo * Reserved. */ public void setAdditionalInfo(String additionalInfo) { this.additionalInfo = additionalInfo; } /** ** Reserved. *
* * @return Reserved. */ public String getAdditionalInfo() { return this.additionalInfo; } /** ** Reserved. *
* * @param additionalInfo * Reserved. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withAdditionalInfo(String additionalInfo) { setAdditionalInfo(additionalInfo); return this; } /** ** Unique, case-sensitive identifier you provide to ensure the idempotency of the request. If you do not specify a * client token, a randomly generated token is used for the request to ensure idempotency. *
** For more information, see Ensuring * Idempotency. *
** Constraints: Maximum 64 ASCII characters *
* * @param clientToken * Unique, case-sensitive identifier you provide to ensure the idempotency of the request. If you do not * specify a client token, a randomly generated token is used for the request to ensure idempotency. ** For more information, see Ensuring * Idempotency. *
** Constraints: Maximum 64 ASCII characters */ public void setClientToken(String clientToken) { this.clientToken = clientToken; } /** *
* Unique, case-sensitive identifier you provide to ensure the idempotency of the request. If you do not specify a * client token, a randomly generated token is used for the request to ensure idempotency. *
** For more information, see Ensuring * Idempotency. *
** Constraints: Maximum 64 ASCII characters *
* * @return Unique, case-sensitive identifier you provide to ensure the idempotency of the request. If you do not * specify a client token, a randomly generated token is used for the request to ensure idempotency. ** For more information, see Ensuring * Idempotency. *
** Constraints: Maximum 64 ASCII characters */ public String getClientToken() { return this.clientToken; } /** *
* Unique, case-sensitive identifier you provide to ensure the idempotency of the request. If you do not specify a * client token, a randomly generated token is used for the request to ensure idempotency. *
** For more information, see Ensuring * Idempotency. *
** Constraints: Maximum 64 ASCII characters *
* * @param clientToken * Unique, case-sensitive identifier you provide to ensure the idempotency of the request. If you do not * specify a client token, a randomly generated token is used for the request to ensure idempotency. ** For more information, see Ensuring * Idempotency. *
** Constraints: Maximum 64 ASCII characters * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withClientToken(String clientToken) { setClientToken(clientToken); return this; } /** *
* If you set this parameter to true
, you can't terminate the instance using the Amazon EC2 console,
* CLI, or API; otherwise, you can. To change this attribute after launch, use ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior
to
* terminate
, you can terminate the instance by running the shutdown command from the instance.
*
* Default: false
*
true
, you can't terminate the instance using the Amazon EC2
* console, CLI, or API; otherwise, you can. To change this attribute after launch, use ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior
to
* terminate
, you can terminate the instance by running the shutdown command from the
* instance.
*
* Default: false
*/
public void setDisableApiTermination(Boolean disableApiTermination) {
this.disableApiTermination = disableApiTermination;
}
/**
*
* If you set this parameter to true
, you can't terminate the instance using the Amazon EC2 console,
* CLI, or API; otherwise, you can. To change this attribute after launch, use ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior
to
* terminate
, you can terminate the instance by running the shutdown command from the instance.
*
* Default: false
*
true
, you can't terminate the instance using the Amazon EC2
* console, CLI, or API; otherwise, you can. To change this attribute after launch, use ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior
to
* terminate
, you can terminate the instance by running the shutdown command from the
* instance.
*
* Default: false
*/
public Boolean getDisableApiTermination() {
return this.disableApiTermination;
}
/**
*
* If you set this parameter to true
, you can't terminate the instance using the Amazon EC2 console,
* CLI, or API; otherwise, you can. To change this attribute after launch, use ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior
to
* terminate
, you can terminate the instance by running the shutdown command from the instance.
*
* Default: false
*
true
, you can't terminate the instance using the Amazon EC2
* console, CLI, or API; otherwise, you can. To change this attribute after launch, use ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior
to
* terminate
, you can terminate the instance by running the shutdown command from the
* instance.
*
* Default: false
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withDisableApiTermination(Boolean disableApiTermination) {
setDisableApiTermination(disableApiTermination);
return this;
}
/**
*
* If you set this parameter to true
, you can't terminate the instance using the Amazon EC2 console,
* CLI, or API; otherwise, you can. To change this attribute after launch, use ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior
to
* terminate
, you can terminate the instance by running the shutdown command from the instance.
*
* Default: false
*
true
, you can't terminate the instance using the Amazon EC2
* console, CLI, or API; otherwise, you can. To change this attribute after launch, use ModifyInstanceAttribute. Alternatively, if you set InstanceInitiatedShutdownBehavior
to
* terminate
, you can terminate the instance by running the shutdown command from the
* instance.
*
* Default: false
*/
public Boolean isDisableApiTermination() {
return this.disableApiTermination;
}
/**
*
* Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput * to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This * optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized * instance. *
*
* Default: false
*
* Default: false
*/
public void setEbsOptimized(Boolean ebsOptimized) {
this.ebsOptimized = ebsOptimized;
}
/**
*
* Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput * to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This * optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized * instance. *
*
* Default: false
*
* Default: false
*/
public Boolean getEbsOptimized() {
return this.ebsOptimized;
}
/**
*
* Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput * to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This * optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized * instance. *
*
* Default: false
*
* Default: false
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withEbsOptimized(Boolean ebsOptimized) {
setEbsOptimized(ebsOptimized);
return this;
}
/**
*
* Indicates whether the instance is optimized for Amazon EBS I/O. This optimization provides dedicated throughput * to Amazon EBS and an optimized configuration stack to provide optimal Amazon EBS I/O performance. This * optimization isn't available with all instance types. Additional usage charges apply when using an EBS-optimized * instance. *
*
* Default: false
*
* Default: false
*/
public Boolean isEbsOptimized() {
return this.ebsOptimized;
}
/**
*
* The name or Amazon Resource Name (ARN) of an IAM instance profile. *
* * @param iamInstanceProfile * The name or Amazon Resource Name (ARN) of an IAM instance profile. */ public void setIamInstanceProfile(IamInstanceProfileSpecification iamInstanceProfile) { this.iamInstanceProfile = iamInstanceProfile; } /** ** The name or Amazon Resource Name (ARN) of an IAM instance profile. *
* * @return The name or Amazon Resource Name (ARN) of an IAM instance profile. */ public IamInstanceProfileSpecification getIamInstanceProfile() { return this.iamInstanceProfile; } /** ** The name or Amazon Resource Name (ARN) of an IAM instance profile. *
* * @param iamInstanceProfile * The name or Amazon Resource Name (ARN) of an IAM instance profile. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withIamInstanceProfile(IamInstanceProfileSpecification iamInstanceProfile) { setIamInstanceProfile(iamInstanceProfile); return this; } /** ** Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the * operating system command for system shutdown). *
*
* Default: stop
*
* Default: stop
* @see ShutdownBehavior
*/
public void setInstanceInitiatedShutdownBehavior(String instanceInitiatedShutdownBehavior) {
this.instanceInitiatedShutdownBehavior = instanceInitiatedShutdownBehavior;
}
/**
*
* Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the * operating system command for system shutdown). *
*
* Default: stop
*
* Default: stop
* @see ShutdownBehavior
*/
public String getInstanceInitiatedShutdownBehavior() {
return this.instanceInitiatedShutdownBehavior;
}
/**
*
* Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the * operating system command for system shutdown). *
*
* Default: stop
*
* Default: stop
* @return Returns a reference to this object so that method calls can be chained together.
* @see ShutdownBehavior
*/
public RunInstancesRequest withInstanceInitiatedShutdownBehavior(String instanceInitiatedShutdownBehavior) {
setInstanceInitiatedShutdownBehavior(instanceInitiatedShutdownBehavior);
return this;
}
/**
*
* Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the * operating system command for system shutdown). *
*
* Default: stop
*
* Default: stop
* @see ShutdownBehavior
*/
public void setInstanceInitiatedShutdownBehavior(ShutdownBehavior instanceInitiatedShutdownBehavior) {
withInstanceInitiatedShutdownBehavior(instanceInitiatedShutdownBehavior);
}
/**
*
* Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the * operating system command for system shutdown). *
*
* Default: stop
*
* Default: stop
* @return Returns a reference to this object so that method calls can be chained together.
* @see ShutdownBehavior
*/
public RunInstancesRequest withInstanceInitiatedShutdownBehavior(ShutdownBehavior instanceInitiatedShutdownBehavior) {
this.instanceInitiatedShutdownBehavior = instanceInitiatedShutdownBehavior.toString();
return this;
}
/**
*
* The network interfaces to associate with the instance. If you specify a network interface, you must specify any * security groups and subnets as part of the network interface. *
* * @return The network interfaces to associate with the instance. If you specify a network interface, you must * specify any security groups and subnets as part of the network interface. */ public java.util.List* The network interfaces to associate with the instance. If you specify a network interface, you must specify any * security groups and subnets as part of the network interface. *
* * @param networkInterfaces * The network interfaces to associate with the instance. If you specify a network interface, you must * specify any security groups and subnets as part of the network interface. */ public void setNetworkInterfaces(java.util.Collection* The network interfaces to associate with the instance. If you specify a network interface, you must specify any * security groups and subnets as part of the network interface. *
** NOTE: This method appends the values to the existing list (if any). Use * {@link #setNetworkInterfaces(java.util.Collection)} or {@link #withNetworkInterfaces(java.util.Collection)} if * you want to override the existing values. *
* * @param networkInterfaces * The network interfaces to associate with the instance. If you specify a network interface, you must * specify any security groups and subnets as part of the network interface. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withNetworkInterfaces(InstanceNetworkInterfaceSpecification... networkInterfaces) { if (this.networkInterfaces == null) { setNetworkInterfaces(new com.amazonaws.internal.SdkInternalList* The network interfaces to associate with the instance. If you specify a network interface, you must specify any * security groups and subnets as part of the network interface. *
* * @param networkInterfaces * The network interfaces to associate with the instance. If you specify a network interface, you must * specify any security groups and subnets as part of the network interface. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withNetworkInterfaces(java.util.Collection* The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet. *
** Only one private IP address can be designated as primary. You can't specify this option if you've specified the * option to designate a private IP address as the primary IP address in a network interface specification. You * cannot specify this option if you're launching more than one instance in the request. *
** You cannot specify this option and the network interfaces option in the same request. *
* * @param privateIpAddress * The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet. ** Only one private IP address can be designated as primary. You can't specify this option if you've * specified the option to designate a private IP address as the primary IP address in a network interface * specification. You cannot specify this option if you're launching more than one instance in the request. *
** You cannot specify this option and the network interfaces option in the same request. */ public void setPrivateIpAddress(String privateIpAddress) { this.privateIpAddress = privateIpAddress; } /** *
* The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet. *
** Only one private IP address can be designated as primary. You can't specify this option if you've specified the * option to designate a private IP address as the primary IP address in a network interface specification. You * cannot specify this option if you're launching more than one instance in the request. *
** You cannot specify this option and the network interfaces option in the same request. *
* * @return The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet. ** Only one private IP address can be designated as primary. You can't specify this option if you've * specified the option to designate a private IP address as the primary IP address in a network interface * specification. You cannot specify this option if you're launching more than one instance in the request. *
** You cannot specify this option and the network interfaces option in the same request. */ public String getPrivateIpAddress() { return this.privateIpAddress; } /** *
* The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet. *
** Only one private IP address can be designated as primary. You can't specify this option if you've specified the * option to designate a private IP address as the primary IP address in a network interface specification. You * cannot specify this option if you're launching more than one instance in the request. *
** You cannot specify this option and the network interfaces option in the same request. *
* * @param privateIpAddress * The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet. ** Only one private IP address can be designated as primary. You can't specify this option if you've * specified the option to designate a private IP address as the primary IP address in a network interface * specification. You cannot specify this option if you're launching more than one instance in the request. *
** You cannot specify this option and the network interfaces option in the same request. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withPrivateIpAddress(String privateIpAddress) { setPrivateIpAddress(privateIpAddress); return this; } /** *
* An elastic GPU to associate with the instance. An Elastic GPU is a GPU resource that you can attach to your * Windows instance to accelerate the graphics performance of your applications. For more information, see Amazon EC2 Elastic GPUs * in the Amazon EC2 User Guide. *
* * @return An elastic GPU to associate with the instance. An Elastic GPU is a GPU resource that you can attach to * your Windows instance to accelerate the graphics performance of your applications. For more information, * see Amazon EC2 * Elastic GPUs in the Amazon EC2 User Guide. */ public java.util.List* An elastic GPU to associate with the instance. An Elastic GPU is a GPU resource that you can attach to your * Windows instance to accelerate the graphics performance of your applications. For more information, see Amazon EC2 Elastic GPUs * in the Amazon EC2 User Guide. *
* * @param elasticGpuSpecification * An elastic GPU to associate with the instance. An Elastic GPU is a GPU resource that you can attach to * your Windows instance to accelerate the graphics performance of your applications. For more information, * see Amazon EC2 * Elastic GPUs in the Amazon EC2 User Guide. */ public void setElasticGpuSpecification(java.util.Collection* An elastic GPU to associate with the instance. An Elastic GPU is a GPU resource that you can attach to your * Windows instance to accelerate the graphics performance of your applications. For more information, see Amazon EC2 Elastic GPUs * in the Amazon EC2 User Guide. *
** NOTE: This method appends the values to the existing list (if any). Use * {@link #setElasticGpuSpecification(java.util.Collection)} or * {@link #withElasticGpuSpecification(java.util.Collection)} if you want to override the existing values. *
* * @param elasticGpuSpecification * An elastic GPU to associate with the instance. An Elastic GPU is a GPU resource that you can attach to * your Windows instance to accelerate the graphics performance of your applications. For more information, * see Amazon EC2 * Elastic GPUs in the Amazon EC2 User Guide. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withElasticGpuSpecification(ElasticGpuSpecification... elasticGpuSpecification) { if (this.elasticGpuSpecification == null) { setElasticGpuSpecification(new com.amazonaws.internal.SdkInternalList* An elastic GPU to associate with the instance. An Elastic GPU is a GPU resource that you can attach to your * Windows instance to accelerate the graphics performance of your applications. For more information, see Amazon EC2 Elastic GPUs * in the Amazon EC2 User Guide. *
* * @param elasticGpuSpecification * An elastic GPU to associate with the instance. An Elastic GPU is a GPU resource that you can attach to * your Windows instance to accelerate the graphics performance of your applications. For more information, * see Amazon EC2 * Elastic GPUs in the Amazon EC2 User Guide. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withElasticGpuSpecification(java.util.Collection* An elastic inference accelerator to associate with the instance. Elastic inference accelerators are a resource * you can attach to your Amazon EC2 instances to accelerate your Deep Learning (DL) inference workloads. *
** You cannot specify accelerators from different generations in the same request. *
** Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and * will help current customers migrate their workloads to options that offer better price and performance. After * April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon * SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past * 30-day period are considered current customers and will be able to continue using the service. *
** You cannot specify accelerators from different generations in the same request. *
** Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference * (EI), and will help current customers migrate their workloads to options that offer better price and * performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI * accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI * at least once during the past 30-day period are considered current customers and will be able to continue * using the service. *
*/ public java.util.List* An elastic inference accelerator to associate with the instance. Elastic inference accelerators are a resource * you can attach to your Amazon EC2 instances to accelerate your Deep Learning (DL) inference workloads. *
** You cannot specify accelerators from different generations in the same request. *
** Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and * will help current customers migrate their workloads to options that offer better price and performance. After * April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon * SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past * 30-day period are considered current customers and will be able to continue using the service. *
** You cannot specify accelerators from different generations in the same request. *
** Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference * (EI), and will help current customers migrate their workloads to options that offer better price and * performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI * accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at * least once during the past 30-day period are considered current customers and will be able to continue * using the service. *
*/ public void setElasticInferenceAccelerators(java.util.Collection* An elastic inference accelerator to associate with the instance. Elastic inference accelerators are a resource * you can attach to your Amazon EC2 instances to accelerate your Deep Learning (DL) inference workloads. *
** You cannot specify accelerators from different generations in the same request. *
** Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and * will help current customers migrate their workloads to options that offer better price and performance. After * April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon * SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past * 30-day period are considered current customers and will be able to continue using the service. *
** NOTE: This method appends the values to the existing list (if any). Use * {@link #setElasticInferenceAccelerators(java.util.Collection)} or * {@link #withElasticInferenceAccelerators(java.util.Collection)} if you want to override the existing values. *
* * @param elasticInferenceAccelerators * An elastic inference accelerator to associate with the instance. Elastic inference accelerators are a * resource you can attach to your Amazon EC2 instances to accelerate your Deep Learning (DL) inference * workloads. ** You cannot specify accelerators from different generations in the same request. *
** Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference * (EI), and will help current customers migrate their workloads to options that offer better price and * performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI * accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at * least once during the past 30-day period are considered current customers and will be able to continue * using the service. *
* @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withElasticInferenceAccelerators(ElasticInferenceAccelerator... elasticInferenceAccelerators) { if (this.elasticInferenceAccelerators == null) { setElasticInferenceAccelerators(new com.amazonaws.internal.SdkInternalList* An elastic inference accelerator to associate with the instance. Elastic inference accelerators are a resource * you can attach to your Amazon EC2 instances to accelerate your Deep Learning (DL) inference workloads. *
** You cannot specify accelerators from different generations in the same request. *
** Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and * will help current customers migrate their workloads to options that offer better price and performance. After * April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon * SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past * 30-day period are considered current customers and will be able to continue using the service. *
** You cannot specify accelerators from different generations in the same request. *
** Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference * (EI), and will help current customers migrate their workloads to options that offer better price and * performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI * accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at * least once during the past 30-day period are considered current customers and will be able to continue * using the service. *
* @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withElasticInferenceAccelerators(java.util.Collection* The tags to apply to the resources that are created during instance launch. *
** You can specify tags for the following resources only: *
** Instances *
** Volumes *
** Elastic graphics *
** Spot Instance requests *
** Network interfaces *
** To tag a resource after it has been created, see CreateTags. *
* * @return The tags to apply to the resources that are created during instance launch. ** You can specify tags for the following resources only: *
** Instances *
** Volumes *
** Elastic graphics *
** Spot Instance requests *
** Network interfaces *
*
* To tag a resource after it has been created, see CreateTags.
*/
public java.util.List
* The tags to apply to the resources that are created during instance launch.
*
* You can specify tags for the following resources only:
*
* Instances
*
* Volumes
*
* Elastic graphics
*
* Spot Instance requests
*
* Network interfaces
*
* To tag a resource after it has been created, see CreateTags.
*
*
*
* You can specify tags for the following resources only: *
** Instances *
** Volumes *
** Elastic graphics *
** Spot Instance requests *
** Network interfaces *
*
* To tag a resource after it has been created, see CreateTags.
*/
public void setTagSpecifications(java.util.Collection
* The tags to apply to the resources that are created during instance launch.
*
* You can specify tags for the following resources only:
*
* Instances
*
* Volumes
*
* Elastic graphics
*
* Spot Instance requests
*
* Network interfaces
*
* To tag a resource after it has been created, see CreateTags.
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setTagSpecifications(java.util.Collection)} or {@link #withTagSpecifications(java.util.Collection)} if
* you want to override the existing values.
*
*
*
* You can specify tags for the following resources only: *
** Instances *
** Volumes *
** Elastic graphics *
** Spot Instance requests *
** Network interfaces *
*
* To tag a resource after it has been created, see CreateTags.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withTagSpecifications(TagSpecification... tagSpecifications) {
if (this.tagSpecifications == null) {
setTagSpecifications(new com.amazonaws.internal.SdkInternalList
* The tags to apply to the resources that are created during instance launch.
*
* You can specify tags for the following resources only:
*
* Instances
*
* Volumes
*
* Elastic graphics
*
* Spot Instance requests
*
* Network interfaces
*
* To tag a resource after it has been created, see CreateTags.
*
*
*
* You can specify tags for the following resources only: *
** Instances *
** Volumes *
** Elastic graphics *
** Spot Instance requests *
** Network interfaces *
*
* To tag a resource after it has been created, see CreateTags.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withTagSpecifications(java.util.Collection
* The launch template to use to launch the instances. Any parameters that you specify in RunInstances
* override the same parameters in the launch template. You can specify either the name or ID of a launch template,
* but not both.
*
* The launch template to use to launch the instances. Any parameters that you specify in RunInstances
* override the same parameters in the launch template. You can specify either the name or ID of a launch template,
* but not both.
*
* The launch template to use to launch the instances. Any parameters that you specify in RunInstances
* override the same parameters in the launch template. You can specify either the name or ID of a launch template,
* but not both.
*
* The market (purchasing) option for the instances.
*
* For RunInstances, persistent Spot Instance requests are only supported when
* InstanceInterruptionBehavior is set to either hibernate
or stop
.
*
* For RunInstances, persistent Spot Instance requests are only supported when
* InstanceInterruptionBehavior is set to either hibernate
or stop
.
*/
public void setInstanceMarketOptions(InstanceMarketOptionsRequest instanceMarketOptions) {
this.instanceMarketOptions = instanceMarketOptions;
}
/**
*
* The market (purchasing) option for the instances. *
*
* For RunInstances, persistent Spot Instance requests are only supported when
* InstanceInterruptionBehavior is set to either hibernate
or stop
.
*
* For RunInstances, persistent Spot Instance requests are only supported when
* InstanceInterruptionBehavior is set to either hibernate
or stop
.
*/
public InstanceMarketOptionsRequest getInstanceMarketOptions() {
return this.instanceMarketOptions;
}
/**
*
* The market (purchasing) option for the instances. *
*
* For RunInstances, persistent Spot Instance requests are only supported when
* InstanceInterruptionBehavior is set to either hibernate
or stop
.
*
* For RunInstances, persistent Spot Instance requests are only supported when
* InstanceInterruptionBehavior is set to either hibernate
or stop
.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withInstanceMarketOptions(InstanceMarketOptionsRequest instanceMarketOptions) {
setInstanceMarketOptions(instanceMarketOptions);
return this;
}
/**
*
* The credit option for CPU usage of the burstable performance instance. Valid values are standard
and
* unlimited
. To change this attribute after launch, use
* ModifyInstanceCreditSpecification. For more information, see Burstable
* performance instances in the Amazon EC2 User Guide.
*
* Default: standard
(T2 instances) or unlimited
(T3/T3a/T4g instances)
*
* For T3 instances with host
tenancy, only standard
is supported.
*
standard
and unlimited
. To change this attribute after launch, use
* ModifyInstanceCreditSpecification. For more information, see Burstable
* performance instances in the Amazon EC2 User Guide.
*
* Default: standard
(T2 instances) or unlimited
(T3/T3a/T4g instances)
*
* For T3 instances with host
tenancy, only standard
is supported.
*/
public void setCreditSpecification(CreditSpecificationRequest creditSpecification) {
this.creditSpecification = creditSpecification;
}
/**
*
* The credit option for CPU usage of the burstable performance instance. Valid values are standard
and
* unlimited
. To change this attribute after launch, use
* ModifyInstanceCreditSpecification. For more information, see Burstable
* performance instances in the Amazon EC2 User Guide.
*
* Default: standard
(T2 instances) or unlimited
(T3/T3a/T4g instances)
*
* For T3 instances with host
tenancy, only standard
is supported.
*
standard
and unlimited
. To change this attribute after launch, use
* ModifyInstanceCreditSpecification. For more information, see Burstable
* performance instances in the Amazon EC2 User Guide.
*
* Default: standard
(T2 instances) or unlimited
(T3/T3a/T4g instances)
*
* For T3 instances with host
tenancy, only standard
is supported.
*/
public CreditSpecificationRequest getCreditSpecification() {
return this.creditSpecification;
}
/**
*
* The credit option for CPU usage of the burstable performance instance. Valid values are standard
and
* unlimited
. To change this attribute after launch, use
* ModifyInstanceCreditSpecification. For more information, see Burstable
* performance instances in the Amazon EC2 User Guide.
*
* Default: standard
(T2 instances) or unlimited
(T3/T3a/T4g instances)
*
* For T3 instances with host
tenancy, only standard
is supported.
*
standard
and unlimited
. To change this attribute after launch, use
* ModifyInstanceCreditSpecification. For more information, see Burstable
* performance instances in the Amazon EC2 User Guide.
*
* Default: standard
(T2 instances) or unlimited
(T3/T3a/T4g instances)
*
* For T3 instances with host
tenancy, only standard
is supported.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withCreditSpecification(CreditSpecificationRequest creditSpecification) {
setCreditSpecification(creditSpecification);
return this;
}
/**
*
* The CPU options for the instance. For more information, see Optimize CPU options in * the Amazon EC2 User Guide. *
* * @param cpuOptions * The CPU options for the instance. For more information, see Optimize CPU * options in the Amazon EC2 User Guide. */ public void setCpuOptions(CpuOptionsRequest cpuOptions) { this.cpuOptions = cpuOptions; } /** ** The CPU options for the instance. For more information, see Optimize CPU options in * the Amazon EC2 User Guide. *
* * @return The CPU options for the instance. For more information, see Optimize CPU * options in the Amazon EC2 User Guide. */ public CpuOptionsRequest getCpuOptions() { return this.cpuOptions; } /** ** The CPU options for the instance. For more information, see Optimize CPU options in * the Amazon EC2 User Guide. *
* * @param cpuOptions * The CPU options for the instance. For more information, see Optimize CPU * options in the Amazon EC2 User Guide. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withCpuOptions(CpuOptionsRequest cpuOptions) { setCpuOptions(cpuOptions); return this; } /** *
* Information about the Capacity Reservation targeting option. If you do not specify this parameter, the instance's
* Capacity Reservation preference defaults to open
, which enables it to run in any open Capacity
* Reservation that has matching attributes (instance type, platform, Availability Zone).
*
open
, which enables it to run in any
* open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone).
*/
public void setCapacityReservationSpecification(CapacityReservationSpecification capacityReservationSpecification) {
this.capacityReservationSpecification = capacityReservationSpecification;
}
/**
*
* Information about the Capacity Reservation targeting option. If you do not specify this parameter, the instance's
* Capacity Reservation preference defaults to open
, which enables it to run in any open Capacity
* Reservation that has matching attributes (instance type, platform, Availability Zone).
*
open
, which enables it to run in any
* open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone).
*/
public CapacityReservationSpecification getCapacityReservationSpecification() {
return this.capacityReservationSpecification;
}
/**
*
* Information about the Capacity Reservation targeting option. If you do not specify this parameter, the instance's
* Capacity Reservation preference defaults to open
, which enables it to run in any open Capacity
* Reservation that has matching attributes (instance type, platform, Availability Zone).
*
open
, which enables it to run in any
* open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone).
* @return Returns a reference to this object so that method calls can be chained together.
*/
public RunInstancesRequest withCapacityReservationSpecification(CapacityReservationSpecification capacityReservationSpecification) {
setCapacityReservationSpecification(capacityReservationSpecification);
return this;
}
/**
* * Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance meets the * hibernation * prerequisites. For more information, see Hibernate your instance in the * Amazon EC2 User Guide. *
** You can't enable hibernation and Amazon Web Services Nitro Enclaves on the same instance. *
* * @param hibernationOptions * Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance * meets the hibernation * prerequisites. For more information, see Hibernate your instance in * the Amazon EC2 User Guide. ** You can't enable hibernation and Amazon Web Services Nitro Enclaves on the same instance. */ public void setHibernationOptions(HibernationOptionsRequest hibernationOptions) { this.hibernationOptions = hibernationOptions; } /** *
* Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance meets the * hibernation * prerequisites. For more information, see Hibernate your instance in the * Amazon EC2 User Guide. *
** You can't enable hibernation and Amazon Web Services Nitro Enclaves on the same instance. *
* * @return Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance * meets the hibernation * prerequisites. For more information, see Hibernate your instance in * the Amazon EC2 User Guide. ** You can't enable hibernation and Amazon Web Services Nitro Enclaves on the same instance. */ public HibernationOptionsRequest getHibernationOptions() { return this.hibernationOptions; } /** *
* Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance meets the * hibernation * prerequisites. For more information, see Hibernate your instance in the * Amazon EC2 User Guide. *
** You can't enable hibernation and Amazon Web Services Nitro Enclaves on the same instance. *
* * @param hibernationOptions * Indicates whether an instance is enabled for hibernation. This parameter is valid only if the instance * meets the hibernation * prerequisites. For more information, see Hibernate your instance in * the Amazon EC2 User Guide. ** You can't enable hibernation and Amazon Web Services Nitro Enclaves on the same instance. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withHibernationOptions(HibernationOptionsRequest hibernationOptions) { setHibernationOptions(hibernationOptions); return this; } /** *
* The license configurations. *
* * @return The license configurations. */ public java.util.List* The license configurations. *
* * @param licenseSpecifications * The license configurations. */ public void setLicenseSpecifications(java.util.Collection* The license configurations. *
** NOTE: This method appends the values to the existing list (if any). Use * {@link #setLicenseSpecifications(java.util.Collection)} or * {@link #withLicenseSpecifications(java.util.Collection)} if you want to override the existing values. *
* * @param licenseSpecifications * The license configurations. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withLicenseSpecifications(LicenseConfigurationRequest... licenseSpecifications) { if (this.licenseSpecifications == null) { setLicenseSpecifications(new com.amazonaws.internal.SdkInternalList* The license configurations. *
* * @param licenseSpecifications * The license configurations. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withLicenseSpecifications(java.util.Collection* The metadata options for the instance. For more information, see Instance metadata and user * data. *
* * @param metadataOptions * The metadata options for the instance. For more information, see Instance metadata * and user data. */ public void setMetadataOptions(InstanceMetadataOptionsRequest metadataOptions) { this.metadataOptions = metadataOptions; } /** ** The metadata options for the instance. For more information, see Instance metadata and user * data. *
* * @return The metadata options for the instance. For more information, see Instance metadata * and user data. */ public InstanceMetadataOptionsRequest getMetadataOptions() { return this.metadataOptions; } /** ** The metadata options for the instance. For more information, see Instance metadata and user * data. *
* * @param metadataOptions * The metadata options for the instance. For more information, see Instance metadata * and user data. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withMetadataOptions(InstanceMetadataOptionsRequest metadataOptions) { setMetadataOptions(metadataOptions); return this; } /** ** Indicates whether the instance is enabled for Amazon Web Services Nitro Enclaves. For more information, see What is Amazon Web Services Nitro * Enclaves? in the Amazon Web Services Nitro Enclaves User Guide. *
** You can't enable Amazon Web Services Nitro Enclaves and hibernation on the same instance. *
* * @param enclaveOptions * Indicates whether the instance is enabled for Amazon Web Services Nitro Enclaves. For more information, * see What is Amazon Web * Services Nitro Enclaves? in the Amazon Web Services Nitro Enclaves User Guide. ** You can't enable Amazon Web Services Nitro Enclaves and hibernation on the same instance. */ public void setEnclaveOptions(EnclaveOptionsRequest enclaveOptions) { this.enclaveOptions = enclaveOptions; } /** *
* Indicates whether the instance is enabled for Amazon Web Services Nitro Enclaves. For more information, see What is Amazon Web Services Nitro * Enclaves? in the Amazon Web Services Nitro Enclaves User Guide. *
** You can't enable Amazon Web Services Nitro Enclaves and hibernation on the same instance. *
* * @return Indicates whether the instance is enabled for Amazon Web Services Nitro Enclaves. For more information, * see What is Amazon Web * Services Nitro Enclaves? in the Amazon Web Services Nitro Enclaves User Guide. ** You can't enable Amazon Web Services Nitro Enclaves and hibernation on the same instance. */ public EnclaveOptionsRequest getEnclaveOptions() { return this.enclaveOptions; } /** *
* Indicates whether the instance is enabled for Amazon Web Services Nitro Enclaves. For more information, see What is Amazon Web Services Nitro * Enclaves? in the Amazon Web Services Nitro Enclaves User Guide. *
** You can't enable Amazon Web Services Nitro Enclaves and hibernation on the same instance. *
* * @param enclaveOptions * Indicates whether the instance is enabled for Amazon Web Services Nitro Enclaves. For more information, * see What is Amazon Web * Services Nitro Enclaves? in the Amazon Web Services Nitro Enclaves User Guide. ** You can't enable Amazon Web Services Nitro Enclaves and hibernation on the same instance. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withEnclaveOptions(EnclaveOptionsRequest enclaveOptions) { setEnclaveOptions(enclaveOptions); return this; } /** *
* The options for the instance hostname. The default values are inherited from the subnet. Applies only if creating * a network interface, not attaching an existing one. *
* * @param privateDnsNameOptions * The options for the instance hostname. The default values are inherited from the subnet. Applies only if * creating a network interface, not attaching an existing one. */ public void setPrivateDnsNameOptions(PrivateDnsNameOptionsRequest privateDnsNameOptions) { this.privateDnsNameOptions = privateDnsNameOptions; } /** ** The options for the instance hostname. The default values are inherited from the subnet. Applies only if creating * a network interface, not attaching an existing one. *
* * @return The options for the instance hostname. The default values are inherited from the subnet. Applies only if * creating a network interface, not attaching an existing one. */ public PrivateDnsNameOptionsRequest getPrivateDnsNameOptions() { return this.privateDnsNameOptions; } /** ** The options for the instance hostname. The default values are inherited from the subnet. Applies only if creating * a network interface, not attaching an existing one. *
* * @param privateDnsNameOptions * The options for the instance hostname. The default values are inherited from the subnet. Applies only if * creating a network interface, not attaching an existing one. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withPrivateDnsNameOptions(PrivateDnsNameOptionsRequest privateDnsNameOptions) { setPrivateDnsNameOptions(privateDnsNameOptions); return this; } /** ** The maintenance and recovery options for the instance. *
* * @param maintenanceOptions * The maintenance and recovery options for the instance. */ public void setMaintenanceOptions(InstanceMaintenanceOptionsRequest maintenanceOptions) { this.maintenanceOptions = maintenanceOptions; } /** ** The maintenance and recovery options for the instance. *
* * @return The maintenance and recovery options for the instance. */ public InstanceMaintenanceOptionsRequest getMaintenanceOptions() { return this.maintenanceOptions; } /** ** The maintenance and recovery options for the instance. *
* * @param maintenanceOptions * The maintenance and recovery options for the instance. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withMaintenanceOptions(InstanceMaintenanceOptionsRequest maintenanceOptions) { setMaintenanceOptions(maintenanceOptions); return this; } /** ** Indicates whether an instance is enabled for stop protection. For more information, see Stop * protection. *
* * @param disableApiStop * Indicates whether an instance is enabled for stop protection. For more information, see Stop * protection. */ public void setDisableApiStop(Boolean disableApiStop) { this.disableApiStop = disableApiStop; } /** ** Indicates whether an instance is enabled for stop protection. For more information, see Stop * protection. *
* * @return Indicates whether an instance is enabled for stop protection. For more information, see Stop * protection. */ public Boolean getDisableApiStop() { return this.disableApiStop; } /** ** Indicates whether an instance is enabled for stop protection. For more information, see Stop * protection. *
* * @param disableApiStop * Indicates whether an instance is enabled for stop protection. For more information, see Stop * protection. * @return Returns a reference to this object so that method calls can be chained together. */ public RunInstancesRequest withDisableApiStop(Boolean disableApiStop) { setDisableApiStop(disableApiStop); return this; } /** ** Indicates whether an instance is enabled for stop protection. For more information, see Stop * protection. *
* * @return Indicates whether an instance is enabled for stop protection. For more information, see Stop * protection. */ public Boolean isDisableApiStop() { return this.disableApiStop; } /** * This method is intended for internal use only. Returns the marshaled request configured with additional * parameters to enable operation dry-run. */ @Override public Request