Sample Response
<DescribeKeyPairsResponse xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<keySet>
<item>
<keyName>example-key-name</keyName>
<keyFingerprint>1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f</
keyFingerprint>
</item>
</keySet>
</DescribeKeyPairsResponse>
Related Operations
CreateKeypair
DeleteKeypair
RunInstances
DeleteKeyPair
The DeleteKeyPair operation deletes a keypair.
Request Parameters
The following table describes the request parameters for DeleteKeyPair. Parameter names are case
sensitive.
Element Name Definition Re-
quired?
Type
keyName Name of the keypair to delete. Yes xsd:string
Response Tags
The following table describes the default response tags included in DeleteKeyPair responses.
Element Name Definition
return true if the key was successfully deleted.
Sample Request
<DeleteKeyPair xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<keyName>example-key-name</keyName>
</DeleteKeyPair>
Sample Response
<DescribeKeyPairs xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
Amazon EC2
Developer Guide
61
<return>true</return>
</DescribeKeyPairs></SOAP-ENV:Body></SOAP-ENV:Envelope>
Related Operations
CreateKeyPair
DescribeKeyPairs
RunInstances
The RunInstances operation launches a specified number of instances.
A call to RunInstances is guaranteed to start no fewer than the requested minimum for each AMI
specified. If you have insufficient credit, or if there is insufficient capacity available then no instances
will be started. Amazon EC2 will make a best effort attempt to satisfy the requested maximum values. If
you have sufficient credit to cover the specified minimum values but not the maximum values then
credit available beyond that required to cover the specified minimums will be allocated to each image
specified in a round robin fashion.
As an example, consider a request to launch two images (A and B), with minimum and maximum values
of (5,10) and (20, 40) respectively.
If you have credit available for less than 25 instances then no instances will be launched (since the
minimums of 5 and 20 cannot both be satisfied). Similarly, if there is insufficient capacity for 25
instances then no instances will be launched.
If you have credit available (or if there is capacity available) for only 30 instances then 5 instances of A
and 20 instances of B will be launched. The remaining 5 instances worth of credit (or capacity) will be
allocated in round robin fashion.
Every instance is launched in a security group. This may be specified as part of the launch request. If a
security group is not indicated then instances are started in a the default security group.
An optional keypair ID may be provided for each image in the launch request. All instances that are
created from images for which this is provided will have access to the associated public key at boot time
(detailed below). This key may be used to provide secure access to an instance of an image on a
per-instance basis. Amazon EC2 public images make use of this functionality to provide secure
passwordless access to instances (and launching those images without a keypair ID will leave them
inaccessible).
The public key material is made available to the instance at boot time by placing it in a file named
openssh_id.pub 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 time (as part of rclocal, for example) allowing for secure
password-less access. As the need arises, other formats will also be considered.
Request Parameters
The following table describes the request parameters for RunInstances. Parameter names are case
sensitive.
Element Name Definition Re-
quired?
Type
instancesSet Description of the instances to launch. Yes ec2:RunInstanceItem
Amazon EC2
Developer Guide
62
Previous Page Next Page