describeClusterParameters method

Future<ClusterParameterGroupDetails> describeClusterParameters({ required String parameterGroupName, String? marker, int? maxRecords, String? source, })

Returns a detailed list of parameters contained within the specified Amazon Redshift parameter group. For each parameter the response includes information such as parameter name, description, data type, value, whether the parameter value is modifiable, and so on.

You can specify source filter to retrieve parameters of only specific type. For example, to retrieve parameters that were modified by a user action such as from ModifyClusterParameterGroup, you can specify source equal to user.

For more information about parameters and parameter groups, go to Amazon Redshift Parameter Groups in the Amazon Redshift Cluster Management Guide.

May throw ClusterParameterGroupNotFoundFault.

Parameter parameterGroupName : The name of a cluster parameter group for which to return details.

Parameter marker : An optional parameter that specifies the starting point to return a set of response records. When the results of a DescribeClusterParameters request exceed the value specified in MaxRecords, AWS 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.

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 a marker field of the response. You can retrieve the next set of records by retrying the command with the returned marker value.

Default: 100

Constraints: minimum 20, maximum 100.

Parameter source : The parameter types to return. Specify user to show parameters that are different form the default. Similarly, specify engine-default to show parameters that are the same as the default parameter group.

Default: All parameter types returned.

Valid Values: user | engine-default

Implementation

Future<ClusterParameterGroupDetails> describeClusterParameters({
  required String parameterGroupName,
  String? marker,
  int? maxRecords,
  String? source,
}) async {
  ArgumentError.checkNotNull(parameterGroupName, 'parameterGroupName');
  _s.validateStringLength(
    'parameterGroupName',
    parameterGroupName,
    0,
    2147483647,
    isRequired: true,
  );
  _s.validateStringLength(
    'marker',
    marker,
    0,
    2147483647,
  );
  _s.validateStringLength(
    'source',
    source,
    0,
    2147483647,
  );
  final $request = <String, dynamic>{};
  $request['ParameterGroupName'] = parameterGroupName;
  marker?.also((arg) => $request['Marker'] = arg);
  maxRecords?.also((arg) => $request['MaxRecords'] = arg);
  source?.also((arg) => $request['Source'] = arg);
  final $result = await _protocol.send(
    $request,
    action: 'DescribeClusterParameters',
    version: '2012-12-01',
    method: 'POST',
    requestUri: '/',
    exceptionFnMap: _exceptionFns,
    shape: shapes['DescribeClusterParametersMessage'],
    shapes: shapes,
    resultWrapper: 'DescribeClusterParametersResult',
  );
  return ClusterParameterGroupDetails.fromXml($result);
}