@Generated(value="software.amazon.awssdk:codegen") public final class CreateLaunchConfigurationRequest extends AutoScalingRequest implements ToCopyableBuilder<CreateLaunchConfigurationRequest.Builder,CreateLaunchConfigurationRequest>
Modifier and Type | Class and Description |
---|---|
static interface |
CreateLaunchConfigurationRequest.Builder |
Modifier and Type | Method and Description |
---|---|
Boolean |
associatePublicIpAddress()
Used for groups that launch instances into a virtual private cloud (VPC).
|
List<BlockDeviceMapping> |
blockDeviceMappings()
One or more mappings that specify how block devices are exposed to the instance.
|
static CreateLaunchConfigurationRequest.Builder |
builder() |
String |
classicLinkVPCId()
The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to.
|
List<String> |
classicLinkVPCSecurityGroups()
The IDs of one or more security groups for the specified ClassicLink-enabled VPC.
|
Boolean |
ebsOptimized()
Indicates whether the instance is optimized for Amazon EBS I/O.
|
boolean |
equals(Object obj) |
<T> Optional<T> |
getValueForField(String fieldName,
Class<T> clazz)
Used to retrieve the value of a field from any class that extends
SdkRequest . |
int |
hashCode() |
String |
iamInstanceProfile()
The name or the Amazon Resource Name (ARN) of the instance profile associated with the IAM role for the instance.
|
String |
imageId()
The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances.
|
String |
instanceId()
The ID of the instance to use to create the launch configuration.
|
InstanceMonitoring |
instanceMonitoring()
Enables detailed monitoring (
true ) or basic monitoring (false ) for the Auto Scaling
instances. |
String |
instanceType()
The instance type of the EC2 instance.
|
String |
kernelId()
The ID of the kernel associated with the AMI.
|
String |
keyName()
The name of the key pair.
|
String |
launchConfigurationName()
The name of the launch configuration.
|
String |
placementTenancy()
The tenancy of the instance.
|
String |
ramdiskId()
The ID of the RAM disk associated with the AMI.
|
List<String> |
securityGroups()
One or more security groups with which to associate the instances.
|
static Class<? extends CreateLaunchConfigurationRequest.Builder> |
serializableBuilderClass() |
String |
spotPrice()
The maximum hourly price to be paid for any Spot Instance launched to fulfill the request.
|
CreateLaunchConfigurationRequest.Builder |
toBuilder()
Take this object and create a builder that contains all of the current property values of this object.
|
String |
toString() |
String |
userData()
The user data to make available to the launched EC2 instances.
|
overrideConfiguration
copy
public String launchConfigurationName()
The name of the launch configuration. This name must be unique within the scope of your AWS account.
public String imageId()
The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances.
If you do not specify InstanceId
, you must specify ImageId
.
For more information, see Finding an AMI in the Amazon Elastic Compute Cloud User Guide.
If you do not specify InstanceId
, you must specify ImageId
.
For more information, see Finding an AMI in the Amazon Elastic Compute Cloud User Guide.
public String keyName()
The name of the key pair. For more information, see Amazon EC2 Key Pairs in the Amazon Elastic Compute Cloud User Guide.
public List<String> securityGroups()
One or more security groups with which to associate the instances.
If your instances are launched in EC2-Classic, you can either specify security group names or the security group IDs. For more information about security groups for EC2-Classic, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide.
If your instances are launched into a VPC, specify security group IDs. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
If your instances are launched in EC2-Classic, you can either specify security group names or the security group IDs. For more information about security groups for EC2-Classic, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide.
If your instances are launched into a VPC, specify security group IDs. For more information, see Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.
public String classicLinkVPCId()
The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. This parameter is supported only if you are launching EC2-Classic instances. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.
public List<String> classicLinkVPCSecurityGroups()
The IDs of one or more security groups for the specified ClassicLink-enabled VPC. This parameter is required if you specify a ClassicLink-enabled VPC, and is not supported otherwise. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
public String userData()
The user data to make available to the launched EC2 instances. For more information, see Instance Metadata and User Data in the Amazon Elastic Compute Cloud User Guide.
public String instanceId()
The ID of the instance to use to create the launch configuration. The new launch configuration derives attributes from the instance, with the exception of the block device mapping.
If you do not specify InstanceId
, you must specify both ImageId
and
InstanceType
.
To create a launch configuration with a block device mapping or override any other instance attributes, specify them as part of the same request.
For more information, see Create a Launch Configuration Using an EC2 Instance in the Auto Scaling User Guide.
If you do not specify InstanceId
, you must specify both ImageId
and
InstanceType
.
To create a launch configuration with a block device mapping or override any other instance attributes, specify them as part of the same request.
For more information, see Create a Launch Configuration Using an EC2 Instance in the Auto Scaling User Guide.
public String instanceType()
The instance type of the EC2 instance.
If you do not specify InstanceId
, you must specify InstanceType
.
For information about available instance types, see Available Instance Types in the Amazon Elastic Compute Cloud User Guide.
If you do not specify InstanceId
, you must specify InstanceType
.
For information about available instance types, see Available Instance Types in the Amazon Elastic Compute Cloud User Guide.
public String kernelId()
The ID of the kernel associated with the AMI.
public String ramdiskId()
The ID of the RAM disk associated with the AMI.
public List<BlockDeviceMapping> blockDeviceMappings()
One or more mappings that specify how block devices are exposed to the instance. For more information, see Block Device Mapping in the Amazon Elastic Compute Cloud User Guide.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
public InstanceMonitoring instanceMonitoring()
Enables detailed monitoring (true
) or basic monitoring (false
) for the Auto Scaling
instances. The default is true
.
true
) or basic monitoring (false
) for the Auto
Scaling instances. The default is true
.public String spotPrice()
The maximum hourly price to be paid for any Spot Instance launched to fulfill the request. Spot Instances are launched when the price you specify exceeds the current Spot market price. For more information, see Launching Spot Instances in Your Auto Scaling Group in the Auto Scaling User Guide.
public String iamInstanceProfile()
The name or the Amazon Resource Name (ARN) of the instance profile associated with the IAM role for the instance.
EC2 instances launched with an IAM role will automatically have AWS security credentials available. You can use IAM roles with Auto Scaling to automatically enable applications running on your EC2 instances to securely access other AWS resources. For more information, see Launch Auto Scaling Instances with an IAM Role in the Auto Scaling User Guide.
EC2 instances launched with an IAM role will automatically have AWS security credentials available. You can use IAM roles with Auto Scaling to automatically enable applications running on your EC2 instances to securely access other AWS resources. For more information, see Launch Auto Scaling Instances with an IAM Role in the Auto Scaling User Guide.
public Boolean ebsOptimized()
Indicates whether the instance is optimized for Amazon EBS I/O. By default, the instance is not optimized for EBS I/O. The optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization is not available with all instance types. Additional usage charges apply. For more information, see Amazon EBS-Optimized Instances in the Amazon Elastic Compute Cloud User Guide.
public Boolean associatePublicIpAddress()
Used for groups that launch instances into a virtual private cloud (VPC). Specifies whether to assign a public IP address to each instance. For more information, see Launching Auto Scaling Instances in a VPC in the Auto Scaling User Guide.
If you specify this parameter, be sure to specify at least one subnet when you create your group.
Default: If the instance is launched into a default subnet, the default is true
. If the instance is
launched into a nondefault subnet, the default is false
. For more information, see Supported Platforms in
the Amazon Elastic Compute Cloud User Guide.
If you specify this parameter, be sure to specify at least one subnet when you create your group.
Default: If the instance is launched into a default subnet, the default is true
. If the
instance is launched into a nondefault subnet, the default is false
. For more information,
see Supported
Platforms in the Amazon Elastic Compute Cloud User Guide.
public String placementTenancy()
The tenancy of the instance. An instance with a tenancy of dedicated
runs on single-tenant hardware
and can only be launched into a VPC.
You must set the value of this parameter to dedicated
if want to launch Dedicated Instances into a
shared tenancy VPC (VPC with instance placement tenancy attribute set to default
).
If you specify this parameter, be sure to specify at least one subnet when you create your group.
For more information, see Launching Auto Scaling Instances in a VPC in the Auto Scaling User Guide.
Valid values: default
| dedicated
dedicated
runs on single-tenant
hardware and can only be launched into a VPC.
You must set the value of this parameter to dedicated
if want to launch Dedicated Instances
into a shared tenancy VPC (VPC with instance placement tenancy attribute set to default
).
If you specify this parameter, be sure to specify at least one subnet when you create your group.
For more information, see Launching Auto Scaling Instances in a VPC in the Auto Scaling User Guide.
Valid values: default
| dedicated
public CreateLaunchConfigurationRequest.Builder toBuilder()
ToCopyableBuilder
toBuilder
in interface ToCopyableBuilder<CreateLaunchConfigurationRequest.Builder,CreateLaunchConfigurationRequest>
toBuilder
in class AutoScalingRequest
public static CreateLaunchConfigurationRequest.Builder builder()
public static Class<? extends CreateLaunchConfigurationRequest.Builder> serializableBuilderClass()
public <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
SdkRequest
SdkRequest
. The field name
specified should match the member name from the corresponding service-2.json model specified in the
codegen-resources folder for a given service. The class specifies what class to cast the returned value to.
If the returned value is also a modeled class, the SdkRequest.getValueForField(String, Class)
method will
again be available.getValueForField
in class SdkRequest
fieldName
- The name of the member to be retrieved.clazz
- The class to cast the returned object to.Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.