Launches a specified number of instances of an
AMI for which you have
permissions.
If Amazon EC2 cannot launch the
minimum number AMIs you request, no
instances will be launched. If
there is insufficient capacity to
launch the
maximum number of AMIs
you request, Amazon EC2 launches the minimum
number specified for
each AMI and allocate the remaining available
instances using round robin.
In the following example, Libby generates a request to
launch two images (database and web_server):
Libby runs the RunInstances operation to launch database instances
(min. 10, max. 15) and web_server instances (min. 30, max. 40).
Because there are currently 30 instances available and Libby needs a
minimum of 40, no instances are launched.
Libby adjusts the number of instances she needs and runs the
RunInstances operation to launch database
instances (min. 5, max. 10) and web_server
instances (min. 20, max. 40).
Amazon EC2 launches the minimum number of instances for each
AMI (5 database, 20 web_server).
The remaining 5 instances are
allocated using round robin.
Libby adjusts the number of instances
she needs and runs the RunInstances
operation again to launch
database instances (min. 5, max. 10) and
web_server instances (min.
20, max. 40).
Note - every instance is launched in a security group
(created using the CreateSecurityGroup operation.)
You can provide
an optional key pair ID for each image in the launch request
(created using the CreateKeyPair operation). 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 instance 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, go the Amazon Elastic Compute Cloud Developer
Guide.
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 High-CPU and High-Memory 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, go the Amazon
Elastic Compute Cloud
Developer Guide
Namespace: Amazon.EC2.ModelAssembly: AWSSDK (in AWSSDK.dll) Version: 1.4.10.0 (1.4.10.0)
Syntax
| C# | Visual Basic | Visual C++ |
public class RunInstancesRequest
Public Class RunInstancesRequest
public ref class RunInstancesRequest
Members
| All Members | Constructors  | Properties  | Methods |
 Public Protected | Instance Static  | Declared Inherited | XNA Framework Only  .NET Compact Framework Only  |
