describeOrderableDBInstanceOptions method

Future<OrderableDBInstanceOptionsMessage> describeOrderableDBInstanceOptions({
  1. required String engine,
  2. String? availabilityZoneGroup,
  3. String? dBInstanceClass,
  4. String? engineVersion,
  5. List<Filter>? filters,
  6. String? licenseModel,
  7. String? marker,
  8. int? maxRecords,
  9. bool? vpc,
})

Returns a list of orderable DB instance options for the specified engine.

Parameter engine : The name of the engine to retrieve DB instance options for.

Parameter availabilityZoneGroup : The Availability Zone group associated with a Local Zone. Specify this parameter to retrieve available offerings for the Local Zones in the group.

Omit this parameter to show the available offerings in the specified AWS Region.

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

Parameter engineVersion : The engine version filter value. Specify this parameter to show only the available offerings matching the specified engine version.

Parameter filters : This parameter isn't currently supported.

Parameter licenseModel : The license model filter value. Specify this parameter to show only the available offerings matching the specified license model.

Parameter marker : An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions 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 records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that you can retrieve the remaining results.

Default: 100

Constraints: Minimum 20, maximum 100.

Parameter vpc : A value that indicates whether to show only VPC or non-VPC offerings.

Implementation

Future<OrderableDBInstanceOptionsMessage> describeOrderableDBInstanceOptions({
  required String engine,
  String? availabilityZoneGroup,
  String? dBInstanceClass,
  String? engineVersion,
  List<Filter>? filters,
  String? licenseModel,
  String? marker,
  int? maxRecords,
  bool? vpc,
}) async {
  ArgumentError.checkNotNull(engine, 'engine');
  final $request = <String, dynamic>{};
  $request['Engine'] = engine;
  availabilityZoneGroup
      ?.also((arg) => $request['AvailabilityZoneGroup'] = arg);
  dBInstanceClass?.also((arg) => $request['DBInstanceClass'] = arg);
  engineVersion?.also((arg) => $request['EngineVersion'] = arg);
  filters?.also((arg) => $request['Filters'] = arg);
  licenseModel?.also((arg) => $request['LicenseModel'] = arg);
  marker?.also((arg) => $request['Marker'] = arg);
  maxRecords?.also((arg) => $request['MaxRecords'] = arg);
  vpc?.also((arg) => $request['Vpc'] = arg);
  final $result = await _protocol.send(
    $request,
    action: 'DescribeOrderableDBInstanceOptions',
    version: '2014-10-31',
    method: 'POST',
    requestUri: '/',
    exceptionFnMap: _exceptionFns,
    shape: shapes['DescribeOrderableDBInstanceOptionsMessage'],
    shapes: shapes,
    resultWrapper: 'DescribeOrderableDBInstanceOptionsResult',
  );
  return OrderableDBInstanceOptionsMessage.fromXml($result);
}