DescribeReservedDBInstancesOfferings - Amazon Relational Database Service

Description

Lists available reserved DB Instance offerings.

Request Parameters

For information about the common parameters that all actions use, see Common Query Parameters.

Name	Description	Required
`DBInstanceClass`	The DB Instance class filter value. Specify this parameter to show only the available offerings matching the specified DB Instance class. Type: String	No
`Duration`	Duration filter value, specified in years or seconds. Specify this parameter to show only reservations for this duration. Valid Values: `1 \| 3 \| 31536000 \| 94608000` Type: String	No
`Marker`	The marker provided in the previous request. If this parameter is specified, the response includes records beyond the marker only, up to `MaxRecords`. Type: String	No
`MaxRecords`	The maximum number of records to include in the response. If more than the `MaxRecords` value is available, a marker is included in the response so that the following results can be retrieved. Default: 100 Constraints: minimum 20, maximum 100 Type: Integer	No
`MultiAZ`	The Multi-AZ filter value. Specify this parameter to show only the available offerings matching the specified Multi-AZ parameter. Type: Boolean	No
`OfferingType`	The offering type filter value. Specify this parameter to show only the available offerings matching the specified offering type. Valid Values: `"Light Utilization" \| "Medium Utilization" \| "Heavy Utilization"` Type: String	No
`ProductDescription`	Product description filter value. Specify this parameter to show only the available offerings matching the specified product description. Type: String	No
`ReservedDBInstancesOfferingId`	The offering identifier filter value. Specify this parameter to show only the available offering that matches the specified reservation identifier. Example: `438012d3-4052-4cc7-b2e3-8d3372e0e706` Type: String	No

Response Elements

The following elements come wrapped in a DescribeReservedDBInstancesOfferingsResult structure.

Name Description

Name	Description
`Marker`	A marker provided for paginated results. Type: String
`ReservedDBInstancesOfferings`	A list of reserved DB Instance offerings. Type: ReservedDBInstancesOffering list

Marker

A marker provided for paginated results.

Type: String

ReservedDBInstancesOfferings

A list of reserved DB Instance offerings.

Type: ReservedDBInstancesOffering list

Errors

For information about the common errors that all actions use, see Common Errors.

Error	Description	HTTP Status Code
`ReservedDBInstancesOfferingNotFound`	Specified offering does not exist.	404

Examples

Sample Request

https://rds.amazonaws.com/
   ?Action=DescribeReservedDBInstancesOfferings
   &ReservedDBInstancesOfferingId=438012d3-4052-4cc7-b2e3-8d3372e0e706
   &SignatureVersion=2
   &SignatureMethod=HmacSHA256
   &Timestamp=2011-12-18T18%3A31%3A36.118Z
   &AWSAccessKeyId=<AWS Access Key ID>
   &Signature=<Signature>

Sample Response

<DescribeReservedDBInstancesOfferingsResponse xmlns="http://rds.amazonaws.com/do
c/2012-04-02/">
  <DescribeReservedDBInstancesOfferingsResult>
    <ReservedDBInstancesOfferings>
      <ReservedDBInstancesOffering>
        <Duration>31536000</Duration>
        <OfferingType>Heavy Utilization</OfferingType>
        <CurrencyCode>USD</CurrencyCode>
        <RecurringCharges>          
          <RecurringCharge>
            <RecurringChargeFrequency>Hourly</RecurringChargeFrequency>
            <RecurringChargeAmount>0.123</RecurringChargeAmount>
          </RecurringCharge>
        </RecurringCharges>
        <FixedPrice>162.0</FixedPrice>
        <ProductDescription>mysql</ProductDescription>
        <UsagePrice>0.0</UsagePrice>
        <MultiAZ>false</MultiAZ>
        <ReservedDBInstancesOfferingId>SampleOfferingId</ReservedDBInstancesOfferingId>
        <DBInstanceClass>db.m1.small</DBInstanceClass>
      </ReservedDBInstancesOffering>
    </ReservedDBInstancesOfferings>
  </DescribeReservedDBInstancesOfferingsResult>
  <ResponseMetadata>
    <RequestId>521b420a-2961-11e1-bd06-6fe008f046c3</RequestId>
  </ResponseMetadata>
</DescribeReservedDBInstancesOfferingsResponse>