| Member | Description | |
|---|---|---|
| RunInstancesRequest()()()() | Initializes a new instance of the RunInstancesRequest class |
| AdditionalInfo |
Gets and sets the AdditionalInfo property.
Specifies additional information to make
available to the instance(s)
|
| BlockDeviceMapping |
Gets and sets the BlockDeviceMapping property.
Block device mapping.
|
| ClientToken |
Gets and sets the ClientToken property.
|
| DisableApiTermination |
Gets and sets the DisableApiTermination property.
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.
|
| Equals(Object) | (Inherited from Object.) |
| GetHashCode()()()() |
Serves as a hash function for a particular type.
(Inherited from Object.) |
| GetType()()()() |
Gets the Type of the current instance.
(Inherited from Object.) |
| ImageId |
Gets and sets the ImageId property.
Unique ID of a machine image,
|
| InstanceInitiatedShutdownBehavior |
Gets and sets the InstanceInitiatedShutdownBehavior property.
Specifies whether the instance's Amazon EBS
volumes are stopped or terminated when the instance is shut
down.
|
| InstanceType |
Gets and sets the InstanceType property.
Specifies the instance type.
Valid Values:
m1.small | m1.medium | m1.large | m1.xlarge | c1.medium |
c1.xlarge |
m2.2xlarge | m2.4xlarge
Default: m1.small
|
| IsSetAdditionalInfo()()()() |
Checks if AdditionalInfo property is set
|
| IsSetBlockDeviceMapping()()()() |
Checks if BlockDeviceMapping property is set
|
| IsSetClientToken()()()() |
Checks if ClientToken property is set
|
| IsSetDisableApiTermination()()()() |
Checks if DisableApiTermination property is set
|
| IsSetImageId()()()() |
Checks if ImageId property is set
|
| IsSetInstanceInitiatedShutdownBehavior()()()() |
Checks if InstanceInitiatedShutdownBehavior property is set
|
| IsSetInstanceType()()()() |
Checks if InstanceType property is set
|
| IsSetKernelId()()()() |
Checks if KernelId property is set
|
| IsSetKeyName()()()() |
Checks if KeyName property is set
|
| IsSetLicense()()()() |
Checks if License property is set
|
| IsSetMaxCount()()()() |
Checks if MaxCount property is set
|
| IsSetMinCount()()()() |
Checks if MinCount property is set
|
| IsSetMonitoring()()()() |
Checks if Monitoring property is set
|
| IsSetNetworkInterfaceSet()()()() |
Checks if the NetworkInterfaceSet property is set
|
| IsSetPlacement()()()() |
Checks if Placement property is set
|
| IsSetPrivateIpAddress()()()() |
Checks if PrivateIpAddress property is set
|
| IsSetRamdiskId()()()() |
Checks if RamdiskId property is set
|
| IsSetSecurityGroup()()()() |
Checks if SecurityGroup property is set
|
| IsSetSecurityGroupId()()()() |
Checks if SecurityGroupId property is set
|
| IsSetSubnetId()()()() |
Checks if SubnetId property is set
|
| IsSetUserData()()()() |
Checks if UserData property is set
|
| KernelId |
Gets and sets the KernelId property.
The ID of the kernel with which to launch the
instance.
|
| KeyName |
Gets and sets the KeyName property.
The name of the key pair.
|
| License |
Gets and sets the License property.
Specifies active licenses in use and attached
to an Amazon EC2 instance.
|
| MaxCount |
Gets and sets the MaxCount property.
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.
Constraints:
Between 1 and the maximum number allowed for your account
(default: 20).
|
| MinCount |
Gets and sets the MinCount property.
Minimum number of instances to launch. If the
value is more than Amazon
EC2 can launch, no instances are launched at all.
Constraints: Between 1 and the maximum number
allowed for your account (default: 20).
|
| Monitoring |
Gets and sets the Monitoring property.
Enables monitoring for the instance.
|
| NetworkInterfaceSet |
Gets and sets the NetworkInterfaceSet property.
A set of one or more existing network interfaces to attach to the instance.
|
| Placement |
Gets and sets the Placement property.
Specifies the placement constraints.
|
| PrivateIpAddress |
Gets and sets the PrivateIpAddress property.
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 |
Gets and sets the RamdiskId property.
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.
|
| SecurityGroup |
Gets and sets the SecurityGroup property.
Names of the security group.
|
| SecurityGroupId |
Gets and sets the SecurityGroupId property.
IDs of the security group.
|
| SubnetId |
Gets and sets the SubnetId property.
Specifies the subnet ID within which to launch
the instance(s) for
Amazon Virtual Private Cloud.
|
| ToString()()()() | (Inherited from Object.) |
| UserData |
Gets and sets the UserData property.
MIME, Base64-encoded user data.
|
| WithAdditionalInfo(String) |
Sets the AdditionalInfo property
|
| WithBlockDeviceMapping(array<BlockDeviceMapping>[]()[][]) |
Sets the BlockDeviceMapping property
|
| WithClientToken(String) |
Sets the ClientToken property
|
| WithDisableApiTermination(Boolean) |
Sets the DisableApiTermination property
|
| WithImageId(String) |
Sets the ImageId property
|
| WithInstanceInitiatedShutdownBehavior(String) |
Sets the InstanceInitiatedShutdownBehavior property
|
| WithInstanceType(String) |
Sets the InstanceType property
|
| WithKernelId(String) |
Sets the KernelId property
|
| WithKeyName(String) |
Sets the KeyName property
|
| WithLicense(InstanceLicenseSpecification) |
Sets the License property
|
| WithMaxCount(Decimal) |
Sets the MaxCount property
|
| WithMinCount(Decimal) |
Sets the MinCount property
|
| WithMonitoring(MonitoringSpecification) |
Sets the Monitoring property
|
| WithNetworkInterfaceSet(array<InstanceNetworkInterfaceSpecification>[]()[][]) |
Sets the NetworkInterfaceSet property.
|
| WithPlacement(Placement) |
Sets the Placement property
|
| WithPrivateIpAddress(String) |
Sets the PrivateIpAddress property
|
| WithRamdiskId(String) |
Sets the RamdiskId property
|
| WithSecurityGroup(array<String>[]()[][]) |
Sets the SecurityGroup property
|
| WithSecurityGroupId(array<String>[]()[][]) |
Sets the SecurityGroupId property
|
| WithSubnetId(String) |
Sets the SubnetId property
|
| WithUserData(String) |
Sets the UserData property
|
Inheritance Hierarchy
See Also
