DescribeReservedInstances
The DescribeReservedInstances operation describes Reserved Instances that were purchased for use with your account. For more
information about Reserved Instances, see Reserving Amazon EC2 Instances for Long-Term Use.
Request Parameters
The following table describes the request parameters for
DescribeReservedInstances. Parameter names are
case sensitive.
| Name | Description | Required |
|---|---|---|
|
|
Displays Reserved Instances with the specified Reserved Instance IDs. Type: String Default: none Valid Values: Valid Reserved Instance IDs associated with the account. Constraints: none |
No |
Response Elements
The following table describes the default response tags included
in DescribeReservedInstances responses.
| Name | Description |
|---|---|
|
|
The ID of the Reserved Instance. Type: xsd:string |
|
|
The instance type in which the Reserved Instance can be used. For more information on instance types, see Instance Types. Type: xsd:string |
|
|
The Availability Zone in which the Reserved Instance can be used. Type: xsd:string |
|
|
The duration of the Reserved Instance, in seconds. Type: xsd:string |
|
|
The usage price of the Reserved Instance, per hour. Type: xsd:string |
|
|
The purchase price of the Reserved Instance. Type: xsd:string |
|
|
The number of Reserved Instances purchased. Type: xsd:string |
|
|
The Reserved Instance description. Type: xsd:string |
|
|
The state of the Reserved Instance purchase (pending-payment, active, payment-failed). Type: xsd:string |
Sample Request
https://ec2.amazonaws.com/ ?Action=DescribeReservedInstances &...auth parameters...
Sample Response
<DescribeReservedInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-03-01/">
<DescribeReservedInstancesResponseSetItemType>
<item>
<reservedInstancesId>4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8</reservedInstancesId>
<instanceType>m1.small</instanceType>
<availabilityZone>us-east-1a</availabilityZone>
<duration>12</duration>
<usagePrice>0.00</usagePrice>
<fixedPrice>0.00</fixedPrice>
<instanceCount>19</instanceCount>
<productDescription>m1.small offering in us-east-1a</productDescription>
<state>Active</state>
</item>
</DescribeReservedInstancesResponseSetItemType>
</DescribeReservedInstancesResponse>