DescribeReservedInstancesOfferings
Description
Describes Reserved Instance offerings that are available for purchase. With Amazon EC2 Reserved Instances, you purchase the right to launch Amazon EC2 instances for a period of time (without getting insufficient capacity errors) and pay a lower usage rate for the actual time used. For more information about Reserved Instances, go to the
Request Parameters
| Name | Description | Required |
|---|---|---|
|
ID of the Reserved Instances to describe. Type: String Default: None |
No |
|
The instance type on which the Reserved Instance can be used. Type: String Default: None |
No |
|
The Availability Zone in which the Reserved Instance can be used. Type: String Default: None |
No |
|
The Reserved Instance description. Type: String Default: None Constraints: 255 characters |
No |
Response Elements
| Name | Description |
|---|---|
|
|
Type: DescribeReservedInstancesOfferingsResponseType Ancestor: None Children: |
|
The ID of the request. Type: xsd:string Ancestor: Children: None |
|
Reserved Instances offerings set. Type: DescribeReservedInstancesOfferingsResponseSetType Ancestor: Children: |
|
Reserved Instance offerings set. Type: DescribeReservedInstancesOfferingsResponseSetItemType Ancestor: Children: |
|
The ID of the Reserved Instance offering. 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 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 Reserved Instance description. Type: xsd:string Ancestor: Children: None |
Examples
Example Request
This example describes available Reserved Instance offerings.
https://ec2.amazonaws.com/?Action=DescribeReservedInstancesOfferings&AuthParams
Example Response
<DescribeReservedInstancesOfferingsResponse xmlns="http://ec2.amazonaws.com/doc/2009-10-31/">
<reservedInstancesOfferingsSet>
<item>
<reservedInstancesOfferingId>4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8</reservedInstancesOfferingId>
<instanceType>m1.small</instanceType>
<availabilityZone>us-east-1a</availabilityZone>
<duration>12</duration>
<fixedPrice>0.00</fixedPrice>
<usagePrice>0.00</usagePrice>
<productDescription>m1.small offering in us-east-1a</productDescription>
</item>
</reservedInstancesOfferingsSet>
</DescribeReservedInstancesOfferingsResponse>