describeReservedDBInstancesOfferings method

Future<ReservedDBInstancesOfferingMessage> describeReservedDBInstancesOfferings({ String? dBInstanceClass, String? duration, List<Filter>? filters, String? marker, int? maxRecords, bool? multiAZ, String? offeringType, String? productDescription, String? reservedDBInstancesOfferingId, })

Lists available reserved DB instance offerings.

May throw ReservedDBInstancesOfferingNotFoundFault.

Parameter dBInstanceClass : The DB instance class filter value. Specify this parameter to show only the available offerings matching the specified DB instance class.

Parameter 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

Parameter filters : This parameter isn't currently supported.

Parameter marker : 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 MaxRecords.

Parameter maxRecords : The maximum number of records to include in the response. If more than the MaxRecords value is available, a pagination token called a marker is included in the response so you can retrieve the remaining results.

Default: 100

Constraints: Minimum 20, maximum 100.

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

Parameter offeringType : The offering type filter value. Specify this parameter to show only the available offerings matching the specified offering type.

Valid Values: "Partial Upfront" | "All Upfront" | "No Upfront"

Parameter productDescription : Product description filter value. Specify this parameter to show only the available offerings that contain the specified product description.

Parameter 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

Implementation

Future<ReservedDBInstancesOfferingMessage>
    describeReservedDBInstancesOfferings({
  String? dBInstanceClass,
  String? duration,
  List<Filter>? filters,
  String? marker,
  int? maxRecords,
  bool? multiAZ,
  String? offeringType,
  String? productDescription,
  String? reservedDBInstancesOfferingId,
}) async {
  final $request = <String, dynamic>{};
  dBInstanceClass?.also((arg) => $request['DBInstanceClass'] = arg);
  duration?.also((arg) => $request['Duration'] = arg);
  filters?.also((arg) => $request['Filters'] = arg);
  marker?.also((arg) => $request['Marker'] = arg);
  maxRecords?.also((arg) => $request['MaxRecords'] = arg);
  multiAZ?.also((arg) => $request['MultiAZ'] = arg);
  offeringType?.also((arg) => $request['OfferingType'] = arg);
  productDescription?.also((arg) => $request['ProductDescription'] = arg);
  reservedDBInstancesOfferingId
      ?.also((arg) => $request['ReservedDBInstancesOfferingId'] = arg);
  final $result = await _protocol.send(
    $request,
    action: 'DescribeReservedDBInstancesOfferings',
    version: '2014-10-31',
    method: 'POST',
    requestUri: '/',
    exceptionFnMap: _exceptionFns,
    shape: shapes['DescribeReservedDBInstancesOfferingsMessage'],
    shapes: shapes,
    resultWrapper: 'DescribeReservedDBInstancesOfferingsResult',
  );
  return ReservedDBInstancesOfferingMessage.fromXml($result);
}