v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14238527879.4 KB

Returns properties of possible node configurations such as node type, number of nodes, and disk usage for the specified action type.

get/#Action=DescribeNodeConfigurationOptions

Query parameters

ActionType'restore-cluster' | 'recommend-node-config' | 'resize-cluster' required

The action type to evaluate for possible node configurations. Specify "restore-cluster" to get configuration combinations based on an existing snapshot. Specify "recommend-node-config" to get configuration recommendations based on an existing cluster or snapshot. Specify "resize-cluster" to get configuration combinations for elastic resize based on an existing cluster.

ClusterIdentifierstring

The identifier of the cluster to evaluate for possible node configurations.

SnapshotIdentifierstring

The identifier of the snapshot to evaluate for possible node configurations.

SnapshotArnstring

The Amazon Resource Name (ARN) of the snapshot associated with the message to describe node configuration.

OwnerAccountstring

The Amazon Web Services account used to create or copy the snapshot. Required if you are restoring a snapshot you do not own, optional if you own the snapshot.

Name'NodeType' | 'NumberOfNodes' | 'EstimatedDiskUtilizationPercent' | 'Mode'

The name of the element to filter.

Operator'eq' | 'lt' | 'gt' | 'le' | 'ge' | 'in' | 'between'

The filter operator. If filter Name is NodeType only the 'in' operator is supported. Provide one value to evaluate for 'eq', 'lt', 'le', 'gt', and 'ge'. Provide two values to evaluate for 'between'. Provide a list of values for 'in'.

Valuesstring[]

List of values. Compare Name using Operator to Values. If filter Name is NumberOfNodes, then values can range from 0 to 200. If filter Name is EstimatedDiskUtilizationPercent, then values can range from 0 to 100. For example, filter NumberOfNodes (name) GT (operator) 3 (values).

A set of name, operator, and value items to filter the results.

Markerstring

An optional parameter that specifies the starting point to return a set of response records. When the results of a <a>DescribeNodeConfigurationOptions</a> request exceed the value specified in <code>MaxRecords</code>, Amazon Web Services returns a value in the <code>Marker</code> field of the response. You can retrieve the next set of response records by providing the returned marker value in the <code>Marker</code> parameter and retrying the request.

MaxRecordsinteger
<p>The maximum number of response records to return in each call. If the number of remaining response records exceeds the specified <code>MaxRecords</code> value, a value is returned in a <code>marker</code> field of the response. You can retrieve the next set of records by retrying the command with the returned marker value. </p> <p>Default: <code>500</code> </p> <p>Constraints: minimum 100, maximum 500.</p>
Action'DescribeNodeConfigurationOptions' required
Version'2012-12-01' required

Response

Success