Menu
Amazon Elastic Compute Cloud
API Reference (API Version 2016-11-15)

LaunchSpecification

Describes the launch specification for an instance.

Contents

addressingType

Deprecated.

Type: String

Required: No

blockDeviceMapping

One or more block device mapping entries.

Although you can specify encrypted EBS volumes in this block device mapping for your Spot Instances, these volumes are not encrypted.

Type: Array of BlockDeviceMapping objects

Required: No

ebsOptimized

Indicates whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal 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

Type: Boolean

Required: No

groupSet

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

Type: Array of GroupIdentifier objects

Required: No

iamInstanceProfile

The IAM instance profile.

Type: IamInstanceProfileSpecification object

Required: No

imageId

The ID of the AMI.

Type: String

Required: No

instanceType

The instance type.

Type: String

Valid Values: t1.micro | t2.nano | t2.micro | t2.small | t2.medium | t2.large | t2.xlarge | t2.2xlarge | m1.small | m1.medium | m1.large | m1.xlarge | m3.medium | m3.large | m3.xlarge | m3.2xlarge | m4.large | m4.xlarge | m4.2xlarge | m4.4xlarge | m4.10xlarge | m4.16xlarge | m2.xlarge | m2.2xlarge | m2.4xlarge | cr1.8xlarge | r3.large | r3.xlarge | r3.2xlarge | r3.4xlarge | r3.8xlarge | r4.large | r4.xlarge | r4.2xlarge | r4.4xlarge | r4.8xlarge | r4.16xlarge | x1.16xlarge | x1.32xlarge | i2.xlarge | i2.2xlarge | i2.4xlarge | i2.8xlarge | i3.large | i3.xlarge | i3.2xlarge | i3.4xlarge | i3.8xlarge | i3.16xlarge | hi1.4xlarge | hs1.8xlarge | c1.medium | c1.xlarge | c3.large | c3.xlarge | c3.2xlarge | c3.4xlarge | c3.8xlarge | c4.large | c4.xlarge | c4.2xlarge | c4.4xlarge | c4.8xlarge | cc1.4xlarge | cc2.8xlarge | g2.2xlarge | g2.8xlarge | cg1.4xlarge | p2.xlarge | p2.8xlarge | p2.16xlarge | d2.xlarge | d2.2xlarge | d2.4xlarge | d2.8xlarge | f1.2xlarge | f1.16xlarge

Required: No

kernelId

The ID of the kernel.

Type: String

Required: No

keyName

The name of the key pair.

Type: String

Required: No

monitoring

Describes the monitoring of an instance.

Type: RunInstancesMonitoringEnabled object

Required: No

networkInterfaceSet

One or more network interfaces. If you specify a network interface, you must specify subnet IDs and security group IDs using the network interface.

Type: Array of InstanceNetworkInterfaceSpecification objects

Required: No

placement

The placement information for the instance.

Type: SpotPlacement object

Required: No

ramdiskId

The ID of the RAM disk.

Type: String

Required: No

subnetId

The ID of the subnet in which to launch the instance.

Type: String

Required: No

userData

The user data to make available to the instances. If you are using an AWS SDK or 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.

Type: String

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: