DescribeReservedInstances
Description
Describes Reserved Instances that you purchased. For more information about Reserved Instances, go to the
Request Parameters
| Name | Description | Required |
|---|---|---|
|
IDs of the Reserved Instance to describe. Type: String Default: None |
No |
Response Elements
| Name | Description |
|---|---|
|
|
Type: DescribeReservedInstancesResponseType Ancestor: None Children: |
|
The ID of the request. Type: xsd:string Ancestor: Children: None |
|
Reserved Instances set. Type: DescribeReservedInstancesResponseSetType Ancestor: Children: |
|
Reserved Instance set. Type: DescribeReservedInstancesResponseSetItemType Ancestor: Children: |
|
The ID of the Reserved Instance. Type: xsd:string Ancestor: Children: None |
|
The instance type on which the Reserved Instance can be used. Type: xsd:string Ancestor: Children: None |
|
The Availability Zone in which the Reserved Instance can be used. Type: xsd:string Ancestor: Children: None |
|
The date and time the Reserved Instance started. Type: xsd:dateTime Ancestor: Children: None |
|
The duration of the Reserved Instance, in seconds. Type: xs:long Ancestor: Children: None |
|
The purchase price of the Reserved Instance. Type: xs:double Ancestor: Children: None |
|
The usage price of the Reserved Instance, per hour. Type: xs:double Ancestor: Children: None |
|
The number of Reserved Instances purchased. Type: xs:integer Ancestor: Children: None |
|
The Reserved Instance description. Type: xsd:string Ancestor: Children: None |
|
The state of the Reserved Instance purchase. Type: xsd:string Valid Values: Ancestor: Children: None |
Examples
Example Request
This example describes Reserved Instances owned by the account.
https://ec2.amazonaws.com/?Action=DescribeReservedInstances&AuthParams
Example Response
<DescribeReservedInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2009-10-31/">
<reservedInstancesSet>
<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>
</reservedInstancesSet>
</DescribeReservedInstancesResponse>