Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142826341.7 MB

Returns information about reserved DB instances for this account, or about a specified reserved DB instance.

get/#Action=DescribeReservedDBInstances

Query parameters

ReservedDBInstanceIdstring

The reserved DB instance identifier filter value. Specify this parameter to show only the reservation that matches the specified reservation ID.

ReservedDBInstancesOfferingIdstring

The offering identifier filter value. Specify this parameter to show only purchased reservations matching the specified offering identifier.

DBInstanceClassstring

The DB instance class filter value. Specify this parameter to show only those reservations matching the specified DB instances class.

Durationstring
<p>The duration filter value, specified in years or seconds. Specify this parameter to show only reservations for this duration.</p> <p>Valid Values: <code>1 | 3 | 31536000 | 94608000</code> </p>
ProductDescriptionstring

The product description filter value. Specify this parameter to show only those reservations matching the specified product description.

OfferingTypestring
<p>The offering type filter value. Specify this parameter to show only the available offerings matching the specified offering type.</p> <p>Valid Values: <code>"Partial Upfront" | "All Upfront" | "No Upfront" </code> </p>
MultiAZboolean

A value that indicates whether to show only those reservations that support Multi-AZ.

LeaseIdstring
<p>The lease identifier filter value. Specify this parameter to show only the reservation that matches the specified lease ID.</p> <note> <p>Amazon Web Services Support might request the lease ID for an issue related to a reserved DB instance.</p> </note>
Namestring required

The name of the filter. Filter names are case-sensitive.

Valuesstring[] required

One or more filter values. Filter values are case-sensitive.

This parameter isn't currently supported.

MaxRecordsinteger
<p>The maximum number of records to include in the response. If more than the <code>MaxRecords</code> value is available, a pagination token called a marker is included in the response so you can retrieve the remaining results.</p> <p>Default: 100</p> <p>Constraints: Minimum 20, maximum 100.</p>
Markerstring

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by <code>MaxRecords</code>.

Action'DescribeReservedDBInstances' required
Version'2014-10-31' required

Response

Success