Element Name Definition Re-
quired?
Type
Type[]
groupSet Description of the security groups to as-
sociate the instances with.
Yes ec2:GroupSetType[]
Response Tags
The following table describes the default response tags included in RunInstances responses.
Element Name Definition
RunInstancesResponse Status information about the instances started.
Sample Request
<RunInstances xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<instancesSet>
<item>
<imageId>ami-60a54009</imageId>
<minCount>1</minCount>
<maxCount>3</maxCount>
<keyName>example-key-name</keyName>
</item>
</instancesSet>
<groupSet/>
</RunInstances>
Sample Response
<RunInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2006-06-26">
<reservationId>r-47a5402e</reservationId>
<ownerId>UYY3TLBUXIEON5NQVUUX6OMPWBZIQNFM</ownerId>
<groupSet>
<item>
<groupId>default</groupId>
</item>
</groupSet>
<instancesSet>
<item>
<instanceId>i-2ba64342</instanceId>
<imageId>ami-60a54009</imageId>
<instanceState>
<code>0</code>
<name>pending</name>
</instanceState>
<dnsName></dnsName>
<keyName>example-key-name</keyName>
</item>
<item>
<instanceId>i-2bc64242</instanceId>
<imageId>ami-60a54009</imageId>
<instanceState>
<code>0</code>
<name>pending</name>
</instanceState>
<dnsName></dnsName>
Amazon EC2
Developer Guide
63
<keyName>example-key-name</keyName>
</item>
<item>
<instanceId>i-2be64332</instanceId>
<imageId>ami-60a54009</imageId>
<instanceState>
<code>0</code>
<name>pending</name>
</instanceState>
<dnsName></dnsName>
<keyName>example-key-name</keyName>
</item>
</instancesSet>
</RunInstancesResponse>
Related Operations
DescribeInstances
TerminateInstances
AuthorizeSecurityGroupIngress
RevokeSecurityGroupIngress
DescribeSecurityGroups
DescribeInstances
The DescribeInstances operation returns information about instances owned by the user making the
request.
An optional list of instance IDs may be provided to request information for those instances only. If no
instance IDs are provided, information of all relevant instances information will be returned. If an
instance is specified that does not exist a fault is returned. If an instance is specified that exists but is not
owned by the user making the request, then that instance will not be included in the returned results.
Recently terminated instances will be included in the returned results for a small interval subsequent to
their termination. This interval is typically of the order of one hour.
Request Parameters
The following table describes the request parameters for DescribeInstances. Parameter names are
case sensitive.
Element Name Definition Re-
quired?
Type
instancesSet Set of instances IDs to get the status of. Yes (but
may be
empty)
xsd:string[]
Response Tags
The following table describes the default response tags included in DescribeInstances responses.
Element Name Definition
reservationSet A list of structures describing the status of all requested instances.
Amazon EC2
Developer Guide
64
Previous Page Next Page