describeClusterDbRevisions method

Future<ClusterDbRevisionsMessage> describeClusterDbRevisions({
  1. String? clusterIdentifier,
  2. String? marker,
  3. int? maxRecords,
})

Returns an array of ClusterDbRevision objects.

May throw ClusterNotFoundFault. May throw InvalidClusterStateFault.

Parameter clusterIdentifier : A unique identifier for a cluster whose ClusterDbRevisions you are requesting. This parameter is case sensitive. All clusters defined for an account are returned by default.

Parameter marker : An optional parameter that specifies the starting point for returning a set of response records. When the results of a DescribeClusterDbRevisions request exceed the value specified in MaxRecords, Amazon Redshift returns a value in the marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the marker parameter and retrying the request.

Constraints: You can specify either the ClusterIdentifier parameter, or the marker parameter, but not both.

Parameter maxRecords : The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified MaxRecords value, a value is returned in the marker field of the response. You can retrieve the next set of response records by providing the returned marker value in the marker parameter and retrying the request.

Default: 100

Constraints: minimum 20, maximum 100.

Implementation

Future<ClusterDbRevisionsMessage> describeClusterDbRevisions({
  String? clusterIdentifier,
  String? marker,
  int? maxRecords,
}) async {
  _s.validateStringLength(
    'clusterIdentifier',
    clusterIdentifier,
    0,
    2147483647,
  );
  _s.validateStringLength(
    'marker',
    marker,
    0,
    2147483647,
  );
  final $request = <String, dynamic>{};
  clusterIdentifier?.also((arg) => $request['ClusterIdentifier'] = arg);
  marker?.also((arg) => $request['Marker'] = arg);
  maxRecords?.also((arg) => $request['MaxRecords'] = arg);
  final $result = await _protocol.send(
    $request,
    action: 'DescribeClusterDbRevisions',
    version: '2012-12-01',
    method: 'POST',
    requestUri: '/',
    exceptionFnMap: _exceptionFns,
    shape: shapes['DescribeClusterDbRevisionsMessage'],
    shapes: shapes,
    resultWrapper: 'DescribeClusterDbRevisionsResult',
  );
  return ClusterDbRevisionsMessage.fromXml($result);
}