The RunInstances operation launches a specified number of instances.
If Amazon EC2 cannot launch the minimum number AMIs you request, no instances launch. If there is insufficient capacity to launch the maximum number of AMIs you request, Amazon EC2 launches as many as possible to satisfy the requested maximum values.
Every instance is launched in a security group. If you do not specify a security group at launch, the instances start in your default security group. For more information on creating security groups, see CreateSecurityGroup.
An optional instance type can be specified. For information about instance types, see Instance Types.
You can provide an optional key pair ID for each image in the launch request (for more information, see CreateKeyPair). All instances that are created from images that use this key pair will have access to the associated public key at boot. You can use this key to provide secure access to an instance of an image on a per-instance basis. Amazon EC2 public images use this feature to provide secure access without passwords.
IMPORTANT: Launching public images without a key pair ID will leave them inaccessible. The public key material is made available to the instance at boot time by placing it in the openssh_id.pub file on a logical device that is exposed to the instance as /dev/sda2 (the ephemeral store). The format of this file is suitable for use as an entry within ~/.ssh/authorized_keys (the OpenSSH format). This can be done at boot (e.g., as part of rc.local) allowing for secure access without passwords. Optional user data can be provided in the launch request. All instances that collectively comprise the launch request have access to this data For more information, see Instance Metadata.
NOTE: If any of the AMIs have a product code attached for which the user has not subscribed, the RunInstances call will fail.
IMPORTANT: We strongly recommend using the 2.6.18 Xen stock kernel with the c1.medium and c1.xlarge instances. Although the default Amazon EC2 kernels will work, the new kernels provide greater stability and performance for these instance types. For more information about kernels, see Kernels, RAM Disks, and Block Device Mappings.
Inheritance Hierarchy
Namespace: Amazon.EC2.Model
Assembly: AWSSDK.dll
Version: 2.0.0.3
Syntax
public class RunInstancesRequest : AmazonWebServiceRequest IRequestEvents
The RunInstancesRequest type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
RunInstancesRequest() |
Properties
| Name | Description | |
|---|---|---|
|
|
AdditionalInfo | Do not use. Reserved for internal use. |
|
|
BlockDeviceMappings | Specifies how block devices are exposed to the instance. Each mapping is made up of a virtualName and a deviceName. |
|
|
ClientToken | Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, go to How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide. |
|
|
DisableApiTermination | Specifies whether the instance can be terminated using the APIs. You must modify this attribute before you can terminate any "locked" instances from the APIs. |
|
|
EbsOptimized | |
|
|
IamInstanceProfile | |
|
|
ImageId | Unique ID of a machine image, returned by a call to DescribeImages. |
|
|
InstanceInitiatedShutdownBehavior | Specifies whether the instance's Amazon EBS volumes are stopped or terminated when the instance is shut down. |
|
|
InstanceType |
Specifies the instance type for the launched instances.
Constraints: |
|
|
KernelId | The ID of the kernel with which to launch the instance. |
|
|
KeyName | The name of the key pair. |
|
|
License | Specifies active licenses in use and attached to an Amazon EC2 instance. |
|
|
MaxCount | Maximum number of instances to launch. If the value is more than Amazon EC2 can launch, the largest possible number above minCount will be launched instead. Between 1 and the maximum number allowed for your account (default: 20). |
|
|
MinCount | Minimum number of instances to launch. If the value is more than Amazon EC2 can launch, no instances are launched at all. |
|
|
Monitoring | Enables monitoring for the instance. |
|
|
NetworkInterfaces | |
|
|
Placement | Specifies the placement constraints (Availability Zones) for launching the instances. |
|
|
PrivateIpAddress | If you're using Amazon Virtual Private Cloud, you can optionally use this parameter to assign the instance a specific available IP address from the subnet. |
|
|
RamdiskId | The ID of the RAM disk with which to launch the instance. Some kernels require additional drivers at launch. Check the kernel requirements for information on whether you need to specify a RAM disk. To find kernel requirements, go to the Resource Center and search for the kernel ID. |
|
|
SecurityGroupIds | |
|
|
SecurityGroups | The names of the security groups into which the instances will be launched. |
|
|
SubnetId | Specifies the subnet ID within which to launch the instance(s) for Amazon Virtual Private Cloud. |
|
|
UserData | Specifies additional information to make available to the instance(s). |
Version Information
.NET Framework:
Supported in: 4.5, 4.0, 3.5
.NET for Windows Store apps:
Supported in: Windows 8
.NET for Windows Phone:
Supported in: Window Phone 8
