describeClusterDbRevisions method
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);
}